はじめに
定期券
交通費精算(定期区間控除)
通勤費管理(定期代支給)
探索
運賃
探索結果
探索条件
地点
路線
路線図

迂回経路探索する

特定の路線を利用しない設定をすることで、迂回経路探索を行います。
利用しない路線は、運行路線コードまたは平均路線名で指定します。


  note

運行情報を利用して迂回経路を指定した場合は、 運行路線情報鉄道運行情報(レスキューナウ)を紐付けてご利用ください。


  note

ここでは特定の路線を利用しない経路探索について記載しますが、interruptCorporationListパラメータ(不通会社リスト)を利用することで、特定の会社を利用しない経路探索も可能です。

手順

運行路線コードで指定する場合

関連URL

1. 利用しない運行路線のコードを取得する

運行路線情報から、利用しない運行路線のコードを取得します。


以下の例の場合、prefectureCodeパラメータを利用して都道府県を「東京都」に絞り込み、さらにcorporationNameパラメータを利用して会社名を「JR」に絞り込んでいます。

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

GET /v1/xml/operationLine?key=アクセスキーを入力してください&prefectureCode=13&corporationName=JR
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" max="32" offset="1" engineVersion="202007_03a">
   <Corporation index="1" code="1">
      <Name>JR</Name>
   </Corporation>
   <Line corporationIndex="1" code="134">
      <Name>JR東海道新幹線</Name>
      <Yomi>じぇいあーるとうかいどうしんかんせん</Yomi>
      <Color>001032197</Color>
   </Line>
   <Line corporationIndex="1" code="93">
      <Name>JR総武本線</Name>
      <Yomi>じぇいあーるそうぶほんせん</Yomi>
      <Color>255195015</Color>
   </Line>
   <Line corporationIndex="1" code="105">
      <Name>JR湘南新宿ライン</Name>
      <Yomi>じぇいあーるしょうなんしんじゅくらいん</Yomi>
      <Color>255080000</Color>
   </Line>
   <Line corporationIndex="1" code="106">
      <Name>JR埼京線</Name>
      <Yomi>じぇいあーるさいきょうせん</Yomi>
      <Color>000178139</Color>
   </Line>
   <Line corporationIndex="1" code="109">
      <Name>JR中央線快速</Name>
      <Yomi>じぇいあーるちゅうおうせんかいそく</Yomi>
      <Color>255090035</Color>
   </Line>
   <Line corporationIndex="1" code="110">
      <Name>JR中央・総武線各駅停車</Name>
      <Yomi>じぇいあーるちゅうおうそうぶせんかくえきていしゃ</Yomi>
      <Color>255222000</Color>
   </Line>
   <Line corporationIndex="1" code="113">
      <Name>JR山手線内回り</Name>
      <Yomi>じぇいあーるやまのてせんうちまわり</Yomi>
      <Color>045232013</Color>
   </Line>
   <Line corporationIndex="1" code="114">
      <Name>JR山手線外回り</Name>
      <Yomi>じぇいあーるやまのてせんそとまわり</Yomi>
      <Color>045232013</Color>
   </Line>
      :
</ResultSet>

ResultSet/Line/code運行路線コード)が返されます。

※返却される路線情報は、2020年7月3版時点のサンプルデータを加工したものです。

2. 利用しない運行路線区間の始端、終端の駅コードを取得する

駅情報から、利用しない運行路線の区間の始端、終端の駅コードを取得します。


以下の例の場合、operationLineCodeパラメータを利用して運行路線を「JR埼京線」に絞り込んで駅情報を取得しています。

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

GET /v1/xml/station?key=アクセスキーを入力してください&operationLineCode=106
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="202007_03a">
   <Point index="1">
      <Station code="21987">
         <Name>大宮(埼玉県)</Name>
         <Type>train</Type>
         <Yomi>おおみや</Yomi>
      </Station>
         :
   </Point>
      :
   <Point index="12">
      <Station code="22487">
         <Name>赤羽</Name>
         <Type>train</Type>
         <Yomi>あかばね</Yomi>
      </Station>
         :
   </Point>
      :
   <Point index="17">
      <Station code="22715">
         <Name>渋谷</Name>
         <Type>train</Type>
         <Yomi>しぶや</Yomi>
      </Station>
         :
   </Point>
   <Point index="18">
      <Station code="22548">
         <Name>恵比寿</Name>
         <Type>train</Type>
         <Yomi>えびす</Yomi>
      </Station>
         :
   </Point>
   <Point index="19">
      <Station code="22559">
         <Name>大崎</Name>
         <Type>train</Type>
         <Yomi>おおさき</Yomi>
      </Station>
         :
   </Point>
</ResultSet>

ResultSet/Point/Station/code駅コード)が返されます。

※返却される駅情報は、2020年7月3版時点のサンプルデータを加工したものです。

3. 利用しない路線を指定して迂回経路探索を行う

interruptOperationLineCodeListパラメータ(不通運行路線コードリスト)に、1のレスポンスから取得した運行路線コードあるいは駅コード指定して、経路探索 /search/coruse/extreme を行います。
なお、interruptOperationLineCodeListパラメータは、ダイヤによる探索または平均待ち時間による探索で利用することができます。


以下の例の場合、利用しない路線として、「JR埼京線の赤羽〜大崎の区間」「JR山手線外回り」「JR湘南新宿ライン」の運行路線コードおよび駅コードを指定しています。

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

GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=渋谷:新宿&time=1000&interruptOperationLineCodeList=106,22487,22559:114:105
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="201808_05a">
   <Course searchType="departure" dataType="onTimetable">
      <Route index="1" ...>
         <Point index="1">
            <Station code="22715">
               <Name>渋谷</Name>
                  :
         </Point>
         <Line index="1" ...>
            <Name>東京メトロ副都心線・和光市行</Name>
               :
         </Line>
         <Point index="2">
            <Station code="22743">
               <Name>新宿三丁目</Name>
                  :
         </Point>
         <Line index="2" ...>
            <Name>都営新宿線・京王多摩センター行</Name>
               :
         </Line>
         <Point index="3">
            <Station code="22741">
               <Name>新宿</Name>
                  :
         </Point>
      </Route>
      <Price kind="FareSummary">
         :
      <SerializeData>...</SerializeData>
      <Teiki>
         <SerializeData>...</SerializeData>
         <DisplayRoute>渋谷--東京メトロ副都心線--新宿三丁目--都営地下鉄新宿線--新宿</DisplayRoute>
      </Teiki>
   </Course>
     :
</ResultSet>

制限のない通常の探索の場合、「JR埼京線」を利用する経路が1番目に返りますが、「JR埼京線の赤羽〜大崎の区間」「JR山手線外回り」「JR湘南新宿ライン」を利用しない設定のため、 「東京メトロ副都心線」と「都営新宿線」を乗り継ぐ経路が返ります。

※返却される経路は、2020年7月3版時点のサンプルデータを加工したものです。

平均路線名で指定する場合

関連URL

1. 利用しない平均路線の名称を取得する

平均路線情報から、利用しない平均路線の名称を取得します。


以下の例の場合、prefectureCodeパラメータを利用して都道府県を「東京都」に絞り込み、さらにcorporationNameパラメータを利用して会社名を「JR」に絞り込んでいます。

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

GET /v1/xml/rail?key=アクセスキーを入力してください&prefectureCode=13&corporationName=JR
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" max="67" offset="1" engineVersion="201808_05a">
   <Corporation index="1" code="1">
      <Name>JR</Name>
   </Corporation>
   <Line corporationIndex="1">
      <Name>JR新幹線はやぶさ</Name>
      <Type detail="shinkansen">train</Type>
      <Color>000208030</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR新幹線はやて</Name>
      <Type detail="shinkansen">train</Type>
      <Color>000208030</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR新幹線やまびこ</Name>
      <Type detail="shinkansen">train</Type>
      <Color>000208030</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR新幹線なすの</Name>
      <Type detail="shinkansen">train</Type>
      <Color>000208030</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR埼京線</Name>
      <Type>train</Type>
      <Color>000178139</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR埼京線快速</Name>
      <Type>train</Type>
      <Color>000178139</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR湘南新宿ライン</Name>
      <Type>train</Type>
      <Color>252080004</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR湘南新宿ライン快速</Name>
      <Type>train</Type>
      <Color>252080004</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR総武線</Name>
      <Type>train</Type>
      <Color>255222000</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR総武線快速</Name>
      <Type>train</Type>
      <Color>019033196</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR中央線快速</Name>
      <Type>train</Type>
      <Color>250060002</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR中央線青梅特快</Name>
      <Type>train</Type>
      <Color>250077018</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR中央線中央特快</Name>
      <Type>train</Type>
      <Color>250060002</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR山手線内回り</Name>
      <Type>train</Type>
      <Color>045232013</Color>
   </Line>
   <Line corporationIndex="1">
      <Name>JR山手線外回り</Name>
      <Type>train</Type>
      <Color>045232013</Color>
   </Line>
     :
</ResultSet>

ResultSet/Line/Name平均路線名)が返されます。

2. 利用しない路線を指定して迂回経路探索を行う

interruptRailListパラメータ(不通平均路線リスト)に、1のレスポンスから取得した平均路線名を指定して、経路探索 /search/coruse/extreme を行います。
なお、interruptRailListパラメータは、平均待ち時間による探索でのみ利用することができます。


以下の例の場合、利用しない路線として、「JR山手線外回り」「JR埼京線快速」「JR湘南新宿ライン」を指定しています。

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

GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=渋谷:新宿&searchType=plain&interruptRailList=JR山手線外回り:JR埼京線快速:JR湘南新宿ライン
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="201808_05a">
   <Course searchType="plain" dataType="plain">
      <Route index="1" ...>
         <Point index="1">
            <Station code="22715">
               <Name>渋谷</Name>
                 :
         <Line direction="Down" index="1" ...>
            <Name>京王井の頭線</Name>
            <Type>train</Type>
              :
         <Point index="2">
            <Station code="22723">
               <Name>下北沢</Name>
                 :
         <Line direction="Up" index="2" ...>
            <Name>小田急小田原線快速急行</Name>
            <Type>train</Type>
              :
         <Point index="3">
            <Station code="22741">
               <Name>新宿</Name>
                 :
      </Route>
      <Price kind="FareSummary">
         :
      <SerializeData>...</SerializeData>
      <Teiki>
         <SerializeData>...</SerializeData>
         <DetailRoute>渋谷:京王井の頭線:Down:下北沢:小田急小田原線快速急行:Up:新宿</DetailRoute>
         <DisplayRoute>渋谷--京王井の頭線--下北沢--小田急小田原線--新宿</DisplayRoute>
      </Teiki>
   </Course>
     :
</ResultSet>

制限のない通常の探索の場合、「JR山手線外回り」を利用する経路が1番目に返りますが、「JR山手線外回り」「JR埼京線快速」「JR湘南新宿ライン」を利用しない設定のため、 「京王井の頭線」と「小田急小田原線快速急行」を乗り継ぐ経路が返ります。

※返却される経路は、2018年8月5版時点のサンプルデータとなります。

ページ上部へ