駅情報

指定された条件に当てはまる駅の情報を返します。

GET /v1/{format}/station

parameters

※ Requiredの「△」は、そのパラメータと依存関係にあるパラメータが指定された場合にのみ必須になることを示します。

Name Type Required Description
format string レスポンスのデータ形式の指定。必須。
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキーの指定。必須
name string --- 候補文字列。oldName, code, corporationName, railName, operationLineCode と排他。かつ省略可なため、排他のパラメータが存在しない場合はname省略扱いとなります。
oldName string --- 駅の旧名称。name, code, corporationName, railName, operationLineCode と排他。
code int --- 駅コード。name, oldName, corporationName, railName, operationLineCode と排他。
corporationName string --- 会社。name, code, railName, operationLineCode と排他。
railName string --- 「駅すぱあと」の平均路線名。name, oldName, code, corporationName, operationLineCode と排他。
operationLineCode string --- 運行路線コード。name, oldName, code, corporationName, railName と排他。
type string --- 駅の路線の交通種別 。oldName, code, corporationName, railName, operationLineCode 利用時には無効です。複数指定可。省略可。省略時は指定なしとなります。
指定できる値:
- train: 鉄道
- plane: 航空
prefectureCode int --- 都道府県コード。省略可。複数指定可。oldName, code, railName, operationLineCode 指定時無効です。省略時は全国が対象となります。
offset int --- データの取得開始位置。省略可。oldName, code, railName, operationLineCode 指定時無効です。
Default: 1
limit int --- データのブロック件数。省略可。oldName, code, railName, operationLineCode 指定時無効です。最大100件。
Default: 100
direction string --- 路線の停車駅取得方向。railName, operationLineCode 指定時のみ有効。
指定できる値:
- up: 通常
- down: 反転
- none: 指定なし
Default: up
corporationBind string --- 固定会社名。指定した会社のみ利用します。複数指定可。最大10件。省略可。省略時は制限のない通常の取得となります。
gcs string --- レスポンスに座標が含まれる場合、座標の測地系を指定することができます。省略可。
指定できる値:
- tokyo: 日本測地系
- wgs84: 世界測地系
Default: tokyo

response

Name Description
ResultSet レスポンスの最下部を表す要素
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / max データの全件数。一度に取得できない場合は、offsetの指定を繰り上げて取得してください。
ResultSet / offset データ開始位置のオフセット値
ResultSet / Point 地点を表す要素
ResultSet / Point / index インデックス。
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
※ railName指定時付加
ResultSet / Point / GeoPoint 座標を表す要素
ResultSet / Point / GeoPoint / longi 経度。
Format: 度.分.秒.100分の1秒
ResultSet / Point / GeoPoint / lati 緯度。
Format: 度.分.秒.100分の1秒
ResultSet / Point / GeoPoint / longi_d 経度。
Format:
ResultSet / Point / GeoPoint / lati_d 緯度。
Format:
ResultSet / Point / GeoPoint / gcs 測地系
ResultSet / Point / Prefecture 都道府県を表す要素
ResultSet / Point / Prefecture / code 都道府県コード
ResultSet / Point / Prefecture / Name 都道府県の名称
ResultSet / Point / Station を表す要素
ResultSet / Point / Station / code 駅コード
ResultSet / Point / Station / Name 駅の名称を表す要素
ResultSet / Point / Station / OldName 旧名称を表す要素。
※ oldName指定時付加
ResultSet / Point / Station / Type 交通種別を表す要素。
- train: 鉄道
- plane: 航空
ResultSet / Point / Station / Type / detail 交通種別の詳細。複数の場合は:区切り。
ResultSet / Point / Station / Yomi の読みかなを表す要素
ResultSet / RoundTripType 往復の種類を表す要素。railNameを指定した時のみ付加します。
- same: 往復が同じ停車駅を通過する場合
- different: 往復で異なる停車駅を通過する場合
- none: 往復共に停車駅が存在しない場合(廃止路線等)
- other: same, different, noneに当てはまらない場合(環状線や片道運行等)

example

駅コードを指定して駅情報を取得する

GET /v1/xml/station?key=アクセスキーを入力してください&code=22828
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="201612_02a">
  <Point>
    <Station code="22828">
      <Name>東京</Name>
      <Type>train</Type>
      <Yomi>とうきょう</Yomi>
    </Station>
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <GeoPoint longi="139.46.13.59" lati="35.40.41.9" longi_d="139.770444" lati_d="35.678083" gcs="tokyo"/>
  </Point>
</ResultSet>
GET /v1/json/station?key=アクセスキーを入力してください&code=22828
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "201612_02a",
    "Point": {
      "Station": {
        "code": "22828",
        "Name": "東京",
        "Type": "train",
        "Yomi": "とうきょう"
      },
      "Prefecture": {
        "code": "13",
        "Name": "東京都"
      },
      "GeoPoint": {
        "longi": "139.46.13.59",
        "lati": "35.40.41.9",
        "longi_d": "139.770444",
        "lati_d": "35.678083",
        "gcs": "tokyo"
      }
    }
  }
}

旧名称から新名称を取得する

GET /v1/xml/station?key=アクセスキーを入力してください&oldName=上鯖江
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="201612_02a">
  <Point>
    <Station code="23799">
      <OldName>上鯖江</OldName>
      <Name>サンドーム西</Name>
      <Type>train</Type>
      <Yomi>さんどーむにし</Yomi>
    </Station>
    <Prefecture code="18">
      <Name>福井県</Name>
    </Prefecture>
    <GeoPoint longi="136.11.0.29" lati="35.55.59.79" longi_d="136.183416" lati_d="35.933277" gcs="tokyo"/>
  </Point>
</ResultSet>
GET /v1/json/station?key=アクセスキーを入力してください&oldName=上鯖江
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "201612_02a",
    "Point": {
      "Station": {
        "code": "23799",
        "OldName": "上鯖江",
        "Name": "サンドーム西",
        "Type": "train",
        "Yomi": "さんどーむにし"
      },
      "Prefecture": {
        "code": "18",
        "Name": "福井県"
      },
      "GeoPoint": {
        "longi": "136.11.0.29",
        "lati": "35.55.59.79",
        "longi_d": "136.183416",
        "lati_d": "35.933277",
        "gcs": "tokyo"
      }
    }
  }
}