経路探索で停車駅と発着時刻を取得する
経路探索で停車駅一覧を取得します。 通過駅は含みません。
※イメージ図 (駅すぱあと for iPhone)
関連URL
- 経路探索 /search/course/extreme
手順
経路探索で停車駅と発着時刻を取得する
ダイヤによる探索を行います。
停車を表す要素 ResultSet/Course/Route/Line/Stop以下に区間の停車駅の情報が返ります。
リクエスト例では、2018年5月28日午前15時50分出発、水道橋駅（駅コード: 22758）-> 秋葉原駅（駅コード: 22492）という条件で、ダイヤによる探索を行います。
GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=22758:22492&addStop=true&searchType=departure
<ResultSet apiVersion="1.27.0.0" engineVersion="201806_01a">
<Course searchType="departure" dataType="onTimetable">
<Route timeOther="0" timeOnBoard="5" index="1" distance="17" timeWalk="0" transferCount="0" ...>
<Point index="1">
<Station code="22758">
<Name>水道橋</Name>
<Type>train</Type>
<Yomi>すいどうばし</Yomi>
</Station>
:
</Point>
<Line stopStationCount="1" timeOnBoard="5" index="1" distance="17" ...>
<Name>ＪＲ総武線・千葉行</Name>
<Type>train</Type>
<ArrivalState no="6">
<Type>normal</Type>
<Datetime operation="today">2018-05-28T15:55:00+09:00</Datetime>
</ArrivalState>
<Destination>千葉</Destination>
<!-- 1つめの停車を表す要素 -->
<Stop index="1">
<ArrivalState>
<Datetime operation="today">15:50:00+09:00</Datetime>
</ArrivalState>
<Point getOff="True" getOn="True">
<Station code="22758">
<Name>水道橋</Name>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
</Point>
<DepartureState>
<Datetime operation="today">15:50:00+09:00</Datetime>
</DepartureState>
</Stop>
<!-- 2つめの停車を表す要素 -->
<Stop index="2">
<ArrivalState>
<Datetime operation="today">15:52:00+09:00</Datetime>
</ArrivalState>
<Point getOff="True" getOn="True">
<Station code="22582">
<Name>御茶ノ水</Name>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
</Point>
<DepartureState>
<Datetime operation="today">15:53:00+09:00</Datetime>
</DepartureState>
</Stop>
<!-- 3つめの停車を表す要素 -->
<Stop index="3">
<ArrivalState>
<Datetime operation="today">15:55:00+09:00</Datetime>
</ArrivalState>
<Point getOff="True" getOn="True">
<Station code="22492">
<Name>秋葉原</Name>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
</Point>
<DepartureState>
<Datetime operation="today">15:55:00+09:00</Datetime>
</DepartureState>
</Stop>
<!-- ここまでが停車を表す要素 -->
<TimeReliability>onTimetable</TimeReliability>
<DepartureState no="2">
<Type>normal</Type>
<Datetime operation="today">2018-05-28T15:50:00+09:00</Datetime>
</DepartureState>
<Color>255222000</Color>
</Line>
<Point index="2">
<Station code="22492">
<Name>秋葉原</Name>
<Type>train</Type>
<Yomi>あきはばら</Yomi>
</Station>
:
</Point>
</Route>
:
</Course>
:
</ResultSet>
note
このTipsでは、ワンステップで停車駅一覧と発着時刻を取得する方法をお伝えしましたが、他の方法もあります。
詳しくは、こちらをご確認ください。
