つつじバスロケーション WEB-API 説明書

2012/11/12

目次
１．WEB-API 一覧................................................................................................................ 3
２．リクエストとレスポンス................................................................................................. 4
２．１．路線毎のバス停の座標データ .............................................................................. 4２．２．路線毎の時刻表データ ......................................................................................... 5２．３．路線番号データ .................................................................................................... 6
２．４．路線と便を指定したバスの位置データ................................................................ 7
２．５．号車を指定したバスの位置データ ....................................................................... 8
２．６．お知らせデータ .................................................................................................... 9２．７．高年大学の開講日データ.................................................................................... 10２．８．冬季日データ...................................................................................................... 10２．９．運行履歴データ ...................................................................................................11２．１０．バスアイコンデータ ....................................................................................... 12２．１１．バス停アイコンデータ.................................................................................... 122

１．WEB-API 一覧
概要

リクエスト名1

路線毎のバス停の座標データ

busstopLookup.php

2

路線毎の時刻表データ

timetableLookup.php

3

路線番号データrosenidLookup.php

4

路線と便を指定したバスの位置データ

rosenLookup.php

5号車を指定したバスの位置データbusLookup.php

6

お知らせデータ

messageLookup.php

7

高年大学の開講日データ

konendaigakuLookup.php

8

冬季日データwinterLookup.php

9

運行履歴データrosenrecordLookup.php

10

バスアイコンデータ

busiconLookup.php

11

バス停アイコンデータ

busstopiconLookup.php※リクエスト URL は、
http://tutujibus.com/ に上記のリクエスト名を付加してください。

3２．リクエストとレスポンス
２．１．路線毎のバス停の座標データ◆リクエストパラメータ
パラメータ

内容

データ型

1

rosenid

small

路線番号

2

callback

string

JSONP のコールバック関数名◆レスポンスフィールド
内容

フィールド
busstop（配列）
1

id

バス停番号

2

name

バス停名

3

latitude

バス停緯度

4

longitude

バス停経度◆ レスポンス形式のサンプル
jsonp_callback({"busstop":[{"id":"1","name":"JR 鯖江駅（１番のりば）","latitude":35.943302,"longitude":136.188187},{"id":"2","name":"本町 1 丁目（東）","latitude":35.944408,"longitude":136.185257},・・・]})

4

２．２．路線毎の時刻表データ◆リクエストパラメータ
パラメータ

内容

データ型

1

rosenid

small

路線番号

2

callback

string

JSONP のコールバック関数名◆レスポンスフィールド
内容

フィールド
timetable（配列）
1

binid

便番号

2

konendaigakucd

1:開講日運行 2:休講日運行

3

weekdaycd

1:平日のみ運行 2:休日のみ運行 3:常に運行

4wintercd

1:冬季日のみ運行 2:冬季日以外運行 3:常に運行

5

destination

行き先

3:常に運行

list（配列）
6

time

発車予定時刻7busstopid

バス停番号◆レスポンス形式のサンプルjsonp_callback({"timetable":[{"binid":"1","konendaigakucd":"3","weekdaycd":"3","wintercd":"3","list":[{"time":"08:05:00","busstopid":"1"},{"time":"08:08:00","busstopid":"35"},{"time":"08:09:00","busstopid":"36"},・・・]}]})

5

２．３．路線番号データ◆リクエストパラメータ
パラメータ1

callback

内容

データ型
string

JSONP のコールバック関数名◆レスポンスフィールド
内容フィールド
rosen（配列）
1

id

路線番号

2

name

路線名

◆ レスポンス形式のサンプル
jsonp_callback({"rosen":[{"id":"1","name":"中央線"},{"id":"2","name":"鯖江南線"},{"id":"3","name":"新横江線"},{"id":"4","name":"神明線"},{"id":"5","name":"片上・北中山線"},{"id":"6","name":"立待線"},{"id":"7","name":"吉川線"},{"id":"8","name":"豊線"},{"id":"9","name":"中河・北中山線"},{"id":"10","name":"河和田線"},{"id":"11","name":"丹南高校線"},{"id":"12","name":"歴史の道線"},{"id":"99","name":"福鉄鯖浦線"}]})

6

２．４．路線と便を指定したバスの位置データ◆リクエストパラメータ
パラメータ

内容

データ型

1

rosenid

small

路線番号

2

binid

small

便番号

3

callback

string

JSONP のコールバック関数名◆レスポンスフィールド
内容

フィールド
1

isRunningboolean true：運行中 false：運行以外

2

datetime

バスからの送信日時 YYYYMMDDhhmmss

3busid

バス番号

4rosenid

路線番号

5binid

便番号6

latitude緯度

7

longitude

経度

8speed速度（m/秒）9

direction

方位（度） 例 0：北 90：東 180：南 270：西10

destination

行き先

11

isdelayboolean true:遅れ

