区間の駅情報


 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 レスポンスのデータ形式の指定。必須。
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキーの指定。必須
serializeData string 経路シリアライズデータ。必須
checkEngineVersion string 完全な経路シリアライズデータの再現を行う場合は、シリアライズデータ作成時のエンジンバージョンと再現時のエンジンバージョンが同一かのチェックを有効にします。エンジンバージョンが異なる場合は、エラーを返します。省略可。
指定できる値:
- true: チェックする
- false: チェックしない
Default: true
sectionIndex int 区間インデックスの指定。必須
sectionOnly string 停車駅取得の範囲。省略可。
指定できる値:
- true: 区間のみ
- false: 全体
Default: true
詳しくはこちらを参照。
gcs string リクエストやレスポンスに座標が含まれる場合、座標の測地系を指定することができます。また、リクエストパラメータの座標情報はgcsパラメータとは別の測地系を個別に指定可能です。省略可。
指定できる値:
- tokyo: 日本測地系
- wgs84: 世界測地系
Default: tokyo

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の場合は、経路の区間である新宿三鷹間(二重線の部分)の停車駅を取得できます。

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

response

Name Description
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / Line 区間を表す要素
ResultSet / Line / index インデックス。
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Line / ArrivalState 到着時の状態を表す要素
ResultSet / Line / ArrivalState / Datetime 到着時刻を表す要素。
Format: hh:mm:ss+09:00
ResultSet / Line / ArrivalState / Datetime / operation 運行日判定。
- today: 日時通り
- yesterday: 前日
ResultSet / Line / DepartureState 出発時の状態を表す要素
ResultSet / Line / DepartureState / Datetime 出発時刻を表す要素。
Format: hh:mm:ss+09:00
ResultSet / Line / DepartureState / Datetime / operation 運行日判定。
- today: 日時通り
- yesterday: 前日
ResultSet / Point 地点を表す要素
ResultSet / Point / index インデックス。
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Point / getOff 降車可能フラグ。
- true: 可能
- false: 不可能
ResultSet / Point / getOn 乗車可能フラグ。
- true: 可能
- false: 不可能
ResultSet / Point / onRoute 区間内フラグ。
- true: 対象経路の区間内
- false: 区間外
ResultSet / Point / onRouteEdge 区間の端フラグ。
- true: 対象経路の端
- false: 端以外
ResultSet / Point / GeoPoint 座標を表す要素
ResultSet / Point / GeoPoint / gcs 測地系
ResultSet / Point / GeoPoint / lati 緯度。度分秒(DMS)単位。秒は小数第３位を四捨五入。
Format: 度.分.秒.1/100秒
Example: 35.42.6.0
ResultSet / Point / GeoPoint / lati_d 緯度。十進法度(DD)単位。
Format: 度
Example: 35.701667
ResultSet / Point / GeoPoint / longi 経度。度分秒(DMS)単位。秒は小数第３位を四捨五入。
Format: 度.分.秒.1/100秒
Example: 139.38.22.30
ResultSet / Point / GeoPoint / longi_d 経度。十進法度(DD)単位。
Format: 度
Example: 139.639527
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 / 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"
          }
        }
      }
    ]
  }
}
ページ上部へ
無料トライアルを使ってみる
お問い合わせ・ご相談はこちら ▷