範囲探索


 Attention!

This page has not been translated into English yet. It is possible that some parts of description may contains old information. Please see Japanese Documents if you need the latest and accurate information.

駅コード駅の名称で指定されたを起点とし、上限値(分)の範囲内のを探索します。
起点となる駅は最大5件まで指定可能で、それぞれの起点に対して上限値を設定できます。複数の駅を指定した場合、各起点からの上限値(分)の範囲内に含まれる共通の駅を取得することができます。

GET /v1/{format}/search/multipleRange

parameters

Name Type Description
format string レスポンスのデータ形式の指定。必須
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキー 。必須
baseList string 駅コード駅の名称 のリスト。交通種別がtrainのもののみ指定可能です。必須。最大5件まで複数指定可。
詳しくはこちらを参照。
upperMinute int 起点駅からの所要時間の上限値。10から200まで指定可能です。
単位: 分
必須。複数指定可。baseListで指定した件数と一致する必要があります。
詳しくはこちらを参照。
upperTransferCount int 起点駅からの乗換回数の上限値。省略可。省略時は乗換回数を考慮しません。複数指定可。baseListで指定した件数と一致する必要があります。
詳しくはこちらを参照。
plane string 飛行機。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
shinkansen string 新幹線(のぞみ含む)。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
limitedExpress string 特急。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
limit int 探索結果項目の最大件数。省略可。省略時は全件を対象とします。
起点駅からの所要時間が少ない駅順に採用されます。
詳しくはこちらを参照。

baseList

baseListは駅コード駅の名称で指定します。
起点駅を複数指定した場合、各起点駅の範囲内に含まれる共通の駅のみを返します。

■例 複数の起点駅を駅コードで指定した場合
起点を新宿と東京にする場合、次のように指定します。

baseList=22741:22828

upperMinute

upperMinuteで指定する上限値の数はbaseListで指定した起点駅の数と一致する必要があり、 それぞれの上限値はbaseListで指定した起点駅の順に適用されます。

■例 複数の起点駅(baseList=A駅:B駅)に対して所要時間の上限値を指定する場合
一つ目の起点駅(A駅)の上限値を20分、二つ目の起点駅(B駅)の上限値を15分とする場合、次のように指定します。

upperMinute=20:15

Multiple range

upperTransferCount

upperTransferCountで指定する上限値の数はbaseListで指定した起点駅の数と一致させる必要があります。
また、一部の起点駅からの上限値を制限なしにすることもできます。 ただし、全ての起点駅からの上限値を制限なしにする場合は、パラメータ自体を省略してください。

■例 起点駅が3駅の場合の乗り換え回数の上限値の指定方法

1駅目 2駅目 3駅目 パラメータ値
2 1 3 upperTransferCount=2:1:3
0 制限なし 1 upperTransferCount=0::1
制限なし 0 制限なし upperTransferCount=:0:
制限なし 制限なし 制限なし パラメータを省略。詳細はこちら(複数指定)。

limit

limitを指定した場合は、起点駅からの所要時間が少ない駅順に採用されます。
また、複数の起点駅を指定した場合は、各起点駅からの所要時間のうち、一番短い値が比較対象となります。

■例. 2つの起点駅を指定してlimitを3とした場合

所要時間が以下の場合、所要時間の最小値が比較されるため、A駅、C駅、B駅が返ります。


response

Name Description
ResultSet レスポンスの最下部を表す要素
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / Base 起点を表すリスト
ResultSet / Base / index インデックス。
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Base / Point 起点となる地点を表す要素
ResultSet / Base / Point / Station 駅を表す要素
ResultSet / Base / Point / Station / code 駅コード
ResultSet / Base / Point / Station / Name 駅の名称を表す要素
ResultSet / Base / Point / Station / Type 交通種別を表す要素
ResultSet / Base / Point / Prefecture 都道府県を表す要素
ResultSet / Base / Point / Prefecture / code 都道府県コード
ResultSet / Base / Point / Prefecture / Name 都道府県の名称を表す要素
ResultSet / Point 地点を表す要素
ResultSet / Point / Cost 起点駅毎の所要時間や乗換回数を表す要素
ResultSet / Point / Cost / baseIndex ResultSet / Base / indexと紐づくインデックス
ResultSet / Point / Cost / Minute 起点からの時間を表す要素
単位: 分
ResultSet / Point / Cost / TransferCount 起点からの乗換回数を表す要素
ResultSet / Point / Prefecture 都道府県を表す要素
ResultSet / Point / Prefecture / code 都道府県コード
ResultSet / Point / Prefecture / Name 都道府県の名称を表す要素
ResultSet / Point / Station / code 駅コード
ResultSet / Point / Station / Name 駅の名称を表す要素
ResultSet / Point / Station / Type 交通種別を表す要素

