鉄道駅時刻表(旧版)

Attention!

より機能を拡張した鉄道駅時刻表を公開しました。鉄道駅時刻表(旧版)は互換性維持のために提供を続けておりますが、これから開発を始められる方は鉄道駅時刻表をご利用いただくことを推奨します。

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

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