特急列車時刻表


 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.

有料特急、有料急行、新幹線、寝台列車を対象として、運行区間一覧と時刻表を取得します。 利用方法は以下の手順となります。

  1. serviceSectionCodeパラメータを指定せずに運行区間一覧を取得
  2. その一覧の運行区間コードをserviceSectionCodeパラメータに指定して特急列車時刻表を取得
GET /v1/{format}/train/timetable

parameters

Name Type Description
format string レスポンスのデータ形式の指定。必須
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキー。必須
stationName string 駅の名称。stationCodeと排他。省略可。省略時は指定なしとなります。
stationCode string 駅コード。stationNameと排他。省略可。省略時は指定なしとなります。
serviceSectionCode string 運行区間コード。stationName, stationCodeと排他。省略可。省略時は運行区間一覧となります。
number string 号数。serviceSectionCodeと同時に指定して号数で時刻表を絞り込みます。複数指定可。省略可。省略時は指定なしとなります。
date int 一覧取得日付。省略可。
Format: YYYYMMDD
Default: 現在日付

response

Name Description
ResultSet レスポンスの最下部を表す要素
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / max データの全件数。一度に全件取得できない場合は、offsetの指定を繰り上げて取得してください。
ResultSet / Corporation 会社を表す要素
ResultSet / Corporation / index インデックス
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Corporation / Name 会社の名称を表す要素
ResultSet / Line 区間 を表す要素
ResultSet / Line / code 短期的な利用を前提とした列車コード
ResultSet / Line / corporationIndex ResultSet / Corporation / indexと紐づくインデックス
ResultSet / Line / trainID 列車を特定する短期ID
※保存には不向きです
ResultSet / Line / DriveComment 運行に関するコメントを表す要素
ResultSet / Line / GuideComment 列車等に関するコメントを表す要素
ResultSet / Line / Name 名称を表す要素
ResultSet / Line / Name / line_part 列車愛称
ResultSet / Line / Name / type_part 種別名称(新幹線や特急など)
ResultSet / Line / Number 番号(号、便など)を表す要素
ResultSet / Line / ServiceSection 運行区間を表す要素
ResultSet / Line / ServiceSection / arrival 区間終点駅名
ResultSet / Line / ServiceSection / code 運行区間コード
ResultSet / Line / ServiceSection / departure 区間始発駅名
ResultSet / Line / Stop 停車を表す要素
ResultSet / Line / Stop / ArrivalState 到着時の状態を表す要素
ResultSet / Line / Stop / ArrivalState / Datetime 時刻を表す要素。
Format: hh:mm:ss+09:00
ResultSet / Line / Stop / ArrivalState / Datetime / operation 運行日判定
- today: 日時通り
- yesterday: 前日
ResultSet / Line / Stop / DepartureState 出発時の状態を表す要素
ResultSet / Line / Stop / DepartureState / Datetime 時刻を表す要素。
Format: hh:mm:ss+09:00
ResultSet / Line / Stop / DepartureState / Datetime / operation 運行日判定
- today: 日時通り
- yesterday: 前日
ResultSet / Line / Stop / Point 地点 を表す要素
ResultSet / Line / Stop / Point / getOff 降車可能フラグ
- true: 可能
- false: 不可能
ResultSet / Line / Stop / Point / getOn 乗車可能フラグ
- true: 可能
- false: 不可能
ResultSet / Line / Stop / Point / Prefecture 都道府県を表す要素
ResultSet / Line / Stop / Point / Prefecture / code 都道府県コード
ResultSet / Line / Stop / Point / Prefecture / Name 都道府県の名称を表す要素
ResultSet / Line / Stop / Point / Station を表す要素
ResultSet / Line / Stop / Point / Station / code 駅コード
ResultSet / Line / Stop / Point / Station / Name 駅の名称を表す要素

example

運行区間一覧の取得