example

GET /v1/xml/search/multipleRange?key=アクセスキーを入力してください&baseList=22828&upperMinute=15
<ResultSet apiVersion="1.27.0.0" engineVersion="201708_01a">
  <Point>
    <Station code="23036">
      <Name>有楽町</Name>
      <Type>train</Type>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <Cost baseIndex="1">
      <Minute>5</Minute>
      <TransferCount>0</TransferCount>
    </Cost>
  </Point>
  <Point>
    <Station code="22617">
      <Name>神田(東京都)</Name>
      <Type>train</Type>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <Cost baseIndex="1">
      <Minute>5</Minute>
      <TransferCount>0</TransferCount>
    </Cost>
  </Point>
  <Point>
    <Station code="22492">
      <Name>秋葉原</Name>
      <Type>train</Type>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <Cost baseIndex="1">
      <Minute>7</Minute>
      <TransferCount>0</TransferCount>
    </Cost>
  </Point>
  <Point>
    <Station code="22751">
      <Name>新橋</Name>
      <Type>train</Type>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <Cost baseIndex="1">
      <Minute>8</Minute>
      <TransferCount>0</TransferCount>
    </Cost>
  </Point>
  <Point>
    <Station code="22914">
      <Name>浜松町</Name>
      <Type>train</Type>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <Cost baseIndex="1">
      <Minute>9</Minute>
      <TransferCount>0</TransferCount>
    </Cost>
  </Point>
  <Point>
    <Station code="22570">
      <Name>御徒町</Name>
      <Type>train</Type>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <Cost baseIndex="1">
      <Minute>9</Minute>
      <TransferCount>0</TransferCount>
    </Cost>
  </Point>
  :
  <Base index="1">
    <Point>
      <Station code="22828">
        <Name>東京</Name>
        <Type>train</Type>
      </Station>
      <Prefecture code="13">
        <Name>東京都</Name>
      </Prefecture>
    </Point>
  </Base>
</ResultSet>
GET /v1/json/search/multipleRange?key=アクセスキーを入力してください&baseList=22828&upperMinute=15
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "201708_01a",
    "Point": [
      {
        "Station": {
          "code": "23036",
          "Name": "有楽町",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "Cost": {
          "baseIndex": "1",
          "Minute": "5",
          "TransferCount": "0"
        }
      },
      {
        "Station": {
          "code": "22617",
          "Name": "神田(東京都)",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "Cost": {
          "baseIndex": "1",
          "Minute": "5",
          "TransferCount": "0"
        }
      },
      {
        "Station": {
          "code": "22492",
          "Name": "秋葉原",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "Cost": {
          "baseIndex": "1",
          "Minute": "7",
          "TransferCount": "0"
        }
      },
      {
        "Station": {
          "code": "22751",
          "Name": "新橋",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "Cost": {
          "baseIndex": "1",
          "Minute": "8",
          "TransferCount": "0"
        }
      },
      {
        "Station": {
          "code": "22914",
          "Name": "浜松町",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "Cost": {
          "baseIndex": "1",
          "Minute": "9",
          "TransferCount": "0"
        }
      },
      {
        "Station": {
          "code": "22570",
          "Name": "御徒町",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "Cost": {
          "baseIndex": "1",
          "Minute": "9",
          "TransferCount": "0"
        }
      },
      {
          :
      }
    ]
    "Base": {
      "Point": {
        "Station": {
          "code": "22828",
          "Name": "東京",
          "Type": "train"
        },
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        }
      }
    }
  }
}