false：正常◆ レスポンス形式のサンプル
jsonp_callback({"isRunning":true,"datetime":"20121111105917","busid":"4","rosenid":"1","binid":"6","latitude":35.9433891478563,"longitude":136.188318052251,"speed":0,"direction":92.2735595703125,"destination":”神明駅","isdelay":false})7２．５．号車を指定したバスの位置データ◆リクエストパラメータ
パラメータ

内容

データ型

1busid

small

バス番号

2callbackstring

JSONP のコールバック関数名◆レスポンスフィールド
内容フィールド
1

isRunningboolean true：運行中 false：運行以外

2

datetime

バスからの送信日時 YYYYMMDDhhmmss

3busid

バス番号4

rosenid

路線番号

5

binid

便番号

6

latitude緯度

7

longitude

経度

8speed速度（m/秒）9

direction

方位（度） 例 0：北 90：東 180：南 270：西10

destination

行き先

11

isdelayboolean true:遅れ

false：正常◆レスポンス形式のサンプル
jsonp_callback({"isRunning":true,"datetime":"20121111110057","busid":"4","rosenid":"1","binid":"6","latitude":35.9463122814615,"longitude":136.188002291092,"speed":8.00399
208068848,"direction":260.027038574219,"destination":”神明駅","isdelay":false})8２．６．お知らせデータ◆リクエストパラメータ
パラメータ
1callback内容

データ型
string

JSONP のコールバック関数名◆レスポンスフィールド
内容

フィールド
1

messageお知らせ内容◆レスポンス形式のサンプル
jsonp_callback({"message":"【お知らせ】 バスは全便正常に運行しています。"})

9

２．７．高年大学の開講日データ◆リクエストパラメータ
パラメータ
1callback内容

データ型
string

JSONP のコールバック関数名◆レスポンスフィールド
内容フィールド
konendaigaku（配列）1

開講日 YYYYMMDD

date◆レスポンス形式のサンプルjsop_callback({"konendaigaku":[{"date":"20120904"},{"date":"20120906"},{"date":"20120907"},{"date":"20120909"},{"date":"20120911"},・・・]})

２．８．冬季日データ◆リクエストパラメータ
パラメータ
1callback内容

データ型
string

JSONP のコールバック関数名◆レスポンスフィールド
内容

フィールド
winter（配列）1date

冬季日 YYYYMMDD◆レスポンス形式のサンプル
jsonp_callback({"winter":[{"date":"20121101"},{"date":"20121122"}]})

10

２．９．運行履歴データ◆リクエストパラメータ
パラメータ

内容

データ型

1

callback

string

JSONP のコールバック関数名2rosenidsmall

路線番号（任意）

3

busid

small

バス番号（任意）4

datetime

string5

countint

YYYYMMDDhhmmss
または YYYYMMDD
0～1000 件（任意）◆レスポンスフィールド
内容フィールド
rosenrecord（配列）1

isRunningboolean true：運行中 false：運行以外

2

datetime

バスからの送信日時 YYYYMMDDhhmmss

3busid

バス番号4

rosenid

路線番号

5binid

便番号6

latitude緯度

7

longitude

経度

8

speed

速度（m/秒）9

direction

方位（度） 例 0：北 90：東 180：南 270：西10

isdelayboolean true:遅れ

false：正常◆レスポンス形式のサンプル
jsonp_callback({"rosenrecord":[{"isRunning":true,"datetime":"20121111104257","busid":"4","rosenid":"1","binid":"6","latitude":35.9729777337325,"longitude":136.181559645419,"speed":0,"direction":112.633598327637,"isdelay":false,"iskaiso":false,"isijo":false},・・・]})

11

２．１０．バスアイコンデータ◆リクエストパラメータ
パラメータ

内容

データ型

1

callback

string

JSONP のコールバック関数名2busidsmall

バス番号◆レスポンスフィールド
内容

フィールド
busicon（配列）1direction

2

iconURL

方位 1：北 2：北東 3：東 4：南東
5：南 6：南西

7：西 8：北西

バスアイコンの URL◆レスポンス形式のサンプル
jsonp_callback({"busicon":[{"direction":"1","iconURL":"http://tutujibus.com/image/bus/1/
1_1.png"},{"direction":"2","iconURL":"http://tutujibus.com/image/bus/1/1_2.png"},{"direction":"3","iconURL":"http://tutujibus.com/image/bus/1/1_3.png"},{"direction":"4","iconURL":"http://tutujibus.com/image/bus/1/1_4.png"},{"direction":"5","iconURL":"http://tutujibus.com/image/bus/1/1_5.png"},{"direction":"6","iconURL":"http://tutujibus.com/image/bus/1/1_6.png"},{"direction":"7","iconURL":"http://tutujibus.com/image/bus/1/1_7.png"},{"direction":"8","iconURL":"http://tutujibus.com/image/bus/1/1_8.png"}]})
２．１１．バス停アイコンデータ◆リクエストパラメータ
パラメータ1

callback

内容

データ型
string

JSONP のコールバック関数名◆レスポンスフィールド
内容フィールド
1busstopicon

バス停アイコンの URL◆レスポンス形式のサンプル
jsonp_callback({"busstopicon":"http://tutujibus.com/image/busstop32.png"})以上

12