区間の駅情報


 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.

経路シリアライズデータの区間から、停車駅一覧を取得します。 なお、停車駅の取得には列車を確定する必要があるため、平均待ち時間による探索経路シリアライズデータは利用できません。

GET /v1/{format}/course/station

parameters

Name Type Description
format string レスポンスのデータ形式の指定。必須
Values:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキーの指定。必須
serializeData string 経路シリアライズデータ。必須
checkEngineVersion string 完全な経路シリアライズデータの再現を行う場合は、シリアライズデータ作成時のエンジンバージョンと再現時のエンジンバージョンが同一かのチェックを有効にします。エンジンバージョンが異なる場合は、エラーを返します。省略可。
指定できる値:
- true: チェックする
- false: チェックしない
Default: true
sectionIndex int 区間インデックス。必須
sectionOnly string 停車駅取得の範囲。省略可
Values:
- true: 区間のみ
- false: 全体
Default: true
詳しくはこちらを参照。

sectionOnly

sectionOnlyで指定できる、停車駅取得の範囲についてです。

池袋(13:00)―山手線→(13:08)新宿(13:12)―中央線→(13:29)三鷹

という経路で、区間インデックスに"2"(=新宿三鷹間)を指定した場合、その区間の中央線の列車は、

東京[始発](12:58)――――(13:12)新宿(13:12)====(13:29)三鷹(13:29)――――(13:51)立川[終点]

になります。二重線部分が、経路に含まれる区間です。

このとき、sectionOnlyがtrueの場合は、経路の区間である新宿三鷹間(二重線の部分)の停車駅を取得できます。

secttionOnlyがfalseの場合は、区間の前後(始発の東京から終点の立川まで)を含む停車駅を取得できます。

response

Name Description
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / Line / index 区間インデックス
ResultSet / Line / ArrivalState / Datetime 到着時刻を表す要素。
Format: hh:mm:ss+09:00
ResultSet / Line / ArrivalState / Datetime 運行日判定。
Values:
- today: 日時通り
- yesterday: 前日
ResultSet / Line / ArrivalState / Datetime 出発時刻を表す要素。
Format: hh:mm:ss+09:00
ResultSet / Line / ArrivalState / Datetime 運行日判定。
Values:
- today: 日時通り
- yesterday: 前日
ResultSet / Point / index 地点インデックス
ResultSet / Point / GeoPoint / gcs 測地系
ResultSet / Point / GeoPoint / lati 緯度
Format: 度.分.秒.100分の1秒
ResultSet / Point / GeoPoint / lati_d 緯度
Format: 度
ResultSet / Point / GeoPoint / longi 経度
Format: 度.分.秒.100分の1秒
ResultSet / Point / GeoPoint / longi_d 経度
Format: 度
ResultSet / Point / Prefecture / code 都道府県コード
ResultSet / Point / Prefecture / Name 都道府県の名称
ResultSet / Point / Station / code 駅コード
ResultSet / Point / Station / Name 駅の名称
ResultSet / Point / Station / Type 交通種別
ResultSet / Point / Station / Yomi 読みかな

example

