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

特定の路線を利用しない経路探索を行う

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


 Attention!

運行路線鉄道運行情報路線運行路線情報鉄道運行情報(レスキューナウ)は、全く異なる情報です。
互換性はありませんのでご注意ください。


  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="31" offset="1" engineVersion="201808_05a">
   <Corporation index="1" code="1">
      <Name>JR</Name>
   </Corporation>
   <Line corporationIndex="1" code="134">
      <Name>JR東海道新幹線</Name>
      <Color>001032197</Color>
   </Line>
   <Line corporationIndex="1" code="94">
      <Name>JR総武線快速</Name>
      <Color>019033196</Color>
   </Line>
   <Line corporationIndex="1" code="105">
      <Name>JR湘南新宿ライン</Name>
      <Color>255080000</Color>
   </Line>
   <Line corporationIndex="1" code="106">
      <Name>JR埼京線</Name>
      <Color>000178139</Color>
   </Line>
   <Line corporationIndex="1" code="109">
      <Name>JR中央線快速</Name>
      <Color>250060002</Color>
   </Line>
   <Line corporationIndex="1" code="113">
      <Name>JR山手線内回り</Name>
      <Color>045232013</Color>
   </Line>
   <Line corporationIndex="1" code="114">
      <Name>JR山手線外回り</Name>
      <Color>045232013</Color>
   </Line>
     :
</ResultSet>

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

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

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


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

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

GET /v1/xml/search/course/extreme?key=アクセスキーを入力してください&viaList=渋谷:新宿&time=1000&interruptOperationLineCodeList=106: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>
                   :
         <Line index="1" ...>
            <Name>東京メトロ副都心線・和光市行</Name>
            <Type>train</Type>
            <Destination>和光市</Destination>
                :
         <Point index="2">
            <Station code="22743">
               <Name>新宿三丁目</Name>
                   :
         <Line index="2" ...>
            <Name>都営新宿線・橋本行</Name>
            <Type>train</Type>
            <Destination>橋本</Destination>
                :
         <Point index="3">
            <Station code="22741">
               <Name>新宿</Name>
                   :
      </Route>
      <Price kind="FareSummary">
         :
      <SerializeData>...</SerializeData>
      <Teiki>
         <SerializeData>...</SerializeData>
         <DisplayRoute>渋谷--東京メトロ副都心線--新宿三丁目--都営地下鉄新宿線--新宿</DisplayRoute>
      </Teiki>
   </Course>
     :
</ResultSet>

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

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

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

関連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版時点のサンプルデータとなります。