航海路線時刻表
交通種別がshipの路線から時刻表を取得します。
GET /v1/{format}/ship/timetable
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキー。必須 |
railName | string | ◯ | 平均路線。必須。指定できる値は、交通種別がshipとなっている路線のみです。 |
date | int | --- | 時刻表取得日付。省略可。省略時は日付を考慮しない時刻表になります。 Format: YYYYMMDD |
direction | string | --- | 方向。省略可 指定できる値: - true: 上り - false: 下り Default: true |
response
Name | Description |
---|---|
ResultSet | レスポンスの最下部を表す要素 |
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / TimeTable | 時刻表を表す要素 |
ResultSet / TimeTable / Direction | 行き先方面を表す要素 |
ResultSet / TimeTable / Line | 区間 を表す要素 |
ResultSet / TimeTable / Line / trainID | 列車を特定する短期ID ※保存には不向きです |
ResultSet / TimeTable / Line / Name | 名称を表す要素 |
ResultSet / TimeTable / Line / Number | 番号(号、便など)を表す要素 |
ResultSet / TimeTable / Line / ArrivalState | 到着時の状態を表す要素 |
ResultSet / TimeTable / Line / ArrivalState / Datetime | 日時を表す要素 |
ResultSet / TimeTable / Line / ArrivalState / Datetime / operation | 運行日判定 - today: 日時通り - yesterday: 前日 |
ResultSet / TimeTable / Line / DepartureState | 出発時の状態を表す要素 |
ResultSet / TimeTable / Line / DepartureState / Datetime | 日時を表す要素 |
ResultSet / TimeTable / Line / DepartureState / Datetime / operation | 運行日判定 - today: 日時通り - yesterday: 前日 |
ResultSet / TimeTable / Name | 名称を表す要素 |
ResultSet / TimeTable / Name / abbeviation | 略称 |
ResultSet / TimeTable / Station | 駅を表す要素 |
ResultSet / TimeTable / Station / Name | 駅の名称を表す要素 |
example
GET /v1/xml/ship/timetable?key=アクセスキーを入力してください&railName=フェリー(久里浜-金谷)
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<TimeTable>
<Station>
<Name>金谷港</Name>
</Station>
<Line trainID="0">
<Name/>
<Number>1</Number>
<DepartureState>
<Datetime operation="today">06:20:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">06:55:00+09:00</Datetime>
</ArrivalState>
</Line>
<Line trainID="1">
<Name/>
<Number>2</Number>
<DepartureState>
<Datetime operation="today">07:20:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">07:55:00+09:00</Datetime>
</ArrivalState>
</Line>
<Line trainID="2">
<Name/>
<Number>3</Number>
<DepartureState>
<Datetime operation="today">08:20:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">08:55:00+09:00</Datetime>
</ArrivalState>
</Line>
<Line trainID="3">
<Name/>
<Number>4</Number>
<DepartureState>
<Datetime operation="today">09:20:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">09:55:00+09:00</Datetime>
</ArrivalState>
</Line>
<Line trainID="4">
<Name/>
<Number>5</Number>
<DepartureState>
<Datetime operation="today">10:20:00+09:00</Datetime>
</DepartureState>
<ArrivalState>
<Datetime operation="today">10:55:00+09:00</Datetime>
</ArrivalState>
</Line>
<Line>
:
</Line>
<Direction>久里浜港</Direction>
</TimeTable>
</ResultSet>
GET /v1/json/ship/timetable?key=アクセスキーを入力してください&railName=フェリー(久里浜-金谷)
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"TimeTable": {
"Station": {
"Name": "金谷港"
},
"Line": [
{
"trainID": "0",
"Number": "1",
"DepartureState": {
"Datetime": {
"text": "06:20:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "06:55:00+09:00",
"operation": "today"
}
}
},
{
"trainID": "1",
"Number": "2",
"DepartureState": {
"Datetime": {
"text": "07:20:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "07:55:00+09:00",
"operation": "today"
}
}
},
{
"trainID": "2",
"Number": "3",
"DepartureState": {
"Datetime": {
"text": "08:20:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "08:55:00+09:00",
"operation": "today"
}
}
},
{
"trainID": "3",
"Number": "4",
"DepartureState": {
"Datetime": {
"text": "09:20:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "09:55:00+09:00",
"operation": "today"
}
}
},
{
"trainID": "4",
"Number": "5",
"DepartureState": {
"Datetime": {
"text": "10:20:00+09:00",
"operation": "today"
}
},
"ArrivalState": {
"Datetime": {
"text": "10:55:00+09:00",
"operation": "today"
}
}
},
{
:
}
],
"Direction": "久里浜港"
}
}
}