---
# System prepended metadata

title: GTFSリアルタイム国内標準仕様

---

# GTFSリアルタイム国内標準仕様

## 本仕様の位置づけ

本仕様書は、[GTFS Realtimeの国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/)の基本的な情報に、国内向けの追加事項および解説を加えたものである。

本仕様書は、GTFS Realtimeデータを生成するシステムの開発者を主な対象読者として作成されたものである。併せて、データ生成システムを利用する交通事業者・自治体、データ利用システムの開発者の参考になる内容としている。


## 本仕様の規定方法

### 必須区分

各フィールドに対する以下の必須区分を、message表中の「**必須**」列に記載する。

★Scheduleと整合した定義未了

* 必須
* 条件付必須
* 条件付禁止
* 推奨
* 任意

#### 国内向けの区分変更

* 必須区分は国際標準をベースにしている。

* Google、国内経路検索サービス、デジタルサイネージ、データ分析における、利用状況や有用性を鑑みて、国内向けに区分を変更しているものについては、「必須」列において**太字**で表記している。

★太字ではなく[JP]のほうが良いか？
★★付録か参考資料で新旧表はつけておく

### Google利用項目

各フィールドに対して、Googleに利用される項目（2025年x月x日版）を、以下の通りmessage表中の「**Google**」列に記載する。

★Google調査は9月26日まで依頼中

* 必須：TripUpdate, VehiclePosition, Alertのそれぞれを利用する際に設定が必須な項目
* 利用：Googleに利用される項目