GET /v1/xml/train/timetable?key=アクセスキーを入力してください&stationCode=22828
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a" max="24">
  <Line>
    <Name>Maxたにがわ</Name>
    <ServiceSection code="110:0" departure="東京" arrival="ガーラ湯沢">東京-ガーラ湯沢</ServiceSection>
    <ServiceSection code="110:1" departure="ガーラ湯沢" arrival="東京">ガーラ湯沢-東京</ServiceSection>
  </Line>
  <Line>
    <Name>Maxとき</Name>
    <ServiceSection code="59:0" departure="東京" arrival="新潟">東京-新潟</ServiceSection>
    <ServiceSection code="59:1" departure="新潟" arrival="東京">新潟-東京</ServiceSection>
  </Line>
  <Line>
    <Name>あさま</Name>
    <ServiceSection code="113:0" departure="長野" arrival="東京">長野-東京</ServiceSection>
    <ServiceSection code="113:1" departure="東京" arrival="長野">東京-長野</ServiceSection>
  </Line>
  <Line>
    <Name>あやめ</Name>
    <ServiceSection code="13:0" departure="銚子" arrival="東京">銚子-東京</ServiceSection>
    <ServiceSection code="13:1" departure="鹿島神宮" arrival="東京">鹿島神宮-東京</ServiceSection>
    <ServiceSection code="13:2" departure="東京" arrival="鹿島神宮">東京-鹿島神宮</ServiceSection>
    <ServiceSection code="13:3" departure="東京" arrival="銚子">東京-銚子</ServiceSection>
  </Line>
  <Line>
    <Name>かいじ</Name>
    <ServiceSection code="51:0" departure="東京" arrival="竜王">東京-竜王</ServiceSection>
    <ServiceSection code="51:1" departure="竜王" arrival="東京">竜王-東京</ServiceSection>
  </Line>
  <Line>
  :
  </Line>
</ResultSet>
GET /v1/json/train/timetable?key=アクセスキーを入力してください&stationCode=22828
{
  "ResultSet": {
    "apiVersion": "1.14.0.0",
    "engineVersion": "201404_01a",
    "max": "24",
    "Line": [
      {
        "Name": "Maxたにがわ",
        "ServiceSection": [
          {
            "text": "東京-ガーラ湯沢",
            "code": "110:0",
            "departure": "東京",
            "arrival": "ガーラ湯沢"
          },
          {
            "text": "ガーラ湯沢-東京",
            "code": "110:1",
            "departure": "ガーラ湯沢",
            "arrival": "東京"
          }
        ]
      },
      {
        "Name": "Maxとき",
        "ServiceSection": [
          {
            "text": "東京-新潟",
            "code": "59:0",
            "departure": "東京",
            "arrival": "新潟"
          },
          {
            "text": "新潟-東京",
            "code": "59:1",
            "departure": "新潟",
            "arrival": "東京"
          }
        ]
      },
      {
        "Name": "あさま",
        "ServiceSection": [
          {
            "text": "長野-東京",
            "code": "113:0",
            "departure": "長野",
            "arrival": "東京"
          },
          {
            "text": "東京-長野",
            "code": "113:1",
            "departure": "東京",
            "arrival": "長野"
          }
        ]
      },
      {
        "Name": "あやめ",
        "ServiceSection": [
          {
            "text": "銚子-東京",
            "code": "13:0",
            "departure": "銚子",
            "arrival": "東京"
          },
          {
            "text": "鹿島神宮-東京",
            "code": "13:1",
            "departure": "鹿島神宮",
            "arrival": "東京"
          },
          {
            "text": "東京-鹿島神宮",
            "code": "13:2",
            "departure": "東京",
            "arrival": "鹿島神宮"
          },
          {
            "text": "東京-銚子",
            "code": "13:3",
            "departure": "東京",
            "arrival": "銚子"
          }
        ]
      },
      {
        "Name": "かいじ",
        "ServiceSection": [
          {
            "text": "東京-竜王",
            "code": "51:0",
            "departure": "東京",
            "arrival": "竜王"
          },
          {
            "text": "竜王-東京",
            "code": "51:1",
            "departure": "竜王",
            "arrival": "東京"
          }
        ]
      },
      {
        :
      }
    ]
  }
}

特急列車時刻表の取得

