駅時刻表から停車駅を取得する

鉄道駅時刻表に紐づく停車駅情報を取得します。

※API利用時のイメージ図 (駅すぱあと for iPhone)

無題図形描画 (3).png (78.7 kB)

関連URL

手順

1. 駅を指定して路線を取得する

鉄道駅時刻表 /station/timetable を用いて、stationNameパラメータまたはstationCodeパラメータで駅を指定します。

※リクエスト例では日本語で記述しておりますが、リクエストパラメータに日本語が含まれる場合には、日本語の部分をUTF8でURLエンコード(パーセントエンコード)してください。

GET /v1/xml/station/timetable?key=アクセスキーを入力してください&stationName=高円寺
<ResultSet apiVersion="1.26.0.0" engineVersion="201512_04a">
<TimeTable code="1">
<Station>
<Name>高円寺</Name>
</Station>
<Line>
<Name>総武線</Name>
<Direction>三鷹・高尾</Direction>
</Line>
:

2. 指定した駅、路線の時刻表を取得する

1のレスポンスで路線を取得できるので、選択した路線の ResultSet/Timetable/code を用いて時刻表を取得します。

※リクエスト例では日本語で記述しておりますが、リクエストパラメータに日本語が含まれる場合には、日本語の部分をUTF8でURLエンコード(パーセントエンコード)してください。

GET /v1/xml/station/timetable?key=アクセスキーを入力してください&stationName=高円寺&code=1
<ResultSet apiVersion="1.26.0.0" engineVersion="201512_04a">
<TimeTable code="1">
<Station>
<Name>高円寺</Name>
</Station>
<HourTable>
<MinuteTable>
<Minute>10</Minute>
<Stop kindCode="1" lineCode="列車等を特定するコード" extra="True" nameCode="1" destinationCode="6"/>
</MinuteTable>
<MinuteTable>
<Minute>40</Minute>
<Stop kindCode="1" lineCode="列車等を特定するコード" extra="True" nameCode="1" destinationCode="6"/>
</MinuteTable>
<Hour>1</Hour>
</HourTable>
:

3. 停車駅一覧を取得する

2のレスポンスで時刻毎のlineCodeを取得することができるので、選択した時刻の ResultSet/TimeTable/HourTable/MinuteTable/Stop/lineCode を用いて停車駅一覧を取得します。

GET /v1/xml/station/timetable/train?key=アクセスキーを入力してください&code=2で取得できる列車等を特定するコードを入れてください
<ResultSet apiVersion="1.26.0.0" engineVersion="201512_04a">
<Line>
<Name>各駅停車</Name>
<GuideComment/>
<Type>train</Type>
<Stop>
<Point getOff="False" getOn="True">
<Station code="22828">
<Name>東京</Name>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
</Point>
<DepartureState>
<Datetime operation="today">00:36:00+09:00</Datetime>
</DepartureState>
</Stop>
: