区間時刻表
経路の 区間 から時刻表を取得します。
GET /v1/{format}/course/timetable
Attention!
区間時刻表を利用することができるのは鉄道のみです。
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須。 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキー。必須 |
serializeData | string | ◯ | 経路シリアライズデータ。必須 |
checkEngineVersion | string | --- | 完全な経路シリアライズデータの再現を行う場合は、シリアライズデータ作成時のエンジンバージョンと再現時のエンジンバージョンが同一かのチェックを有効にします。エンジンバージョンが異なる場合は、エラーを返します。省略可。 指定できる値: - true: チェックする - false: チェックしない Default: true |
sectionIndex | 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 / extra | 臨時・運転日注意フラグ |
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 / HourTable / MinuteTable / Stop / Number | 番号(号、便など)を表す要素 |
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/course/timetable?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">
<TimeTable code="1">
<Station>
<Name>高円寺</Name>
</Station>
<Line>
<Name>中央・青梅・五日市線</Name>
<Direction>新宿・東京</Direction>
</Line>
<HourTable>
<Hour>4</Hour>
<MinuteTable>
<Minute>43</Minute>
<Stop lineCode="78308" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>51</Minute>
<Stop lineCode="78435" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
</HourTable>
<HourTable>
<Hour>5</Hour>
<MinuteTable>
<Minute>4</Minute>
<Stop lineCode="78549" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>14</Minute>
<Stop lineCode="79083" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>23</Minute>
<Stop lineCode="78552" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>29</Minute>
<Stop lineCode="78556" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>38</Minute>
<Stop lineCode="79089" kindCode="1" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
:
</MinuteTable>
</HourTable>
<HourTable>
<Hour>6</Hour>
<MinuteTable>
<Minute>3</Minute>
<Stop lineCode="78493" kindCode="2" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>10</Minute>
<Stop lineCode="78496" kindCode="2" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>16</Minute>
<Stop lineCode="78896" kindCode="2" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>22</Minute>
<Stop lineCode="78497" kindCode="2" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
<Minute>30</Minute>
<Stop lineCode="78499" kindCode="2" nameCode="1" destinationCode="1"/>
</MinuteTable>
<MinuteTable>
:
</MinuteTable>
</HourTable>
<HourTable>
:
</HourTable>
<LineKind code="2">快速<Mark>快</Mark></LineKind>
<LineKind code="1">各駅停車<Mark/></LineKind>
<LineDestination code="2">新宿<Mark>新</Mark></LineDestination>
<LineDestination code="1">東京<Mark/></LineDestination>
<LineName code="1">無し<Mark/></LineName>
</TimeTable>
</ResultSet>
GET /v1/json/course/timetable?key=アクセスキーを入力してください&serializeData=SHlUczAxLjAwLjA0rAQBAAAAJFEzAQIAAQAAAAAACAAB_38C__cDAAAAAAAAAAEAj1gAANVYAAAAAAAACgCBAAABMgIADQAPJFEzAa0DAAC0AwAAAgABAAEAAQABAAEAAAAAAAAA--T3221233232319:F3321122120:A23121141:--c003197761417cfffa1afc00cbbb2594d43f3041§ionIndex=1
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"TimeTable": {
"code": "1",
"Station": {
"Name": "高円寺"
},
"Line": {
"Name": "中央・青梅・五日市線",
"Direction": "新宿・東京"
},
"HourTable": [
{
"Hour": "4",
"MinuteTable": [
{
"Minute": "43",
"Stop": {
"lineCode": "78308",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "51",
"Stop": {
"lineCode": "78435",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
}
]
},
{
"Hour": "5",
"MinuteTable": [
{
"Minute": "4",
"Stop": {
"lineCode": "78549",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "14",
"Stop": {
"lineCode": "79083",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "23",
"Stop": {
"lineCode": "78552",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "29",
"Stop": {
"lineCode": "78556",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "38",
"Stop": {
"lineCode": "79089",
"kindCode": "1",
"nameCode": "1",
"destinationCode": "1"
}
},
{
:
}
]
},
{
"Hour": "6",
"MinuteTable": [
{
"Minute": "3",
"Stop": {
"lineCode": "78493",
"kindCode": "2",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "10",
"Stop": {
"lineCode": "78496",
"kindCode": "2",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "16",
"Stop": {
"lineCode": "78896",
"kindCode": "2",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "22",
"Stop": {
"lineCode": "78497",
"kindCode": "2",
"nameCode": "1",
"destinationCode": "1"
}
},
{
"Minute": "30",
"Stop": {
"lineCode": "78499",
"kindCode": "2",
"nameCode": "1",
"destinationCode": "1"
}
},
{
:
}
]
},
{
:
}
],
"LineKind": [
{
"text": "快速",
"code": "2",
"Mark": "快"
},
{
"text": "各駅停車",
"code": "1"
}
],
"LineDestination": [
{
"text": "新宿",
"code": "2",
"Mark": "新"
},
{
"text": "東京",
"code": "1"
}
],
"LineName": {
"text": "無し",
"code": "1"
}
}
}
}