はじめに
全てのデータが同一基準によって分類・整理されていることが理想であるが、実際には難しい(し、程遠いというのが現状である)。この項では、API毎に社局によって違うデータについて述べ、整理する。
基本的に項目毎について整理することとするが、@context・@id・@typeについては述べない。また、Nameが太字となっているものはrequired(必須)となっているものを示し、Nameが斜字となっているものはAPI仕様によって定められていないが出力されるデータには含まれているものを示す。
odpt:Bus
バスのロケーションを取得するAPI。
提供社局:東京都交通局・西武バス
Name | Description | 都交 | 西武 | 備考 |
---|---|---|---|---|
owl:sameAs | 固有識別子 | ○ | ○ | ※ |
odpt:busNumber | 車両番号 | ○ | ○ | |
dc:date | データ生成時刻 | ○ | ○ | |
dct:valid | データ保証期限 | ○ | ○ | |
odpt:frequency | 更新頻度(sec) | 30 | 30 | |
odpt:busroutePattern | 系統 | ○ | ○ | |
odpt:operator | 運行社局 | ○ | ○ | |
odpt:startingBusstopPole | 始発バス停 | ○ | ○ | |
odpt:terminalBusstopPole | 終着バス停 | ○ | ○ | |
odpt:fromBusstopPole | 前バス停 | ○ | ○ | |
odpt:fromBusstopPoleTime | 前バス停発車時刻 | ○ | ○ | |
odpt:toBusstopPole | 次バス停 | ○ | ○ | |
odpt:progress | 進行位置割合(0~1) | × | × | |
geo:long | 経度 | × | ○ | |
geo:lat | 緯度 | × | ○ | |
odpt:speed | 速度 | × | × | |
odpt:azimuth | 進行方向方位角 | × | ○ | |
odpt:doorStatus | ドア開閉状態 | × | × | |
odpt:note | 注記 | ○ | ○ | ※ |
※owl:sameAsの命名規則(都交・西武同じ)
odpt:busroutePattern : odpt.BusroutePattern:Toei.Ue58.20101.1
odpt:busNumber : M215
ならば、
owl:sameAs : odpt.Bus:Toei.Ue58.20101.1.M215
となる。
※odpt:noteの命名規則
都交:{系統名} {始発バス停}→{終着バス停} {前バス停}
例:”梅01 青梅駅前→青梅駅前 和田町会館前”
西武:{車両番号}:{系統名(日本語+識別子)}:{前バス停}:{次バス停}
例:”539:新宿駅西口〜西武百貨店:5007:2:成子坂下:中野坂上”
odpt:BusTimetable
バスの1便毎の時刻表を得るAPI。
提供社局:東京都交通局・西武バス・神奈中・相鉄バス・東武バス・国際興業・関東バス・西東京バス・東急バス・京王バス・小田急バス
Name | Desctiption | 都交 | 西武 | 神奈中 | 相鉄 | 東武 | 国際興業 | 関東 | 西東京 | 東急 | 京王 | 小田急 |
---|---|---|---|---|---|---|---|---|---|---|---|---|
owl:sameAs | 固有識別子 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
dc:date | データ生成時刻 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
dct:issued | ダイヤ改正日 | × | × | × | × | × | × | × | × | × | × | × |
dct:valid | データ保証期限 | × | × | × | × | × | × | × | × | × | × | × |
dc:title | 路線名称 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:kana | 路線名称読み仮名 | × | × | × | × | × | × | × | × | × | × | × |
odpt:operator | 運行社局 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:busroutePattern | 系統 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:calendar | カレンダー | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:busTimetableObject | 時刻表オブジェクト | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:note | 注記 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | ○ | × | ○ |
続いて、odpt:busTimetableObjectについて示す。
Name | Desctiption | 都交 | 西武 | 神奈中 | 相鉄 | 東武 | 国際興業 | 関東 | 西東京 | 東急 | 京王 | 小田急 |
---|---|---|---|---|---|---|---|---|---|---|---|---|
odpt:index | バス停通過順 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:busstopPole | バス停 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:arrivalTime | 着時刻 | ○ | ○ | ○ | ○ | ○ | ○ | 終着のみ | 終着のみ | ○ | 終着のみ | ○ |
odpt:departureTime | 発時刻 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | 始発のみ | ○ | ○ |
odpt:destinationSign | 行先表示 | ○ | ○ | ○ | ○ | null | null | × | × | × | × | null |
odpt:isNonStepBus | ノンステップか | ○ | null | × | × | ○ | ○ | × | × | × | × | null |
odpt:isMidnight | 深夜バスか | ○ | ○ | ○ | ○ | ○ | ○ | × | × | × | × | ○ |
odpt:canGetOn | 乗車可能か | × | ○ | ○ | × | ○ | ○ | ○ | × | × | × | ○ |
odpt:canGetOff | 降車可能か | × | ○ | ○ | × | ○ | ○ | ○ | × | × | × | ○ |
odpt:note | 注記 | ○ | ○ | ○ | ○ | ○ | ○ | × | × | × | × | ○ |
※dc:titleの命名規則
社局 | 規則 | 例 |
---|---|---|
都交 | {系統名} {終着バス停}行 | 都02 大塚駅前行 |
西武 | {系統名} | 石02 |
神奈中 | {系統名} {終着バス停}行 | 港55 庄戸行 |
相鉄 | {系統名} {バス経路情報} | 旭29 三ツ境駅~境橋~三ツ境駅 |
東武 | {バス経路情報} | 見沼代駅→市立病院 |
国際興業 | {系統名} | 西川05 |
関東 | {系統名} | 阿01 |
西東京 | {系統名} | 日21 |
東急 | {系統名} | 市43 |
京王 | {系統名} | 高23-も |
小田急 | {系統名} | 吉06 |
※odpt:noteの命名規則
社局 | 規則 | 例 |
---|---|---|
都交 | {系統名}:{始発バス停}→{終着バス停}:{dc:title}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{固有ID} | 都02:錦糸町駅前→大塚駅前:都02 大塚駅前行:32301:2:45-170 |
西武 | {系統名}:{バス経路情報}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{運行曜日}:{始発バス停発車時刻}:{終着バス停到着時刻} | 石02:石神井公園駅(下屋敷)成増駅南口:56001:1:休日:12:33:13:02 |
神奈中 | {系統名}:{終着バス停}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction} | 港55:庄戸行::11055:1:3 |
相鉄 | {系統名}:{バス経路情報}::{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{運行曜日} | 旭29:三ツ境駅~境橋~三ツ境駅::109003:1:平日 |
東武 | :{バス経路情報}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{運行曜日}:{始発バス停発車時刻}:{終着バス停到着時刻} | :見沼代駅→市立病院:1604008020:2:平日:19:00:19:55 |
国際興業 | {系統名}:{バス経路情報}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{運行曜日}:{始発バス停発車時刻}:{終着バス停到着時刻} | 西川05:西川口駅-朝日五丁目循環:52205000:1:平日:18:00:18:42 |
関東 | {系統名}:{始発バス停}:{運行曜日}:{始発バス停発車時刻} | 阿01:阿佐ヶ谷駅:平日:07:31 |
東急 | {系統名}:{始発バス停}:{運行曜日}:{始発バス停発車時刻} | 市43:中山駅北口:土曜:16:15 |
小田急 | {系統名}:{バス経路情報}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{固有ID}:{運行曜日}:{始発バス停発車時刻}:{終着バス停到着時刻} | 吉06:調布駅北口~(野崎)~吉祥寺駅:10201:1:1100.平日01:07:54:08:41 |
※odpt:note (odpt:busTimetableObject) の命名規則
社局 | 規則 | 例 |
---|---|---|
都交 | {バス停}:{バス停ID}:{標柱番号} | 錦糸町駅前:442:11 |
西武 | {バス停}:{バス停ID}:{標柱番号} | 石神井公園駅北口:30049:1 |
神奈中 | {バス停}:{バス停ID}:{標柱番号} | 港南台駅:11220:2 |
相鉄 | {バス停}:{バス停ID}:{標柱番号} | 三ツ境駅:1147:5 |
東武 | {バス停}:{バス停ID}: | 見沼代親水公園駅コミ:16888: |
国際興業 | {バス停}:{バス停ID}:{標柱番号} | 西川口駅東口:1228:2 |
小田急 | {バス停}:{バス停ID}:{標柱番号} | 調布駅北口:10225:12 |
(注)”バス停ID”は当方で付与した名称である。バス停毎に一意の数字が与えられる。社局別ID一覧:東京都交通局・西武バス・神奈川中央交通・相鉄バス・東武バス・国際興業・関東バス・西東京バス・東急バス・京王バス・小田急バス・JRバス関東
odpt:BusroutePattern
バスの系統情報(路線情報)を得るAPI。
提供社局:東京都交通局・西武バス・神奈中・相鉄バス・東武バス・国際興業・関東バス・西東京バス・東急バス・京王バス・小田急バス・JRバス関東
Name | Desctiption | 都交 | 西武 | 神奈中 | 相鉄 | 東武 | 国際興業 | 関東 | 西東京 | 東急 | 京王 | 小田急 | JRバス関東 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
owl:sameAs | 固有識別子 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
dc:date | データ生成時刻 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
dct:valid | データ保証期限 | × | × | × | × | × | × | × | × | × | × | × | × |
dc:title | 路線名称 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:kana | 路線名称読み仮名 | × | null | × | × | null | × | × | × | × | × | × | × |
odpt:operator | 運行社局 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:busroute | 系統ID | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:pattern | 系統パターン | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:direction | 方向 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | ○ |
ug:region | 地物情報 | ○ | null | null | null | null | null | null | null | null | null | null | null |
odpt:busstopPoleOrder | 標柱順序 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:busLocationURL | 位置情報URL | × | × | × | × | × | × | × | × | × | × | × | × |
odpt:note | 注記 | ○ | ○ | ○ | ○ | ○ | ○ | × | × | ○ | × | ○ | × |
続いて、odpt:busstopPoleOrderについて示す。
Name | Desctiption | 都交 | 西武 | 神奈中 | 相鉄 | 東武 | 国際興業 | 関東 | 西東京 | 東急 | 京王 | 小田急 | JRバス関東 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
odpt:busstopPole | バス停 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:index | バス停通過順 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:openingDoorsToGetOn | 乗車可能ドア | × | × | × | × | × | × | × | × | × | × | × | × |
odpt:openingDoorsToGetOff | 降車可能ドア | × | × | × | × | × | × | × | × | × | × | × | × |
odpt:note | 注記 | ○ | ○ | ○ | ○ | ○ | ○ | × | × | × | × | ○ | × |
※ここでのdc:titleの規則はodpt:BusTimetableのdc:titleの規則と同じである。
※odpt:noteの命名規則
社局 | 規則 | 例 |
---|---|---|
都交 | {系統名}:{始発バス停}→{終着バス停}:{odpt:pattern}:{odpt:direction} | 高71:高田馬場駅前→九段下:16601:1 |
西武 | {系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction} | 吉64:花小金井駅~吉祥寺駅:202005:1 |
神奈中 | {系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction} | 横44:井土ヶ谷経由 横浜駅東口行:12063:1 |
相鉄 | {系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction} | 綾11:国分寺第12~海老名駅:304001:2 |
東武 | :{バス経路情報}:{odpt:pattern}:{odpt:direction} | 吉川北ー三輪之江ー三郷北:1902025020:2 |
国際興業 | {系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction} | 戸田04:toco南西循環:46204000:1 |
関東 | 始発~終着 | 井荻駅~西荻窪駅NS |
東急 | {始発バス停}発 {終着バス停}ゆき | 中山駅北口発 寺家町【循環】ゆき |
小田急 | {系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction} | 境91:狛江駅北口~(調布駅北口)~武蔵境駅南口:40503:1 |
※odpt:note (odpt:busstopPoleOrder) の命名規則
社局 | 規則 | 例 |
---|---|---|
都交 | {バス停} | 高田馬場駅前 |
西武 | {バス停}:{バス停ID}:{バス停}:{odpt:BusstopPoleのodpt:busstopPoleNumber} | 花小金井駅:60017:花小金井駅2 |
神奈中 | {バス停} | 戸塚駅東口 |
相鉄 | {バス停} | 国分寺台第12 |
東武 | {バス停}:{バス停ID}:{バス停} | 吉川駅北口:19254:吉川駅北口 |
国際興業 | {バス停}:{バス停ID}:{バス停} | 下笹目:749:下笹目 |
小田急 | {バス停}:{バス停ID}: | 狛江駅北口:41801: |
※dc:titleは一意の値であるとは限らない。例えば、西東京バスではdc:titleが”直通”となっている系統が多数ある。系統を区別するときは、odpt:patternとodpt:directionを使う必要がある。
※ug:regionについて
ug:region自体はオブジェクト形式で、”type”及び”coordinates”をもつ。”type”は(ここでは)”LineString”であり、”coordinates”は配列形式で緯度と経度の組(この組自体も配列)がバス停の数だけ含まれる。
東急バスのみdirectionを出していないことに注意。
odpt:BusstopPole
バス停の情報を得るAPI。
提供社局:東京都交通局・西武バス・神奈中・相鉄バス・東武バス・国際興業・関東バス・西東京バス・東急バス・京王バス・小田急バス・JRバス関東
Name | Desctiption | 都交 | 西武 | 神奈中 | 相鉄 | 東武 | 国際興業 | 関東 | 西東京 | 東急 | 京王 | 小田急 | JRバス関東 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
owl:sameAs | 固有識別子 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
dc:date | データ生成時刻 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
dct:valid | データ保証期限 | × | × | × | × | × | × | × | × | × | × | × | × |
dc:title | バス停名称 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:kana | 読み仮名 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | △※ |
title | バス停名(多言語) | ○ | × | ○ | ○ | ○ | ○ | ○ | × | × | × | × | × |
geo:long | 緯度 | ○ | null | null | ○ | null | null | null | ○ | ○ | null | null | null |
geo:lat | 経度 | ○ | null | null | ○ | null | null | null | ○ | ○ | null | null | null |
ug:region | 地物情報 | null | null | null | null | null | null | null | null | null | null | null | null |
odpt:busroutePattern | 入線する系統 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:operator | 運行社局 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
odpt:busstopPoleNumber | 標柱番号 | ○ | ○ | ○ | ○ | “” | ○ | ○ | ○ | ○ | ○ | ○ | × |
odpt:busstopPoleTimetable | バス停時刻表 | ○ | ○ | × | [] | null | null | [] | [] | null | [] | null | ○ |
odpt:note | 注記 | のりば | ※ | × | × | ※ | ※ | × | × | × | × | ※ | × |
※titleについて
社局 | キー | 値 |
---|---|---|
都交 | en/ja/ja-Hrkt | 英語/日本語/ひらがな |
神奈中 | ja/ja-Hrkt | 日本語/カタカナ |
相鉄 | ja/ja-Hrkt | 日本語/カタカナ |
東武 | ja/ja-Hrkt | 日本語/カタカナ |
国際興業 | ja/ja-Hrkt | 日本語/カタカナ |
関東 | en/ja/ko/ja-Hrkt/zh-Hans | 英語/日本語/韓国語/カタカナ/簡体字 |
小田急 | en/ja/ko/ja-Hrkt/zh-Hans | 英語/日本語/韓国語/カタカナ/簡体字 |
※西武バス・東武バス・小田急バスのodpt:noteは”{dc:title}:{バス停ID}”の形式である(例:”中落合:20013″)。
※JRバス関東のodpt:kanaは存在するバス停と存在しないバス停の両方が存在した。
※odpt:busstopPoleNumberには必ずしも数字が入るとは限らない。西東京バス等はアルファベットを入れている場合もある。
おわりに
差異を吸収するようなものを作ろうとすると大変。
odpt:BusroutePatternFareは自分が使う予定が無いので省略した。使うことになったら書くと思う。
他の会社もバスロケ出してほしいです。
コメント