特急列車時刻表
有料特急、有料急行、新幹線、寝台列車を対象として、運行区間一覧と時刻表を取得します。 利用方法は以下の手順となります。
- serviceSectionCodeパラメータを指定せずに運行区間一覧を取得
- その一覧の運行区間コードをserviceSectionCodeパラメータに指定して特急列車時刻表を取得
GET /v1/{format}/train/timetable
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
| Name | Type | Required | Description |
|---|---|---|---|
| format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
| key | string | ◯ | アクセスキー。必須 |
| stationName | string | --- | 駅の名称。stationCodeと排他。省略可。省略時は指定なしとなります。 |
| stationCode | string | --- | 駅コード。stationNameと排他。省略可。省略時は指定なしとなります。 |
| serviceSectionCode | string | --- | 運行区間コード。stationName, stationCodeと排他。省略可。省略時は運行区間一覧となります。 |
| number | string | --- | 号数。serviceSectionCodeと同時に指定して号数で時刻表を絞り込みます。複数指定可。省略可。省略時は指定なしとなります。 |
| date | int | --- | 一覧取得日付。省略可。 Format: YYYYMMDD Default: 現在日付 |
response
| Name | Description |
|---|---|
| ResultSet | レスポンスの最下部を表す要素 |
| ResultSet / apiVersion | WebAPIバージョン |
| ResultSet / engineVersion | エンジンバージョン |
| ResultSet / max | データの全件数 |
| ResultSet / Corporation | 会社を表す要素 |
| ResultSet / Corporation / index | インデックス ※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項 |
| ResultSet / Corporation / Name | 会社の名称を表す要素 |
| ResultSet / Line | 区間 を表す要素 |
| ResultSet / Line / code | 短期的な利用を前提とした列車コード |
| ResultSet / Line / corporationIndex | ResultSet / Corporation / indexと紐づくインデックス |
| ResultSet / Line / trainID | 列車を特定する短期ID ※保存には不向きです |
| ResultSet / Line / DriveComment | 運行に関するコメントを表す要素 |
| ResultSet / Line / GuideComment | 列車等に関するコメントを表す要素 |
| ResultSet / Line / Name | 名称を表す要素 |
| ResultSet / Line / Name / line_part | 列車愛称 |
| ResultSet / Line / Name / type_part | 種別名称(新幹線や特急など) |
| ResultSet / Line / Number | 番号(号、便など)を表す要素 |
| ResultSet / Line / ServiceSection | 運行区間を表す要素 |
| ResultSet / Line / ServiceSection / arrival | 区間終点駅名 |
| ResultSet / Line / ServiceSection / code | 運行区間コード |
| ResultSet / Line / ServiceSection / departure | 区間始発駅名 |
| 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 | 駅の名称を表す要素 |
example
運行区間一覧の取得
GET /v1/xml/train/timetable?key=アクセスキーを入力してください&stationCode=22828
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a" max="24">
<Line>
<Name>Ｍａｘたにがわ</Name>
<ServiceSection code="110:0" departure="東京" arrival="ガーラ湯沢">東京－ガーラ湯沢</ServiceSection>
<ServiceSection code="110:1" departure="ガーラ湯沢" arrival="東京">ガーラ湯沢－東京</ServiceSection>
</Line>
<Line>
<Name>Ｍａｘとき</Name>
<ServiceSection code="59:0" departure="東京" arrival="新潟">東京－新潟</ServiceSection>
<ServiceSection code="59:1" departure="新潟" arrival="東京">新潟－東京</ServiceSection>
</Line>
<Line>
<Name>あさま</Name>
<ServiceSection code="113:0" departure="長野" arrival="東京">長野－東京</ServiceSection>
<ServiceSection code="113:1" departure="東京" arrival="長野">東京－長野</ServiceSection>
</Line>
<Line>
<Name>あやめ</Name>
<ServiceSection code="13:0" departure="銚子" arrival="東京">銚子－東京</ServiceSection>
<ServiceSection code="13:1" departure="鹿島神宮" arrival="東京">鹿島神宮－東京</ServiceSection>
<ServiceSection code="13:2" departure="東京" arrival="鹿島神宮">東京－鹿島神宮</ServiceSection>
<ServiceSection code="13:3" departure="東京" arrival="銚子">東京－銚子</ServiceSection>
</Line>
<Line>
<Name>かいじ</Name>
<ServiceSection code="51:0" departure="東京" arrival="竜王">東京－竜王</ServiceSection>
<ServiceSection code="51:1" departure="竜王" arrival="東京">竜王－東京</ServiceSection>
</Line>
<Line>
:
</Line>
</ResultSet>
GET /v1/json/train/timetable?key=アクセスキーを入力してください&stationCode=22828
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"max": "24",
"Line": [
{
"Name": "Ｍａｘたにがわ",
"ServiceSection": [
{
"text": "東京－ガーラ湯沢",
"code": "110:0",
"departure": "東京",
"arrival": "ガーラ湯沢"
},
{
"text": "ガーラ湯沢－東京",
"code": "110:1",
"departure": "ガーラ湯沢",
"arrival": "東京"
}
]
},
{
"Name": "Ｍａｘとき",
"ServiceSection": [
{
"text": "東京－新潟",
"code": "59:0",
"departure": "東京",
"arrival": "新潟"
},
{
"text": "新潟－東京",
"code": "59:1",
"departure": "新潟",
"arrival": "東京"
}
]
},
{
"Name": "あさま",
"ServiceSection": [
{
"text": "長野－東京",
"code": "113:0",
"departure": "長野",
"arrival": "東京"
},
{
"text": "東京－長野",
"code": "113:1",
"departure": "東京",
"arrival": "長野"
}
]
},
{
"Name": "あやめ",
"ServiceSection": [
{
"text": "銚子－東京",
"code": "13:0",
"departure": "銚子",
"arrival": "東京"
},
{
"text": "鹿島神宮－東京",
"code": "13:1",
"departure": "鹿島神宮",
"arrival": "東京"
},
{
"text": "東京－鹿島神宮",
"code": "13:2",
"departure": "東京",
"arrival": "鹿島神宮"
},
{
"text": "東京－銚子",
"code": "13:3",
"departure": "東京",
"arrival": "銚子"
}
]
},
{
"Name": "かいじ",
"ServiceSection": [
{
"text": "東京－竜王",
"code": "51:0",
"departure": "東京",
"arrival": "竜王"
},
{
"text": "竜王－東京",
"code": "51:1",
"departure": "竜王",
"arrival": "東京"
}
]
},
{
:
}
]
}
}
特急列車時刻表の取得
GET /v1/xml/train/timetable?key=アクセスキーを入力してください&serviceSectionCode=59:1
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a" max="19">
<Line corporationIndex="1" trainID="300C" code="51292">
<Name type_part="新幹線" line_part="Ｍａｘとき">新幹線 Ｍａｘとき300号</Name>
<Number>300</Number>
<DriveComment>平日運転・2014年3月15日から有効</DriveComment>
<GuideComment>全車禁煙。普通車全車自由席。オール2階建て8両編成で運転。</GuideComment>
<Stop>
<Point getOn="True" getOff="False">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="24033">
<Name>新潟</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:05:00+09:00</Datetime>
</DepartureState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="24016">
<Name>燕三条</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:17:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:16:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="24029">
<Name>長岡</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:28:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:27:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="10">
<Name>群馬県</Name>
</Prefecture>
<Station code="21913">
<Name>高崎</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">07:13:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">07:11:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="11">
<Name>埼玉県</Name>
</Prefecture>
<Station code="22029">
<Name>熊谷</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">07:31:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">07:30:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
:
</Stop>
</Line>
<Line corporationIndex="1" trainID="302C" code="51361">
<Name type_part="新幹線" line_part="Ｍａｘとき">新幹線 Ｍａｘとき302号</Name>
<Number>302</Number>
<DriveComment>毎日運転・2014年3月15日から有効</DriveComment>
<GuideComment>全車禁煙。オール2階建て16両編成で運転。</GuideComment>
<Stop>
<Point getOn="True" getOff="False">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="24033">
<Name>新潟</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:29:00+09:00</Datetime>
</DepartureState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="24016">
<Name>燕三条</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:42:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:41:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="24029">
<Name>長岡</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">06:53:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:52:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="23913">
<Name>浦佐</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">07:07:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">07:06:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
<Point getOn="True" getOff="True">
<Prefecture code="15">
<Name>新潟県</Name>
</Prefecture>
<Station code="23938">
<Name>越後湯沢</Name>
</Station>
</Point>
<DepartureState>
<Datetime operation="today">07:20:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">07:19:00+09:00</Datetime>
</ArrivalState>
</Stop>
<Stop>
:
</Stop>
</Line>
<Line>
:
</Line>
<Corporation index="1">
<Name>ＪＲ</Name>
</Corporation>
</ResultSet>
GET /v1/json/train/timetable?key=アクセスキーを入力してください&serviceSectionCode=59:1
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"max": "19",
"Line": [
{
"corporationIndex": "1",
"trainID": "300C",
"code": "51292",
"Name": {
"text": "新幹線 Ｍａｘとき300号",
"type_part": "新幹線",
"line_part": "Ｍａｘとき"
},
"Number": "300",
"DriveComment": "平日運転・2014年3月15日から有効",
"GuideComment": "全車禁煙。普通車全車自由席。オール2階建て8両編成で運転。",
"Stop": [
{
"Point": {
"getOn": "True",
"getOff": "False",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "24033",
"Name": "新潟"
}
},
"DepartureState": {
"Datetime": {
"text": "06:05:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "24016",
"Name": "燕三条"
}
},
"DepartureState": {
"Datetime": {
"text": "06:17:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:16:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "24029",
"Name": "長岡"
}
},
"DepartureState": {
"Datetime": {
"text": "06:28:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:27:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "10",
"Name": "群馬県"
},
"Station": {
"code": "21913",
"Name": "高崎"
}
},
"DepartureState": {
"Datetime": {
"text": "07:13:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "07:11:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "11",
"Name": "埼玉県"
},
"Station": {
"code": "22029",
"Name": "熊谷"
}
},
"DepartureState": {
"Datetime": {
"text": "07:31:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "07:30:00+09:00",
"operation": "today"
}
}
},
{
:
}
]
},
{
"corporationIndex": "1",
"trainID": "302C",
"code": "51361",
"Name": {
"text": "新幹線 Ｍａｘとき302号",
"type_part": "新幹線",
"line_part": "Ｍａｘとき"
},
"Number": "302",
"DriveComment": "毎日運転・2014年3月15日から有効",
"GuideComment": "全車禁煙。オール2階建て16両編成で運転。",
"Stop": [
{
"Point": {
"getOn": "True",
"getOff": "False",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "24033",
"Name": "新潟"
}
},
"DepartureState": {
"Datetime": {
"text": "06:29:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "24016",
"Name": "燕三条"
}
},
"DepartureState": {
"Datetime": {
"text": "06:42:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:41:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "24029",
"Name": "長岡"
}
},
"DepartureState": {
"Datetime": {
"text": "06:53:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:52:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "23913",
"Name": "浦佐"
}
},
"DepartureState": {
"Datetime": {
"text": "07:07:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "07:06:00+09:00",
"operation": "today"
}
}
},
{
"Point": {
"getOn": "True",
"getOff": "True",
"Prefecture": {
"code": "15",
"Name": "新潟県"
},
"Station": {
"code": "23938",
"Name": "越後湯沢"
}
},
"DepartureState": {
"Datetime": {
"text": "07:20:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "07:19:00+09:00",
"operation": "today"
}
}
},
{
:
}
]
},
{
:
}
],
"Corporation": {
"Name": "ＪＲ"
}
}
}
