ODPT Bus APIの社局毎の差異

はじめに

全てのデータが同一基準によって分類・整理されていることが理想であるが、実際には難しい(し、程遠いというのが現状である)。この項では、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は自分が使う予定が無いので省略した。使うことになったら書くと思う。

他の会社もバスロケ出してほしいです。

コメント

タイトルとURLをコピーしました