乗車位置情報

次の路線への乗り換えに便利な乗車位置の情報を表します。
ダイヤによる探索時、かつ乗り換えがある経路が対象となります。
なお、乗り換え先の区間が「徒歩」の場合は乗車位置情報は返りません。

乗車位置情報が付加される場合、されない場合の例

※乗車位置情報を付加するパラメータ(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>JR常磐線特別快速・土浦行</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">
      :
   <!-- JR湘南新宿ラインを使う経路を参照 -->
   <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>JR湘南新宿ライン快速・平塚行</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>JR中央線快速・高尾行</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>
ページ上部へ