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の命名規則
都交：{系統名} {始発バス停}→{終着バス停} {前バス停}
例：”梅０１青梅駅前→青梅駅前和田町会館前”
西武：{車両番号}:{系統名(日本語+識別子)}:{前バス停}:{次バス停}
例：”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の命名規則

社局	規則	例
都交	{系統名} {終着バス停}行	都０２大塚駅前行
西武	{系統名}	石０２
神奈中	{系統名} {終着バス停}行	港55 庄戸行
相鉄	{系統名} {バス経路情報}	旭29 三ツ境駅～境橋～三ツ境駅
東武	{バス経路情報}	見沼代駅→市立病院
国際興業	{系統名}	西川05
関東	{系統名}	阿０１
西東京	{系統名}	日21
東急	{系統名}	市４３
京王	{系統名}	高２３-も
小田急	{系統名}	吉０６

※odpt:noteの命名規則

社局	規則	例
都交	{系統名}:{始発バス停}→{終着バス停}:{dc:title}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{固有ID}	都０２:錦糸町駅前→大塚駅前:都０２大塚駅前行:32301:2:45-170
西武	{系統名}:{バス経路情報}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{運行曜日}:{始発バス停発車時刻}:{終着バス停到着時刻}	石０２:石神井公園駅（下屋敷）成増駅南口: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
関東	{系統名}:{始発バス停}:{運行曜日}:{始発バス停発車時刻}	阿０１:阿佐ヶ谷駅:平日:07:31
東急	{系統名}:{始発バス停}:{運行曜日}:{始発バス停発車時刻}	市４３:中山駅北口:土曜:16:15
小田急	{系統名}:{バス経路情報}:{busroutePatternのodpt:pattern}:{busroutePatternのodpt:direction}:{固有ID}:{運行曜日}:{始発バス停発車時刻}:{終着バス停到着時刻}	吉０６:調布駅北口～（野崎）～吉祥寺駅:10201:1:1100.平日０１: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}	高７１:高田馬場駅前→九段下:16601:1
西武	{系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction}	吉６４:花小金井駅～吉祥寺駅: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:ｔｏｃｏ南西循環:46204000:1
関東	始発～終着	井荻駅～西荻窪駅ＮＳ
東急	{始発バス停}発 {終着バス停}ゆき	中山駅北口発寺家町【循環】ゆき
小田急	{系統名}:{バス経路情報}:{odpt:pattern}:{odpt:direction}	境９１:狛江駅北口～（調布駅北口）～武蔵境駅南口:40503:1

※odpt:note (odpt:busstopPoleOrder) の命名規則

社局	規則	例
都交	{バス停}	高田馬場駅前
西武	{バス停}:{バス停ID}:{バス停}:{odpt:BusstopPoleのodpt:busstopPoleNumber}	花小金井駅:60017:花小金井駅２
神奈中	{バス停}	戸塚駅東口
相鉄	{バス停}	国分寺台第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。

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は自分が使う予定が無いので省略した。使うことになったら書くと思う。

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