区間時刻表の列車情報
区間時刻表データ中の列車情報を取得します。
GET /v1/{format}/course/timetable/train
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキー。必須 |
code | int | ◯ | 特急列車時刻表や鉄道駅時刻表、区間時刻表の結果から取得できる列車等を特定するコード。必須。平均路線情報で取得できる列車等を特定するコードとは互換性がありません。 |
response
Name | Description |
---|---|
ResultSet | レスポンスの最下部を表す要素 |
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / Line | 区間 を表す要素 |
ResultSet / Line / DriveComment | 運行に関するコメントを表す要素 |
ResultSet / Line / GuideComment | 列車等に関するコメントを表す要素 |
ResultSet / Line / Name | 名称を表す要素 |
ResultSet / Line / Stop | 停車を表す要素 |
ResultSet / Line / Stop / ArrivalState | 到着時の状態を表す要素 |
ResultSet / Line / Stop / ArrivalState / Datetime | 時刻を表す要素。 Format: hh:mm:ss+09:00 |
ResultSet / Line / Stop / ArrivalState / Datetime / operation | 運行日判定 - today: 日時通り - yesterday: 前日 |
ResultSet / Line / Stop / DepartureState | 出発時の状態を表す要素 |
ResultSet / Line / Stop / DepartureState / Datetime | 時刻を表す要素。 Format: hh:mm:ss+09:00 |
ResultSet / Line / Stop / DepartureState / Datetime / operation | 運行日判定 - today: 日時通り - yesterday: 前日 |
ResultSet / Line / Stop / Point | 地点 を表す要素 |
ResultSet / Line / Stop / Point / getOff | 降車可能フラグ - true: 可能 - false: 不可能 |
ResultSet / Line / Stop / Point / getOn | 乗車可能フラグ - true: 可能 - false: 不可能 |
ResultSet / Line / Stop / Point / Prefecture | 都道府県を表す要素 |
ResultSet / Line / Stop / Point / Prefecture / code | 都道府県コード |
ResultSet / Line / Stop / Point / Prefecture / Name | 都道府県の名称を表す要素 |
ResultSet / Line / Stop / Point / Station | 駅を表す要素 |
ResultSet / Line / Stop / Point / Station / code | 駅コード |
ResultSet / Line / Stop / Point / Station / Name | 駅の名称を表す要素 |
ResultSet / Line / Type | 交通種別を表す要素 |
example
GET /v1/xml/course/timetable/train?key=アクセスキーを入力してください&code=22849
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<Line>
<Name>新幹線 のぞみ1号</Name>
<Type>train</Type>
<DriveComment>毎日運転・2014年3月15日から有効</DriveComment>
<GuideComment>全席禁煙。N700系車両で運転。</GuideComment>
<Stop>
<Point getOn="True" getOff="False">
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<Station code="22828">
<Name>東京</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:00:00+09:00</Datetime>
</DepartureState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<Station code="22709">
<Name>品川</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:07:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:06:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="14">
<Name>神奈川県</Name>
</Prefecture>
<Station code="23212">
<Name>新横浜</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:18:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:17:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="23">
<Name>愛知県</Name>
</Prefecture>
<Station code="25077">
<Name>名古屋</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">07:37:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">07:36:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="26">
<Name>京都府</Name>
</Prefecture>
<Station code="25647">
<Name>京都</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">08:12:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">08:11:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
:
</Stop>
</Line>
</ResultSet>
GET /v1/json/course/timetable/train?key=アクセスキーを入力してください&code=22849
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"Line": {
"Name": "新幹線 のぞみ1号",
"Type": "train",
"DriveComment": "毎日運転・2014年3月15日から有効",
"GuideComment": "全席禁煙。N700系車両で運転。",
"Stop": [
{
"Point": {
"getOn": "True",
"getOff": "False",
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"Station": {
"code": "22828",
"Name": "東京"
}
},
"DepartureState": {
"Datetime": {
"text": "06:00:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"Station": {
"code": "22709",
"Name": "品川"
}
},
"DepartureState": {
"Datetime": {
"text": "06:07:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:06:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "14",
"Name": "神奈川県"
},
"Station": {
"code": "23212",
"Name": "新横浜"
}
},
"DepartureState": {
"Datetime": {
"text": "06:18:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:17:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "23",
"Name": "愛知県"
},
"Station": {
"code": "25077",
"Name": "名古屋"
}
},
"DepartureState": {
"Datetime": {
"text": "07:37:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "07:36:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "26",
"Name": "京都府"
},
"Station": {
"code": "25647",
"Name": "京都"
}
},
"DepartureState": {
"Datetime": {
"text": "08:12:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "08:11:00+09:00",
"operation": "today"
}
}
},
{
:
}
]
}
}
}