鉄道駅時刻表(旧版)


 Attention!

This page has not been translated into English yet. It is possible that some parts of description may contains old information. Please see Japanese Documents if you need the latest and accurate information.


 Attention!

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

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

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