航海路線時刻表

交通種別がshipの路線から時刻表を取得します。

GET /v1/{format}/ship/timetable

parameters

Name Type 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": "久里浜港"
    }
  }
}