なお、Googleにおいて無視される公式仕様、異なって解釈されるフィールドについては、[こちらのページ](https://developers.google.com/transit/gtfs-realtime/reference?hl=ja)に記載されている。

### 説明

GTFS Realtime全般、各message、各フィールドの説明に以下の内容を記載する。各フィールドについてはmessage表中の「**説明**」列に記載する。

#### 必須・禁止条件

* 必須区分が「条件付必須」または「条件付禁止」の場合の条件について記載。

#### 仕様・推奨

* 仕様：必ず守るべき事項。「○○を設定する」「○○すること」「○○してはならない」と表記。

* 推奨：守ることが望ましい事項。「○○望ましい」と表記。

仕様および推奨には、「○○の場合」などの表記により、条件が設定されている場合がある。

#### 国内向け追加事項

* 国内向けの追加事項については[JP]と記載。その他は国際標準に準じている。

#### 補足

* 注意事項：設定方法について注意を要する事項。「【注意事項】」と表記。
* 参考情報：設定方法についての参考情報。「【参考情報】」と表記。
* 理由：仕様・推奨事項の設定理由。「○○のため」などと表記。

### 国内向け設定方法

国内向けの設定方法についてはmessage表中の「**JP設定方法**」列に記載する。

記載方法については、説明の「仕様・推奨事項」「補足」と同様である。

★この列は説明欄に統合したほうが良いか？

### 実験的項目

正式に仕様に採用されていないmessageおよびフィールドについては「実験的」と表記している。フィールド名の冒頭に【実験的】と表記している。実験的messageの仕様は国際標準仕様を参照すること。

★リンク設定未了

基本的には国際標準と同一である。ただし、ModifiedTripSelectorについては、国際標準において実験的であるTripModificationsと併せて利用することから、実験的項目に加えている。

## 本仕様への準拠方法

* GTFS-JP Realtimeに準拠したデータ生成システム（バスロケーションシステム等）の、製品仕様、発注仕様等においては、GTFS Realtimeの主要3message（TripUpdate、VehiclePosition、Alert）のどれに準拠しているかを記載すること。

* * 例：「GTFS-JP Realtime TripUpdate・VehiclePosition準拠」「GTFS-JP Realtime Alert準拠」
* 準拠しているかどうかの基準は、必須区分の「必須」「条件付必須」「条件付禁止」、説明と国内向け設定方法における「仕様」を全て満たしていることである。
* 準拠できていない項目がある場合は、その項目を記載すること。

## GTFS Realtime全般の設定方法

### データ更新のリードタイム[JP]

* 車載器における測位や発着判定から、GTFS Realtime提供までのリードタイムは、通信時間を除き20秒以内とすること。
* 上記を実現するため、各段階のデータ更新を以下のように行うこと。
  * GTFS Realtimeのデータ更新間隔は、15秒以内とすること。
  * オープンデータ配信サービス、CDN（Content Delivery Network）等における、キャッシングのリードタイムは最低限とし、最大でも5秒以内にデータを更新すること。
  * ★図があると良い
    * 車載器→バスロケサーバ→GTFS生成・配信サーバ【15秒以内】→（キャッシュサーバ【5秒以内】→）【ここまで20秒以内】→情報提供サーバ→情報提供端末→公共交通利用者

* 上記は最低限の既定であり、より短いリードタイムであることが望ましい。

### バスロケーションシステムから提供すべき情報[JP]

* バスロケーションシステムからは、TripUpdateとVehiclePositionの両方を提供すること。
  * Google等の一部サービスにおいてはTripUpdateとVehiclePositionのどちらかのみを利用することがあるが、デジタルサイネージや地図表示等による汎用的な利用を可能にするため。
* 運行トラブルや運休等の予告情報を扱っている場合は、Alertも提供することが望ましい。

## messageの一覧

### messageの構成

★リンク設定未了

* [FeedMessage](#message-feedmessage)
    * FeedHeader
    * FeedEntity
        * TripUpdate
            * TripDescriptor
            * VehicleDescriptor
            * StopTimeUpdate
                * StopTimeEvent
                * 【実験的】[StopTimeProperties](https://gtfs.org/ja/documentation/realtime/reference/#message-stoptimeproperties)
            * 【実験的】TripProperties
        * VehiclePosition
            * TripDescriptor
                * ModifiedTripSelector
            * VehicleDescriptor
            * Position
            * 【実験的】CarriageDetails
        * Alert
            * TimeRange
            * EntitySelector
                * TripDescriptor
            * 【実験的】TranslatedImage
            * TranslatedString
        * 【実験的】Shape
        * 【実験的】Stop
        * 【実験的】TripModifications
            * 【実験的】SelectedTrips
            * 【実験的】Modification
                * 【実験的】StopSelector
                * 【実験的】ReplacementStop

### ER図

★ER図未了

## 各messageの国内仕様

実験的message以外について記載する。実験的messageの詳細は[国際標準](https://gtfs.org/documentation/realtime/reference/#element-index)を参照。

### _message_ FeedMessage

フィード。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-feedmessage)）

| _**フィールド名**_ | _**データ型**_                     | _**必須**_ | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ------------------ | --------------------------------- | ---------- | ------------------------------------------------------------ | ------------------ | ------------------ | ------------------ |
| **header**         | [FeedHeader](#message-feedheader) | 必須       |           | 1          | このフィードに関するメタデータ。            |                    |
| **entity**         | [FeedEntity](#message-feedentity) | 条件付必須 |        | 複数       | フィードの内容。<br />内容がある場合は**必須**。 |                    |

### _message_ FeedHeader

フィードに関するメタデータ。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-feedheader)）

| _**フィールド名**_        | _**データ型**_                                                | _**必須**_ | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_       |
| ------------------------- | ------------------------------------------------------------ | ---------- | ------------------------------------------------------------ | ------------------------ | ------------------------ | ------------------------ |
| **gtfs_realtime_version** | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 必須       |           | 1          | フィード仕様のバージョン。      | "2.0"を設定する。 |
| **incrementality**        | [Incrementality](https://gtfs.org/ja/documentation/realtime/reference/#enum-incrementality)                       | 必須       |           | 1          | 差分更新かどうか。 | FULL_DATASETを設定する。 |
| **timestamp**             | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | 必須       |           | 1          | このフィードの内容が作成された日時。 |                          |
| **feed_version**          | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意       |           | 1          | ベースとなるGTFS Scheduleの `feed_info.feed_version` に一致する文字列。 |                          |

### _message_ FeedEntity

フィード内のエンティティ。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-feedentity)）

| _**フィールド名**_                     | _**データ型**_                                               | _**必須**_ | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| -------------------------------------- | ------------------------------------------------------------ | ---------- | ------ | ---------- | ------------------------------------------------------------ | ---------------- |
| **id**                                 | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 必須       |        | 1          | このエンティティのフィード固有の識別子。                     |                  |
| **is_deleted**                         | [bool](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意       |        | 1          | このエンティティを削除するかどうか。                         |                  |
| **trip_update**                        | [TripUpdate](#message-tripupdate)                            | 条件付必須 |        | 1          | 便の出発遅延に関するリアルタイムのデータ。※                  |                  |
| **vehicle**                            | [VehiclePosition](#message-vehicleposition)                  | 条件付必須 |        | 1          | 車両の位置情報に関するデータ。※                              |                  |
| **alert**                              | [Alert](#message-alert)                                      | 条件付必須 |        | 1          | リアルタイム アラートに関するデータ。※                       |                  |
| 【実験的】<br />**shape**              | [Shape](#message-shape)                                      | 条件付必須 |        | 1          | 迂回路などのリアルタイムで追加されたルート形状に関するデータ。※ |                  |
| 【実験的】<br />**stop**               | [Stop](#message-stop)                                        | 条件付必須 |        | 1          | 追加する停留所のデータ。※                                    |                  |
| 【実験的】<br />**trip_modifications** | [TripModifications](#message-tripmodifications)              | 条件付必須 |        | 1          | 迂回などの特定の変更によって影響を受ける旅行のリスト。※      |                  |

※：trip_update、vehicle、alert、shape、stop、trip_modifications のフィールドのうち、少なくとも 1つは**必須**。

#### TripUpdate, VehiclePositionは必要十分な便の情報のみを設定する[JP]

* 全便のTripUpdateおよびVehiclePositionを全時間帯のフィードに設定すると、ファイル容量が肥大化し、通信のタイムラグや処理負荷の問題が生じる可能性があるため、運行中および運行前後の便について必要十分な情報を設定する。
* 具体的には以下のように設定する。

| タイミング | 対象            | JP設定方法                                                   |
| ---------- | --------------- | ------------------------------------------------------------ |
| 運行開始時 | TripUpdate      | 起点における客扱い開始時、または前の運行等を踏まえた時刻予測を行う場合は予測が判明した時点から設定することが望ましい。 |
|            | VehiclePosition | 起点における客扱い開始時から設定することが望ましい。<br />出発前はcurrent_statusをSTOPPED_ATにすること。 |
| 運行終了時 | TripUpdate      | 終点到着1分後まで設定することが望ましい。<br />終点到着後は、TripUpdate内のarrivalの値を更新すること。 |
|            | VehiclePosition | 終点到着1分後まで設定することが望ましい。<br />終点到着後は、VehiclePositionのcurrent_statusをSTOPPED_ATに設定すること。 |

### _message_ TripUpdate

tripの更新情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-tripupdate)）

| _**フィールド名**_                  | _**データ型**_                                               | _**必須**_     | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ----------------------------------- | ------------------------------------------------------------ | -------------- | ------ | ---------- | ------------------------------------------------------------ | ---------------- |
| **trip**                            | [TripDescriptor](#message-tripdescriptor)                    | 必須           |        | 1          | 対象trip。                                                   |                  |
| **vehicle**                         | [VehicleDescriptor](#message-vehicledescriptor)              | 任意           |        | 1          | 車両に関する追加情報。                                       |                  |
| **stop_time_update**                | [StopTimeUpdate](#message-stoptimeupdate)                    | 条件付必須     |        | 多数       | StopTimesの更新。<br /><br />将来の予測と、場合によっては過去の停止時刻（すでに発生したもの）の両方を設定可能。<br /><br />trip.schedule_relationship が SCHEDULEDまたは UNSCHEDULED の場合、以下の1～3の通り設定する。[JP]<br />1. 少なくとも現在地の値を設定は**必須**。現在地とは、運行前の場合は始発地、停車中の場合はその地点、走行中または運行後の場合は最後に通過した地点である。<br />2. 将来（現在の後から終点まで）の値は、予測時刻がある場合等は**必須**。予測時刻が無い場合は**不要**。<br />3. 過去（起点から現在の前まで）の値は、設定することが望ましい。<br /><br />trip.schedule_relationship が `NEW` または `REPLACEMENT` の場合、起終点間の全ての値の設定が**必須**。<br /><br />trip.schedule_relationship が `CANCELED` または `DELETED` の場合、**不要**。 |                  |
| **timestamp**                       | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | **条件付必須** |        | 1          | StopTimesの更新日時。<br />（将来の StopTimes を予測するために車両のリアルタイムの進行状況が測定された日時）<br /><br />将来の時刻予測を行っている場合は**必須**。[JP]<br /><br />delayを設定している場合はtimestampも設定することが**望ましい**。 |                  |
| 【実験的】<br />**delay**           | [int32](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意           |        | 1          | 便の現在の遅延時間（秒単位）。                               |                  |
| 【実験的】<br />**trip_properties** | [TripProperties](#message-tripproperties)                    | 任意           |        | 1          | GTFS Scheduleのtripの更新情報。                              |                  |

### _message_ StopTimeUpdate

trip内のstop_timeの更新情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-stoptimeupdate)）

| _**フィールド名**_                             | _**データ型**_                                               | _**必須**_ | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ---------------------------------------------- | ------------------------------------------------------------ | ---------- | ------ | ---------- | ------------------------------------------------------------ | ---------------- |
| **stop_sequence**                              | [uint32](https://protobuf.dev/programming-guides/proto2/#scalar) | **必須**   |        | 1          | 停車順。<br /><br />必須。（同一stop_idに複数回通過する場合も正確に解釈できるようにするため）[JP] |                  |
| **stop_id**                                    | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 駅・停留所のID。<br /><br />`TripUpdate.schedule_relationship` が `NEW` または `REPLACEMENT` の場合は**必須**。<br />`StopTimeProperties.assigned_stop_id`を設定している場合、`stop_id`は省略するか、assigned_stop_idと一致させる。 |                  |
| **arrival**                                    | [StopTimeEvent](#message-stoptimeevent)                      | 条件付必須 |        | 1          | 到着時刻更新情報。<br /><br />schedule_relationship が SKIPPED以外の場合、arrivalとdepartureは共に**必須**。（片方だけ設定した場合、未設定な方の取扱いが不明確になるため）[JP]<br /><br />schedule_relationship が SKIPPED の場合、arrival と departure の両方を空にしてもよい。 |                  |
| **departure**                                  | [StopTimeEvent](#message-stoptimeevent)                      | 条件付必須 |        | 1          | 出発時刻更新情報。<br /><br />必須条件はarrivalと同様。      |                  |
| 【実験的】<br />**departure_occupancy_status** | [OccupancyStatus](https://gtfs.org/ja/documentation/realtime/reference/#enum-occupancystatus)                     | 任意       |        | 1          | 指定された停留所から出発した直後の車両の乗客の占有状況の予測。 |                  |
| **schedule_relationship**                      | [ScheduleRelationship](https://gtfs.org/ja/documentation/realtime/reference/#enum-schedulerelationship)           | 任意       |        | 1          | 停車予定との関係。                                           |                  |
| 【実験的】<br />**stop_time_properties**       | [StopTimeProperties](#message-stoptimeproperties)            | 任意       |        | 1          | stop_timeの属性の更新情報。                                  |                  |

### _message_ StopTimeEvent

到着または出発ごとの時刻更新情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-stoptimeevent)）

| _**フィールド名**_ | _**データ型**_                                               | _**必須**_     | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_                                             |
| ------------------ | ------------------------------------------------------------ | -------------- | ------ | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| **delay**          | [int32](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須     |        | 1          | 当該停留所における遅延時間（秒単位）。<br><br />当該停留所の実績値または予測値が不明な場合（[StopTimeUpdate.schedule_relationship ](https://gtfs.org/ja/documentation/realtime/reference/#enum-schedulerelationship)がNO_DATAの場合）を除き、**必須**。[JP] | 分単位などの丸め処理（例：143秒を120秒にする）や、一定時間未満の切り捨て（例：1分未満を0秒にする）を行わず、正確な秒数を設定すること。 |
| **time**           | [int64](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須     |        | 1          | 推定または実際のイベントの日時。<br /><br />当該停留所の実績値または予測値が不明な場合（[StopTimeUpdate.schedule_relationship ](https://gtfs.org/ja/documentation/realtime/reference/#enum-schedulerelationship)がNO_DATAの場合）を除き、**必須**。[JP] | delayと整合させるため、stop_times.arrival_time(departure_time)にdelayを加えた値を設定する。 |
| **scheduled_time** | [int64](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付禁止     |        | 1          | スケジュールされた日時。<br /><br />TripUpdateが `NEW`、`REPLACEMENT`、または`DUPLICATED` の場合は**任意**。それ以外の場合は**禁止**。 |                                                              |
| **uncertainty**    | [int32](https://protobuf.dev/programming-guides/proto2/#scalar) | **条件付必須** |        | 1          | 不確実性（秒単位）。<br />【注意事項】分単位等にしないこと。<br /><br />StopTimeUpdateが NO_DATA の場合は**禁止**。<br /><br />StopTimeUpdateが NO_DATA以外の場合は**必須**。（通済済かどうか判定しやすくするため）[JP] | 通過済の停留所に対しては、確実な値とみなし、0を設定する。[JP]<br /><br />未通過の停留所に対しては、時刻予測を行っている場合は正の値を設定する。[JP] |

### _message_ VehiclePosition

車両の位置情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-vehicleposition)）

| _**フィールド名**_                         | _**データ型**_                                               | _**必須**_     | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_                                             |
| ------------------------------------------ | ------------------------------------------------------------ | -------------- | ------ | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| **trip**                                   | [TripDescriptor](#message-tripdescriptor)                    | **条件付必須** |        | 1          | この車両に該当する便。<br /><br />臨時便等でtrip_idを特定できない場合を除き、**必須**。（便に紐づけて解釈できるようにするため）[JP] |                                                              |
| **vehicle**                                | [VehicleDescriptor](#message-vehicledescriptor)              | 任意           |        | 1          | 車両の識別情報。<br /><br />                                 |                                                              |
| **position**                               | [Position](#message-position)                                | **条件付必須** |        | 1          | 車両の位置情報。<br /><br />位置情報が不明な場合等を除き、**必須**。（地図表示等を行えるようにするため）[JP] |                                                              |
| **current_stop_sequence**                  | [uint32](https://protobuf.dev/programming-guides/proto2/#scalar) | **条件付必須** |        | 1          | 現在地のstop_sequence。<br /><br />臨時便等でtrip_idを特定できない場合を除き、**必須**。（複数回同一のstopを通過する場合に解釈できるようにするため）[JP] | 【注意事項】current_status がSTOPPED_ATの場合は、停車中のstopを設定する。IN_TRANSIT_TO、INCOMMING_ATの場合は、次に停車するstopを設定する。 |
| **stop_id**                                | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意           |        | 1          | 現在地のstop_id。                                            |                                                              |
| **current_status**                         | [VehicleStopStatus](https://gtfs.org/ja/documentation/realtime/reference/#enum-vehiclestopstatus)                 | 任意           |        | 1          | 現在の停止に関する車両の状態。<br /><br />未設定の場合、IN_TRANSIT_TO とみなされる。 |                                                              |
| **timestamp**                              | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | **必須**       |        | 1          | 車両の位置が測定された日時。<br /><br />必須。（車両毎のリアルタイム性を正しく解釈できるようにするため）[JP] | 【注意事項】フィードの生成日時（FeedHeader.timestamp）ではなく、車両における測定時刻を設定すること。 |
| **congestion_level**                       | [CongestionLevel](https://gtfs.org/ja/documentation/realtime/reference/#enum-congestionlevel)                     | 任意           |        | 1          | 運行に影響を与える道路の混雑レベル。                         |                                                              |
| 【実験的】<br />**occupancy_status**<br /> | [OccupancyStatus](https://gtfs.org/ja/documentation/realtime/reference/#enum-occupancystatus)                     | 任意           |        | 1          | 車両または客車の乗客の混雑状態。<br /><br />【参考情報】実験的フィールドだが、[国交省の混雑情報ガイドライン](https://www.mlit.go.jp/report/press/content/001367445.pdf)にて方法が提示され、バスロケやGoogleで使われている。 |                                                              |
| 【実験的】<br />**occupancy_percentage**   | [uint32](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意           |        | 1          | 混雑率（%）。                                                |                                                              |
| 【実験的】<br />**multi_carriage_details** | [CarriageDetails](#message-carriagedetails)                  | 任意           |        | 多数       | 号車ごとの詳細。                                             |                                                              |

### _message_ Alert

何らかの運行トラブルに関する告知。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-alert)）

| _**フィールド名**_                         | _**データ型**_                                 | _**必須**_            | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ------------------------------------------ | --------------------------------------------- | --------------------- | ---------- | ------------------------------------------------------------ | ------------------ | ------------------ |
| **active_period**                          | [TimeRange](#message-timerange)               | **条件付必須**        |    | 複数       | 表示期間。<br /><br />表示期間を限定する場合は**必須**。（期間を明確にするため）[JP]<br /><br />未設定の場合、全期間で表示される。 |                    |
| **informed_entity**                        | [EntitySelector](#message-entityselector)     | 必須                  |  | 複数       | 表示対象のエンティティ。 |                    |
| **cause**                                  | [Cause](https://gtfs.org/ja/documentation/realtime/reference/#enum-cause)                          | **必須** |       | 1          | 原因。<br /><br />必須。（原因を明確にするため）[JP] |  |
| 【実験的】<br />**cause_detail**           | [TranslatedString](#message-translatedstring) | 任意                  |           | 1          | 原因の詳細。 |                    |
| **effect**                                 | [Effect](https://gtfs.org/ja/documentation/realtime/reference/#enum-effect)                        | **必須** |        | 1          | 影響。<br /><br />必須。（影響を明確にするため）[JP] |  |
| 【実験的】<br />**effect_detail**          | [TranslatedString](#message-translatedstring) | 任意                  |           | 1          | 影響の詳細。 |                    |
| **url**                                    | [TranslatedString](#message-translatedstring) | 任意                  |         | 1          | 追加情報のURL。                     |                    |
| **header_text**                            | [TranslatedString](#message-translatedstring) | 必須                  |        | 1          | ヘッダー。 |                    |
| **description_text**                       | [TranslatedString](#message-translatedstring) | 必須                  |        | 1          | 説明。 |                    |
| **tts_header_text**                        | [TranslatedString](#message-translatedstring) | 任意                  |           | 1          | 音声合成用のヘッダー。 |                    |
| **tts_description_text**                   | [TranslatedString](#message-translatedstring) | 任意                  |           | 1          | 音声合成用の説明。 |                    |
| 【実験的】<br />**severity_level**        | [SeverityLevel](https://gtfs.org/ja/documentation/realtime/reference/#enum-severitylevel)          | 任意                  |           | 1          | 重大度。                                           |                    |
| 【実験的】<br />**image**                  | [TranslatedImage](#message-translatedimage)   | 任意                  |           | 1          | 説明用画像。 |                    |
| 【実験的】<br />**image_alternative_text** | [TranslatedString](#message-translatedstring) | 任意                  |           | 1          | 説明用画像の代替テキスト。 |                    |



#### 運行トラブル以外の告知

* 割引切符、運賃システム変更予告等、その他直近の運行・乗車に影響のない告知については、同時表示数が1つ以下になるように設定することが望ましい。
* 運行に直接影響が無く、緊急性が低い情報を多数登録すると、重要な情報が画面上で埋もれる可能性があるため。

#### 【注意事項】予定情報の入れ方

* 未来の運休の予告を行う場合は、active_periodを分けた当日と予告の2つのAlertを作成する。
* effectにNO_SERVICEを設定すると、GoogleMaps等にて便の存在自体が一切表示されなくなることに留意。未確定な運休・減便見込みについては、REDUCED_SERVICEを設定する。

### _message_ TimeRange

期間。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-timerange)）

| _**フィールド名**_ | _**データ型**_                                                | _**必須**_ | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ------------------ | ------------------------------------------------------------ | ---------- | ---------- | ------------------------------------------------------------ | ------------------ | ------------------ |
| **start**          | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 開始日時。<br /><br />start または end のいずれかは**必須**。 |                    |
| **end**            | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 終了日時。<br /><br />start または end のいずれかは**必須**。 |                    |

### _message_ Position

車両の地理的情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-position)）

| _**フィールド名**_ | _**データ型**_                                                | _**必須**_ | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ------------------ | ------------------------------------------------------------ | ---------- | ---------- | ------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| **latitude**       | [float](https://protobuf.dev/programming-guides/proto2/#scalar) | 必須       |     | 1          | WGS-84 座標系での北緯。                                      |                    |
| **longitude**      | [float](https://protobuf.dev/programming-guides/proto2/#scalar) | 必須       |        | 1          | WGS-84 座標系での東経。                                      |                    |
| **bearing**        | [float](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意       |           | 1          | 真北から時計回りの度数で表した方位。 |                    |
| **odometer**       | [double](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意       |           | 1          | 走行距離計の値 (メートル単位)。                              |                    |
| **speed**          | [float](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意       |           | 1          | 車両によって測定された瞬間速度 (メートル/秒単位)。           |                    |

### _message_ TripDescriptor

tripの識別情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-trpdescriptor)）

| _**フィールド名**_                | _**データ型**_                                               | _**必須**_ | JP推奨 | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| --------------------------------- | ------------------------------------------------------------ | ---------- | ------ | ---------- | ------------------------------------------------------------ | ---------------- |
| **trip_id**                       | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | **必須**   | ◎      | 1          | 対象のtrip_id。<br /><br />**必須**。（tripの識別を容易にするため）[JP] |                  |
| **route_id**                      | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 対象のroute_id。<br /><br />trip_idが未設定の場合は**必須**。 |                  |
| 【実験的】<br />**direction_id**  | [uint32](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 対象のdirection_id。<br /><br />trip_idが未設定の場合は**必須**。 |                  |
| **start_time**                    | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 対象の開始時刻。<br /><br />trip_idが未設定の場合は必須。<br /><br />trip_idがGTFS frequencies.txtで定義されている場合は**必須**。 |                  |
| **start_date**                    | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |        | 1          | 対象の開始日。<br /><br />trip_idが未設定の場合は必須。<br /><br /><br />便が 24 時間以上続く場合、または翌日の予定便と重なるように遅れる場合は、**必須**。<br /><br />trip_idがGTFS frequencies.txtで定義されている場合は**必須**。 |                  |
| **schedule_relationship**         | [ScheduleRelationship](https://gtfs.org/ja/documentation/realtime/reference/#enum-schedulerelationship_1)         | 任意       | ◎      | 1          | 運行予定との関係。                                           |                  |
| 【実験的】<br />**modified_trip** | [ModifiedTripSelector](#message-modifiedtripselector)        | 任意       |        | 1          | この便に対して行われた変更へのリンク 。                      |                  |

### _message_ VehicleDescriptor

車両の識別情報。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-vehicledescriptor)）

| _**フィールド名**_        | _**データ型**_                                                | _**必須**_      | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ------------------------- | ------------------------------------------------------------ | --------------- | ---------- | ------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| **id**                   | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意 |    | 1          | 車両の内部システム ID。<br /><br />車両ごとに一意である。このID はエンドユーザーには表示すべきではない。 |                    |
| **label**                 | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意            |        | 1          | ユーザーに表示されるラベル。<br /><br />正しい車両を識別するために乗客に表示するもの。 |                    |
| **license_plate**         | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 任意            |          | 1          | 車両のナンバー プレート。                                    |                    |
| **wheelchair_accessible** | [WheelchairAccessible](https://gtfs.org/ja/documentation/realtime/reference/#enum-wheelchairaccessible)           | 任意            |          | 1          | 車椅子利用可否。 |                    |

### _message_ EntitySelector

Alertエンティティの配信対象のセレクター。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#entityselector)）

| _**フィールド名**_ | _**データ型**_                                                | _**必須**_     | Google | _**個数**_ | _**説明**_                                                   | _**JP設定方法**_ |
| ------------------ | ------------------------------------------------------------ | -------------- | ---------- | ------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| **agency_id**      | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須     |       | 1          | 対象agency_id。<br /><br />EntitySelectorのいずれか1つ以上のフィールドの設定は**必須**。 |                    |
| **route_id**       | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須 |          | 1          | 対象のroute_id。<br /><br />EntitySelectorのいずれか1つ以上のフィールドの設定は**必須**。<br /><br />direction_idを指定した場合は**必須**。 |                    |
| **route_type**     | [int32](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須     |          | 1          | 対象のroute_type。<br /><br />EntitySelectorのいずれか1つ以上のフィールドの設定は**必須**。 |                    |
| 【実験的】<br />**direction_id** | [uint32](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須     |          | 1          | 対象のdirection_id。<br /><br />EntitySelectorのいずれか1つ以上のフィールドの設定は**必須**。 |                    |
| **trip**           | [TripDescriptor](#message-tripdescriptor)                    | 条件付必須     |          | 1          | 対象のtrip。<br /><br />EntitySelectorのいずれか1つ以上のフィールドの設定は**必須**。 |                    |
| **stop_id**        | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | 条件付必須     |          | 1          | 対象のstop_id。<br /><br />EntitySelectorのいずれか1つ以上のフィールドの設定は**必須**。 |                    |

### _message_ TranslatedString

多言語への翻訳。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-translatedstring)）

| _**フィールド名**_ | _**データ型**_ | _**必須**_ | Google | _**個数**_ | _**説明**_ | _**JP設定方法**_ |
|------------------|------------|----------------|-------------------|-------------------|-------------------|-------------------|
|**translation**| [Translation](#message-translation) |必須|  | 多数 | 翻訳 |  |

### _message_ Translation

翻訳。（[国際標準仕様](https://gtfs.org/ja/documentation/realtime/reference/#message-translation)）

| _**フィールド名**_ | _**データ型**_ | _**必須**_ | Google | 個数 | _**説明**_ | _**JP設定方法**_ |
|------------------|------------|----------------|-------------------|-------------------|-------------------|-------------------|
|**text**| [string](https://protobuf.dev/programming-guides/proto2/#scalar) |必須|  | 1 |文字列。 | |
|**language**| [string](https://protobuf.dev/programming-guides/proto2/#scalar) |条件付必須|  | 1 | BCP-47 言語コード。<br /><br />翻訳が複数ある場合は**必須**。<br /><br />翻訳が1つであり、言語が不明な場合またはフィード全体の国際化が行われていない場合は、**任意**。 |  |







