区間の駅情報
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)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 35.42.6.0 |
ResultSet / Point / GeoPoint / lati_d | 緯度。十進法度(DD)単位。 Format: 度 Example: 35.701667 |
ResultSet / Point / GeoPoint / longi | 経度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 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§ionIndex=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§ionIndex=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"
}
}
}
]
}
}