鉄道駅時刻表

鉄道駅の時刻表を取得します。 利用方法は以下の手順となります。

  1. codeを指定せずに方面別一覧を取得
  2. 時刻表を取得したい方面のコードを指定して、鉄道駅時刻表を取得
GET /v1/{format}/station/timetable

parameters

Name Type 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"
      }
    }
  }
}