鉄道駅時刻表(旧版)
鉄道駅の時刻表を取得します。 利用方法は以下の手順となります。
- codeパラメータを指定せずに方面別一覧を取得
- 時刻表を取得したい方面のコードを指定して、鉄道駅時刻表を取得
GET /v1/{format}/station/timetable
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキー。必須 |
stationCode | int | △ | 駅コード。stationNameが指定されていない場合必須となります。交通種別がtrainのもののみ指定可能です。 |
stationName | string | △ | 駅の名称。stationCodeが指定されていない場合必須となります。交通種別がtrainのもののみ指定可能です。 |
date | int | --- | 時刻表取得日付。省略可。省略時は日付を考慮しない時刻表になります。 Format: YYYYMMDD |
code | int | --- | 時刻表を特定する一意のコード。省略可。省略時は駅時刻表の方面別一覧を返します。 |
response
Name | Description |
---|---|
ResultSet | レスポンスの最下部を表す要素 |
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / TimeTable | 時刻表を表す要素 |
ResultSet / TimeTable / code | 時刻表を特定する一意のコード。※長期の保持は不可 |
ResultSet / TimeTable / HourTable | 時(Hour)に関連した要素を並べて表す要素 |
ResultSet / TimeTable / HourTable / Hour | 時(Hour)を表す要素 |
ResultSet / TimeTable / HourTable / MinuteTable | 分(Minute)に関連した要素を並べて表す要素 |
ResultSet / TimeTable / HourTable / MinuteTable / Minute | 分(Minute)を表す要素 |
ResultSet / TimeTable / HourTable / MinuteTable / Stop | 停車を表す要素 |
ResultSet / TimeTable / HourTable / MinuteTable / Stop / destinationCode | 方面コード |
ResultSet / TimeTable / HourTable / MinuteTable / Stop / kindCode | 種別コード |
ResultSet / TimeTable / HourTable / MinuteTable / Stop / lineCode | 列車等を特定するコード |
ResultSet / TimeTable / HourTable / MinuteTable / Stop / nameCode | 列車名称コード |
ResultSet / TimeTable / Line | 区間 を表す要素 |
ResultSet / TimeTable / Line / Direction | 具体的な行き先方面を表す要素 ※経路探索のレスポンスの ResultSet / Course / Route / Line / direction とは別物です。 |
ResultSet / TimeTable / Line / Name | 名称を表す要素 |
ResultSet / TimeTable / LineDestination | 列車等の行き先情報を表す要素 |
ResultSet / TimeTable / LineDestination / code | 方面コード |
ResultSet / TimeTable / LineDestination / Mark | 時刻表用のマークを表す要素 |
ResultSet / TimeTable / LineKind | 列車等の種別情報を表す要素 |
ResultSet / TimeTable / LineKind / code | 種別コード |
ResultSet / TimeTable / LineKind / Mark | 時刻表用のマークを表す要素 |
ResultSet / TimeTable / LineName | 列車等の名称を表す要素 |
ResultSet / TimeTable / LineName / code | 列車名称コード |
ResultSet / TimeTable / LineName / Mark | 時刻表用のマークを表す要素 |
ResultSet / TimeTable / Station | 駅を表す要素 |
ResultSet / TimeTable / Station / Name | 駅の名称を表す要素 |
example
駅コードから方面別一覧を取得する場合
GET /v1/xml/station/timetable?key=アクセスキーを入力してください&stationCode=22828
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<TimeTable code="1">
<Station>
<Name>東京</Name>
</Station>
<Line>
<Name>横須賀・総武線</Name>
<Direction>逗子・久里浜</Direction>
</Line>
</TimeTable>
<TimeTable code="2">
<Station>
<Name>東京</Name>
</Station>
<Line>
<Name>横須賀・総武線</Name>
<Direction>津田沼・千葉</Direction>
</Line>
</TimeTable>
<TimeTable code="3">
<Station>
<Name>東京</Name>
</Station>
<Line>
<Name>京浜東北・根岸線</Name>
<Direction>磯子・大船</Direction>
</Line>
</TimeTable>
<TimeTable>
:
</TimeTable>
</ResultSet>
GET /v1/json/station/timetable?key=アクセスキーを入力してください&stationCode=22828
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"TimeTable": [
{
"code": "1",
"Station": {
"Name": "東京"
},
"Line": {
"Name": "横須賀・総武線",
"Direction": "逗子・久里浜"
}
},
{
"code": "2",
"Station": {
"Name": "東京"
},
"Line": {
"Name": "横須賀・総武線",
"Direction": "津田沼・千葉"
}
},
{
"code": "3",
"Station": {
"Name": "東京"
},
"Line": {
"Name": "京浜東北・根岸線",
"Direction": "磯子・大船"
}
},
{
:
}
]
}
}
codeパラメータを指定して詳細な時刻表を取得
GET /v1/xml/station/timetable?key=アクセスキーを入力してください&stationCode=22828&code=1
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<TimeTable code="1">
<Station>
<Name>東京</Name>
</Station>
<Line>
<Name>横須賀・総武線</Name>
<Direction>逗子・久里浜</Direction>
</Line>
<HourTable>
<Hour>4</Hour>
<MinuteTable>
<Minute>55</Minute>
<Stop lineCode="52675" kindCode="1" nameCode="1" destinationCode="1" first="True"/>
</MinuteTable>
</HourTable>
<HourTable>
<Hour>5</Hour>
<MinuteTable>
<Minute>24</Minute>
<Stop lineCode="86779" kindCode="1" nameCode="1" destinationCode="5"/>
</MinuteTable>
<MinuteTable>
<Minute>45</Minute>
<Stop lineCode="86784" kindCode="1" nameCode="1" destinationCode="5"/>
</MinuteTable>
</HourTable>
<HourTable>
<Hour>6</Hour>
<MinuteTable>
<Minute>1</Minute>
<Stop lineCode="52677" kindCode="1" nameCode="1" destinationCode="1" first="True"/>
</MinuteTable>
<MinuteTable>
<Minute>15</Minute>
<Stop lineCode="86786" kindCode="1" nameCode="1" destinationCode="5"/>
</MinuteTable>
<MinuteTable>
<Minute>33</Minute>
<Stop lineCode="77240" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>44</Minute>
<Stop lineCode="52679" kindCode="1" nameCode="1" destinationCode="1" first="True"/>
</MinuteTable>
<MinuteTable>
<Minute>57</Minute>
<Stop lineCode="77242" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
</HourTable>
<HourTable>
:
</HourTable>
<LineKind code="1">普通<Mark/></LineKind>
<LineDestination code="2">品川<Mark>品</Mark></LineDestination>
<LineDestination code="5">横須賀<Mark>横</Mark></LineDestination>
<LineDestination code="4">逗子<Mark>逗</Mark></LineDestination>
<LineDestination code="3">大船<Mark>大</Mark></LineDestination>
<LineDestination code="1">久里浜<Mark/></LineDestination>
<LineName code="1">無し<Mark/></LineName>
</TimeTable>
</ResultSet>
GET /v1/json/station/timetable?key=アクセスキーを入力してください&stationCode=22828&code=1
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"TimeTable": {
"code": "1",
"Station": {
"Name": "東京"
},
"Line": {
"Name": "横須賀・総武線",
"Direction": "逗子・久里浜"
},
"HourTable": [
{
"Hour": "4",
"MinuteTable": {
"Minute": "55",
"Stop": {
"lineCode": "52675",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1",
"first": "True"
}
}
},
{
"Hour": "5",
"MinuteTable": [
{
"Minute": "24",
"Stop": {
"lineCode": "86779",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "5"
}
},
{
"Minute": "45",
"Stop": {
"lineCode": "86784",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "5"
}
}
]
},
{
"Hour": "6",
"MinuteTable": [
{
"Minute": "1",
"Stop": {
"lineCode": "52677",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1",
"first": "True"
}
},
{
"Minute": "15",
"Stop": {
"lineCode": "86786",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "5"
}
},
{
"Minute": "33",
"Stop": {
"lineCode": "77240",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "44",
"Stop": {
"lineCode": "52679",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1",
"first": "True"
}
},
{
"Minute": "57",
"Stop": {
"lineCode": "77242",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
}
]
},
{
:
}
],
"LineKind": {
"text": "普通",
"code": "1"
},
"LineDestination": [
{
"text": "品川",
"code": "2",
"Mark": "品"
},
{
"text": "横須賀",
"code": "5",
"Mark": "横"
},
{
"text": "逗子",
"code": "4",
"Mark": "逗"
},
{
"text": "大船",
"code": "3",
"Mark": "大"
},
{
"text": "久里浜",
"code": "1"
}
],
"LineName": {
"text": "無し",
"code": "1"
}
}
}
}