乗車位置情報
次の路線への乗り換えに便利な乗車位置の情報を表します。
ダイヤによる探索時、かつ乗り換えがある経路が対象となります。
なお、乗り換え先の区間が「徒歩」の場合は乗車位置情報は返りません。
乗車位置情報が付加される場合、されない場合の例
※乗車位置情報を付加するパラメータ(addChange)にtrueを指定していることが前提です。
■例 A駅 - 路線1 - B駅 - 路線2 - C駅
「A駅」でその位置に乗ると「B駅」での乗り換えに便利な位置を表す情報が「路線1」に付加されます。
「A駅」から「路線1」に乗って「B駅から路線2に乗り換える」という乗り換え先の情報があって、「路線1」の乗車位置情報が決まります。
そのため、「C駅」で乗り換えがない「路線2」には乗車位置の情報は付加されません。
■例 A駅 - 路線1 - B駅
ひとつ前の「A駅 - 路線1 - B駅 - 路線2 - C駅」の例と同様に、「B駅」での乗り換えの情報がないため、「路線1」には乗車位置の情報は付加されません。
つまり、到着駅につながる路線には、乗車位置の情報は付加されません。
■例 A駅 - 路線1 - B駅 - 徒歩 - C駅
「B駅」での乗り換え先の区間は「徒歩」なので、「路線1」には乗車位置の情報は付加されません。
乗り換え先路線の行き先方面について
次の路線への乗り換えに便利な乗車位置情報は、乗り換え先路線の行き先方面によって変わります。
乗り換え先路線の行き先方面がない場合は、行き先方面に関わらず乗り換えに便利な乗車位置情報は同じです。
乗り換え手段について
次の路線への乗り換え手段を持つ車両情報によって、次の路線への乗り換えに便利な乗車位置情報を表します。
なお、車両に対して乗り換え手段が複数存在する場合もあります。
具体的な乗り換え手段は乗り換え手段種別を参照してください。
また、乗り換え手段が存在しない(つまり、便利ではない)場合は、乗り換え手段のない車両情報のみが返ります。
レスポンス例
※レスポンス例はサンプルです。実際の返却値とは異なる場合があります。
渋谷から九段下経由で馬喰横山までの経路を探索した場合
GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=渋谷:九段下:馬喰横山&time=1500&addChange=true
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="201712_01a">
<Course searchType="departure" dataType="onTimetable">
<Route timeOther="3" timeOnBoard="18" exhaustCO2="213" index="1" exhaustCO2atPassengerCar="1629" distance="97" timeWalk="0" transferCount="1">
<Point index="1">
<Station code="22715">
<Name>渋谷</Name>
<Type>train</Type>
<Yomi>しぶや</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.42.18.0" lati="35.39.19.0" longi_d="139.705" gcs="tokyo" lati_d="35.655278" />
</Point>
<Line stopStationCount="4" teiki3Index="1" teiki6Index="1" timeOnBoard="12" track="railway" exhaustCO2="145" fareIndex="1" index="1" exhaustCO2atPassengerCar="1108" distance="66" teiki1Index="1">
<Name>東京メトロ半蔵門線急行・久喜行</Name>
<Type>train</Type>
<ArrivalState no="4">
<Type>normal</Type>
<Datetime operation="today">2017-12-06T15:14:00+09:00</Datetime>
</ArrivalState>
:
<!-- 乗り換え後の路線の、行き先の方面ごとにChange要素が存在します。(このLine要素では、新宿方面と本八幡方面) -->
<Change openSide="左" nextLineDirection="新宿方面">
<!-- 車両編成ごとにFormation要素が存在します。(このChange要素では、10両編成のみ) -->
<Formation number="10">
<!-- 車両ごとにCar要素が存在します。(このFormation要素では、全部で10両) -->
<!-- Car / index は進行方向の前からindex両目であることを表します。(このCar要素では、1両目) -->
<!-- Car / number は進行方向によらない車両の絶対的な数え方が存在する場合のみ、存在します。 -->
<!-- このCar要素では、この車両は1号車であり、進行方向が逆になっても1号車であることは変わらないことを意味します。 -->
<Car index="1" number="1" />
<Car index="2" number="2" />
<Car index="3" number="3" />
<Car index="4" number="4">
<Means>
<Type>platform</Type>
</Means>
</Car>
<Car index="5" number="5">
<Means>
<Type>platform</Type>
</Means>
</Car>
<Car index="6" number="6">
<Means>
<Type>platform</Type>
</Means>
</Car>
<Car index="7" number="7" />
<Car index="8" number="8" />
<Car index="9" number="9" />
<Car index="10" number="10" />
</Formation>
</Change>
<Change openSide="左" nextLineDirection="本八幡方面">
<Formation number="10">
<Car index="1" number="1" />
<Car index="2" number="2">
<!-- 乗り換え手段ごとにMeans要素が存在します。(このCar要素では、エレベーターのみ) -->
<!-- このCar要素では、2両目(2号車)に乗るとエレベーターに近い位置になることを意味します。 -->
<Means>
<Type>elevator</Type>
</Means>
</Car>
<Car index="3" number="3">
<!-- このCar要素では、3両目(3号車)に乗ると階段とエスカレーターに近い位置になることを意味します。 -->
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>escalator</Type>
</Means>
</Car>
<!-- 乗り換え手段がない車両でも、Car要素は存在します。 -->
<Car index="4" number="4" />
<Car index="5" number="5" />
<Car index="6" number="6">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>escalator</Type>
</Means>
</Car>
<Car index="7" number="7" />
<Car index="8" number="8" />
<Car index="9" number="9">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>escalator</Type>
</Means>
</Car>
<Car index="10" number="10" />
</Formation>
</Change>
</Line>
<Point index="2">
<Station code="22645">
<Name>九段下</Name>
<Type>train</Type>
<Yomi>くだんした</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.45.16.89" lati="35.41.32.9" longi_d="139.754694" gcs="tokyo" lati_d="35.692249" />
</Point>
<Line stopStationCount="3" teiki3Index="1" teiki6Index="1" timeOnBoard="6" track="railway" exhaustCO2="68" fareIndex="1" index="2" exhaustCO2atPassengerCar="520" distance="31" teiki1Index="1">
<Name>都営新宿線・本八幡行</Name>
<Type>train</Type>
<ArrivalState no="2">
<Type>normal</Type>
<Datetime operation="today">2017-12-06T15:23:00+09:00</Datetime>
</ArrivalState>
:
</Line>
<Point index="3">
<Station code="22919">
<Name>馬喰横山</Name>
<Type>train</Type>
<Yomi>ばくろよこやま</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.47.9.39" lati="35.41.19.79" longi_d="139.785944" gcs="tokyo" lati_d="35.688832" />
</Point>
</Route>
:
</Course>
:
</ResultSet>
入谷(東京都)から南千住経由で松戸までの経路を探索した場合
GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=入谷(東京都):南千住:松戸&time=1500&addChange=true
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="201712_01a">
<Course searchType="departure" dataType="onTimetable">
<Route timeOther="9" timeOnBoard="15" exhaustCO2="321" index="1" exhaustCO2atPassengerCar="2452" distance="146" timeWalk="0" transferCount="1">
<Point index="1">
<Station code="22526">
<Name>入谷(東京都)</Name>
<Type>train</Type>
<Yomi>いりや</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.47.14.69" lati="35.43.1.50" longi_d="139.787416" gcs="tokyo" lati_d="35.717083" />
</Point>
<Line stopStationCount="2" teiki3Index="1" teiki6Index="1" timeOnBoard="7" track="railway" exhaustCO2="90" fareIndex="1" index="1" exhaustCO2atPassengerCar="688" distance="41" teiki1Index="1">
<Name>東京メトロ日比谷線・東武動物公園行</Name>
<Type>train</Type>
<ArrivalState no="5">
<Type>normal</Type>
<Datetime operation="today">2017-12-06T15:09:00+09:00</Datetime>
</ArrivalState>
:
<!-- 乗り換え後の路線の、行き先の方面ごとにChange要素が存在します。(このLine要素では、方面による違いはありません) -->
<Change openSide="右">
<!-- 車両編成ごとにFormation要素が存在します。(このChange要素では、7両編成と8両編成) -->
<Formation number="7">
<!-- 車両ごとにCar要素が存在します。(このFormation要素では、全部で7両) -->
<!-- Car / index は進行方向の前からindex両目であることを表します。(このCar要素では、1両目) -->
<!-- Car / number は進行方向によらない車両の絶対的な数え方が存在する場合のみ、存在します。 -->
<!-- このCar要素では、この車両は何号車という数え方が存在しないことを意味します。 -->
<Car index="1">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>escalator</Type>
</Means>
<Means>
<Type>elevator</Type>
</Means>
</Car>
<Car index="2" />
<Car index="3" />
<Car index="4" />
<Car index="5" />
<Car index="6" />
<Car index="7">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>elevator</Type>
</Means>
</Car>
</Formation>
<Formation number="8">
<Car index="1">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>escalator</Type>
</Means>
<Means>
<Type>elevator</Type>
</Means>
</Car>
<Car index="2" />
<Car index="3" />
<Car index="4" />
<Car index="5" />
<Car index="6" />
<Car index="7" />
<Car index="8">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>elevator</Type>
</Means>
</Car>
</Formation>
</Change>
</Line>
<Point index="2">
<Station code="22630">
<Name>北千住</Name>
<Type>train</Type>
<Yomi>きたせんじゅ</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.48.30.0" lati="35.44.47.0" longi_d="139.808333" gcs="tokyo" lati_d="35.746389" />
</Point>
<Line stopStationCount="0" teiki3Index="2" chargeIndex="1" teiki6Index="2" timeOnBoard="8" track="railway" exhaustCO2="231" fareIndex="2" index="2" exhaustCO2atPassengerCar="1764" distance="105" teiki1Index="2">
<Name>ＪＲ常磐線特別快速・土浦行</Name>
<Type>train</Type>
<ArrivalState no="1">
<Type>normal</Type>
<Datetime operation="today">2017-12-06T15:26:00+09:00</Datetime>
</ArrivalState>
:
</Line>
<Point index="3">
<Station code="22444">
<Name>松戸</Name>
<Type>train</Type>
<Yomi>まつど</Yomi>
</Station>
<Prefecture code="12">
<Name>千葉県</Name>
</Prefecture>
<GeoPoint longi="139.54.14.0" lati="35.46.52.0" longi_d="139.903889" gcs="tokyo" lati_d="35.781111" />
</Point>
</Route>
:
</Course>
:
</ResultSet>
赤羽から新宿経由で高円寺までの経路を探索した場合
GET /v1/xml/search/course/extreme?addChange=true&viaList=赤羽:新宿:高円寺&time=1600&key=アクセスキーを入力してください
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="202009_02a">
:
<!-- ＪＲ湘南新宿ラインを使う経路を参照 -->
<Course searchType="departure" dataType="onTimetable">
<Route timeOther="6" timeOnBoard="24" exhaustCO2="322" index="3" exhaustCO2atPassengerCar="2270" distance="161" timeWalk="0" transferCount="1">
<Point index="1">
<Station code="22487">
<Name>赤羽</Name>
<Type>train</Type>
<Yomi>あかばね</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.43.27.0" lati="35.46.28.0" longi_d="139.724167" gcs="tokyo" lati_d="35.774444" />
</Point>
<!-- 列車の編成数が分かる区間だった場合、cars属性が返却される（このLine要素では、15両編成）-->
<Line ... index="1" cars="15" ... >
<Name>ＪＲ湘南新宿ライン快速・平塚行</Name>
<Type>train</Type>
<ArrivalState no="1">
<Type>normal</Type>
<Datetime operation="today">2020-09-01T16:29:00+09:00</Datetime>
</ArrivalState>
<Destination>平塚</Destination>
<TimeReliability>onTimetable</TimeReliability>
<DepartureState no="5">
<Type>normal</Type>
<Datetime operation="today">2020-09-01T16:11:00+09:00</Datetime>
</DepartureState>
<LineSymbol code="16">
<Name>JS</Name>
</LineSymbol>
<Color>255080000</Color>
<Change openSide="右">
<!-- cars属性の値と一致する乗車位置情報が返却される。(このFormation要素では、15両編成) -->
<Formation number="15">
<Car index="1" number="1" />
<Car index="2" number="2" />
<Car index="3" number="3" />
<Car index="4" number="4" />
<Car index="5" number="5" />
<Car index="6" number="6" />
<Car index="7" number="7" />
<Car index="8" number="8" />
<Car index="9" number="9" />
<Car index="10" number="10">
<Means>
<Type>stairs</Type>
</Means>
</Car>
<Car index="11" number="11">
<Means>
<Type>elevator</Type>
</Means>
</Car>
<Car index="12" number="12" />
<Car index="13" number="13">
<Means>
<Type>stairs</Type>
</Means>
<Means>
<Type>escalator</Type>
</Means>
</Car>
<Car index="14" number="14" />
<Car index="15" number="15">
<Means>
<Type>stairs</Type>
</Means>
</Car>
</Formation>
</Change>
</Line>
<Point index="2">
<Station code="22741">
<Name>新宿</Name>
<Type>train</Type>
<Yomi>しんじゅく</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.42.11.0" lati="35.41.15.0" longi_d="139.703056" gcs="tokyo" lati_d="35.6875" />
</Point>
<Line stopStationCount="1" teiki3Index="1" teiki6Index="1" timeOnBoard="6" track="railway" exhaustCO2="116" fareIndex="1" index="2" exhaustCO2atPassengerCar="817" distance="58" trainID="1651T" teiki1Index="1">
<Name>ＪＲ中央線快速・高尾行</Name>
<Type>train</Type>
<ArrivalState no="3">
<Type>normal</Type>
<Datetime operation="today">2020-09-01T16:41:00+09:00</Datetime>
</ArrivalState>
:
</Line>
<Point index="3">
<Station code="22671">
<Name>高円寺</Name>
<Type>train</Type>
<Yomi>こうえんじ</Yomi>
</Station>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint longi="139.39.10.89" lati="35.42.7.59" longi_d="139.653027" gcs="tokyo" lati_d="35.70211" />
</Point>
</Route>
:
</Course>
:
</ResultSet>