GET /v1/xml/train/timetable?key=アクセスキーを入力してください&serviceSectionCode=59:1
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a" max="19">
  <Line corporationIndex="1" trainID="300C" code="51292">
    <Name type_part="新幹線" line_part="Maxとき">新幹線 Maxとき300号</Name>
    <Number>300</Number>
    <DriveComment>平日運転・2014年3月15日から有効</DriveComment>
    <GuideComment>全車禁煙。普通車全車自由席。オール2階建て8両編成で運転。</GuideComment>
    <Stop>
      <Point getOn="True" getOff="False">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="24033">
          <Name>新潟</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">06:05:00+09:00</Datetime>
      </DepartureState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="24016">
          <Name>燕三条</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">06:17:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">06:16:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="24029">
          <Name>長岡</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">06:28:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">06:27:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="10">
          <Name>群馬県</Name>
        </Prefecture>
        <Station code="21913">
          <Name>高崎</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">07:13:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">07:11:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="11">
          <Name>埼玉県</Name>
        </Prefecture>
        <Station code="22029">
          <Name>熊谷</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">07:31:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">07:30:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
    :
    </Stop>
  </Line>
  <Line corporationIndex="1" trainID="302C" code="51361">
    <Name type_part="新幹線" line_part="Maxとき">新幹線 Maxとき302号</Name>
    <Number>302</Number>
    <DriveComment>毎日運転・2014年3月15日から有効</DriveComment>
    <GuideComment>全車禁煙。オール2階建て16両編成で運転。</GuideComment>
    <Stop>
      <Point getOn="True" getOff="False">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="24033">
          <Name>新潟</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">06:29:00+09:00</Datetime>
      </DepartureState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="24016">
          <Name>燕三条</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">06:42:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">06:41:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="24029">
          <Name>長岡</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">06:53:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">06:52:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="23913">
          <Name>浦佐</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">07:07:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">07:06:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
      <Point getOn="True" getOff="True">
        <Prefecture code="15">
          <Name>新潟県</Name>
        </Prefecture>
        <Station code="23938">
          <Name>越後湯沢</Name>
        </Station>
      </Point>
      <DepartureState>
        <Datetime operation="today">07:20:00+09:00</Datetime>
      </DepartureState>
      <ArrivalState>
        <Datetime operation="today">07:19:00+09:00</Datetime>
      </ArrivalState>
    </Stop>
    <Stop>
    :
    </Stop>
  </Line>
  <Line>
  :
  </Line>
  <Corporation index="1">
    <Name>JR</Name>
  </Corporation>
</ResultSet>
GET /v1/json/train/timetable?key=アクセスキーを入力してください&serviceSectionCode=59:1
{
  "ResultSet": {
    "apiVersion": "1.14.0.0",
    "engineVersion": "201404_01a",
    "max": "19",
    "Line": [
      {
        "corporationIndex": "1",
        "trainID": "300C",
        "code": "51292",
        "Name": {
          "text": "新幹線 Maxとき300号",
          "type_part": "新幹線",
          "line_part": "Maxとき"
        },
        "Number": "300",
        "DriveComment": "平日運転・2014年3月15日から有効",
        "GuideComment": "全車禁煙。普通車全車自由席。オール2階建て8両編成で運転。",
        "Stop": [
          {
            "Point": {
              "getOn": "True",
              "getOff": "False",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "24033",
                "Name": "新潟"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "06:05:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "24016",
                "Name": "燕三条"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "06:17:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "06:16:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "24029",
                "Name": "長岡"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "06:28:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "06:27:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "10",
                "Name": "群馬県"
              },
              "Station": {
                "code": "21913",
                "Name": "高崎"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "07:13:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "07:11:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "11",
                "Name": "埼玉県"
              },
              "Station": {
                "code": "22029",
                "Name": "熊谷"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "07:31:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "07:30:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            :
          }
        ]
      },
      {
        "corporationIndex": "1",
        "trainID": "302C",
        "code": "51361",
        "Name": {
          "text": "新幹線 Maxとき302号",
          "type_part": "新幹線",
          "line_part": "Maxとき"
        },
        "Number": "302",
        "DriveComment": "毎日運転・2014年3月15日から有効",
        "GuideComment": "全車禁煙。オール2階建て16両編成で運転。",
        "Stop": [
          {
            "Point": {
              "getOn": "True",
              "getOff": "False",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "24033",
                "Name": "新潟"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "06:29:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "24016",
                "Name": "燕三条"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "06:42:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "06:41:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "24029",
                "Name": "長岡"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "06:53:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "06:52:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "23913",
                "Name": "浦佐"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "07:07:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "07:06:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            "Point": {
              "getOn": "True",
              "getOff": "True",
              "Prefecture": {
                "code": "15",
                "Name": "新潟県"
              },
              "Station": {
                "code": "23938",
                "Name": "越後湯沢"
              }
            },
            "DepartureState": {
              "Datetime": {
                "text": "07:20:00+09:00",
                "operation": "today"
              }
            },
            "ArrivalState": {
              "Datetime": {
                "text": "07:19:00+09:00",
                "operation": "today"
              }
            }
          },
          {
            :
          }
        ]
      },
      {
        :
      }
    ],
    "Corporation": {
      "Name": "JR"
    }
  }
}