コンテンツにスキップ

ダイヤ改正/運賃改定情報取得

/transport_revision [GET]

基本情報

概要

各公共交通機関のダイヤ改正、及び運賃改定の情報を取得します。
会社IDや路線ID等を用いて、特定の情報に絞り込むことができます。

URL

https://{HOST}/{CID}/v1/transport_revision

出力形式

  • JSON

対応言語

  • ja

出力順

  • データ登録日降順

※弊社で登録した最新の情報から出力されます。
　改正日や反映日順ではありませんのでご注意ください。

パラメータ

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
company 交通機関会社ID 文字列 ピリオド区切りで複数指定できます
link 路線ID 文字列 ピリオド区切りで複数指定できます
type 出力する交通機関 文字列 交通機関タイプより指定 ピリオド区切りで複数指定できます
出力する改正情報の種別を限定したい場合にご利用ください
未指定の場合は全種別で検索されます

指定可能な項目はこちらをご覧ください
revision_type 出力する改正情報 文字列 timetable：ダイヤ改正情報
fare：運賃改定情報		 ピリオド区切りで複数指定できます
未指定の場合は全種別で検索されます
status 改正状況 文字列 planning：改正日未定
scheduled：改正日確定
fixed：改正内容反映済み		 改正日の確定状況で絞り込みが可能です
ピリオド区切りで複数指定できます

・planningおよびscheduledは、各交通機関会社が定める改正日の状況を示します
・fixedは、改正内容がNAVITIME APIに反映されていることを示します
schedule_date_from 改正予定日絞り込み(開始) 文字列(日付)
YYYY-MM-DD
schedule_date_to 改正予定日絞り込み(終了) 文字列(日付)
YYYY-MM-DD
offset データの出力開始位置 数値 0 最小値：0
最大値：2000		 何件目から表示されるか（1件目が0）を指定します
limit データの出力件数 数値 10 最小値：1
最大値：100
all 全件出力 真偽値 false - true：全件出力する
- false：全件出力しない		 limit及びoffsetとの併用は不可

type（交通機関タイプ）

'type' は以下の文字列を取り得ます。

文字列 概要
train 鉄道
ultraexpress_train 鉄道（特急）
superexpress_train 新幹線
local_bus 路線バス
highway_bus 高速バス
shuttle_bus シャトルバス
community_bus コミュニティバス
ferry フェリー
cable_railway ケーブルカー/ロープウェイ

パラメータ構成例

  • 鉄道データで、NAVITIME APIに反映済みの改正情報を検索
/transport_revision?type=train&status=fixed

レスポンス

名称 レスポンス名 型名 配列 説明
検索数 count Countオブジェクト
改正情報 items TransportRevisionオブジェクト 〇

Countオブジェクト

名称 レスポンス名 型名 配列 説明
トータルヒット件数 total 数値 検索ヒットした件数
オフセット値 offset 数値 オフセットが設定されている場合はその値を出力
データの出力件数 limit 数値 データの出力件数に設定されている値
1件しかヒットしなかった場合でも、limit=10でリクエストしている場合は10と出力

TransportRevisionオブジェクト

名称 レスポンス名 型名 配列 説明
対象の交通機関会社情報 company Companyオブジェクト
対象の路線情報 link Linkオブジェクト 路線別の改正情報の場合に出力
交通機関の種別 type 文字列 交通機関タイプのいずれかが入ります
改正情報の種別 revision_type 文字列 timetable：ダイヤ改正情報
fare：運賃改定情報
改正内容の見出し title 文字列 データが存在する場合のみ出力
改正内容 message 文字列 データが存在する場合のみ出力
改正日に関する情報 revision_date RevisionDateオブジェクト

title, messageのテキスト情報について

テキストが長文になる場合、文中に改行を示す <br> タグが出力されるケースがございます。
サービス上で表示する際などにご活用ください。

Companyオブジェクト

名称 レスポンス名 型名 配列 説明
交通機関会社ID id 文字列
交通機関会社の名称 name 文字列
名称 レスポンス名 型名 配列 説明
路線ID id 文字列
路線名称 name 文字列

RevisionDateオブジェクト

名称 レスポンス名 型名 配列 説明
改正予定日 schedule_date 文字列 各交通機関会社が提示する改正予定日
改正状況 status 文字列 planning：改正日未定
scheduled：改正日確定
fixed：改正内容反映済み
APIへの反映日 update_date 文字列 NAVITIME APIへの改正内容反映日

update_dateについて

statusがfixedのほか、scheduledの場合も出力されます。ただし、scheduledの場合、1週間以上先の日付は入りません。
また、対応状況によってはfixedのみしか更新されない場合がございますのでご了承ください。

レスポンス例

{
    "count": {
        "total": 7,
        "offset": 0,
        "limit": 10
    },
    "items": [
        {
            "company": {
                "id": "00000048",
                "name": "広島電鉄"
            },
            "link": {
                "id": "00000345",
                "name": "広島電鉄宮島線"
            },
            "type": "train",
            "revision_type": "fare",
            "title": "2022/11/1 運賃改定",
            "message": "2022/11/1より、運賃改定が実施されます。",
            "revision_date": {
                "schedule_date": "2022-11-01",
                "update_date": "2022-10-24",
                "status": "fixed"
            }
        },
        ・・・
    ]
}