GET /v1/xml/course/station?key=アクセスキーを入力してください&serializeData=SHlUczAxLjAwLjA0rAQBAAAAJFEzAQIAAQAAAAAACAAB_38C__cDAAAAAAAAAAEAj1gAANVYAAAAAAAACgCBAAABMgIADQAPJFEzAa0DAAC0AwAAAgABAAEAAQABAAEAAAAAAAAA--T3221233232319:F3321122120:A23121141:--c003197761417cfffa1afc00cbbb2594d43f3041&sectionIndex=1
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
  <Point index="1">
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <GeoPoint gcs="tokyo" lati_d="35.702110" longi_d="139.653027" lati="35.42.7.59" longi="139.39.10.89"/>
    <Station code="22671">
      <Name>高円寺</Name>
      <Yomi>こうえんじ</Yomi>
      <Type>train</Type>
    </Station>
  </Point>
  <Line index="1">
    <DepartureState>
      <Datetime operation="today">15:41:00+09:00</Datetime>
    </DepartureState>
    <ArrivalState>
      <Datetime operation="today">15:43:00+09:00</Datetime>
    </ArrivalState>
  </Line>
  <Point index="2">
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <GeoPoint gcs="tokyo" lati_d="35.702582" longi_d="139.669166" lati="35.42.9.29" longi="139.40.9.0"/>
    <Station code="22849">
      <Name>中野(東京都)</Name>
      <Yomi>なかの</Yomi>
      <Type>train</Type>
    </Station>
  </Point>
  <Line index="2">
    <DepartureState>
      <Datetime operation="today">15:43:00+09:00</Datetime>
    </DepartureState>
    <ArrivalState>
      <Datetime operation="today">15:48:00+09:00</Datetime>
    </ArrivalState>
  </Line>
  <Point index="3">
    <Prefecture code="13">
      <Name>東京都</Name>
    </Prefecture>
    <GeoPoint gcs="tokyo" lati_d="35.6875" longi_d="139.703055" lati="35.41.15.0" longi="139.42.11.0"/>
    <Station code="22741">
      <Name>新宿</Name>
      <Yomi>しんじゅく</Yomi>
      <Type>train</Type>
    </Station>
  </Point>
</ResultSet>
GET /v1/json/course/station?key=アクセスキーを入力してください&serializeData=SHlUczAxLjAwLjA0rAQBAAAAJFEzAQIAAQAAAAAACAAB_38C__cDAAAAAAAAAAEAj1gAANVYAAAAAAAACgCBAAABMgIADQAPJFEzAa0DAAC0AwAAAgABAAEAAQABAAEAAAAAAAAA--T3221233232319:F3321122120:A23121141:--c003197761417cfffa1afc00cbbb2594d43f3041&sectionIndex=1
{
  "ResultSet": {
    "apiVersion": "1.14.0.0",
    "engineVersion": "201404_01a",
    "Point": [
      {
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "GeoPoint": {
          "gcs": "tokyo",
          "lati_d": "35.702110",
          "longi_d": "139.653027",
          "lati": "35.42.7.59",
          "longi": "139.39.10.89"
        },
        "Station": {
          "code": "22671",
          "Name": "高円寺",
          "Yomi": "こうえんじ",
          "Type": "train"
        }
      },
      {
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "GeoPoint": {
          "gcs": "tokyo",
          "lati_d": "35.702582",
          "longi_d": "139.669166",
          "lati": "35.42.9.29",
          "longi": "139.40.9.0"
        },
        "Station": {
          "code": "22849",
          "Name": "中野(東京都)",
          "Yomi": "なかの",
          "Type": "train"
        }
      },
      {
        "Prefecture": {
          "code": "13",
          "Name": "東京都"
        },
        "GeoPoint": {
          "gcs": "tokyo",
          "lati_d": "35.6875",
          "longi_d": "139.703055",
          "lati": "35.41.15.0",
          "longi": "139.42.11.0"
        },
        "Station": {
          "code": "22741",
          "Name": "新宿",
          "Yomi": "しんじゅく",
          "Type": "train"
        }
      }
    ],
    "Line": [
      {
        "DepartureState": {
          "Datetime": {
            "text": "15:41:00+09:00",
            "operation": "today"
          }
        },
        "ArrivalState": {
          "Datetime": {
            "text": "15:43:00+09:00",
            "operation": "today"
          }
        }
      },
      {
        "DepartureState": {
          "Datetime": {
            "text": "15:43:00+09:00",
            "operation": "today"
          }
        },
        "ArrivalState": {
          "Datetime": {
            "text": "15:48:00+09:00",
            "operation": "today"
          }
        }
      }
    ]
  }
}