Google 大眾運輸 GTFS Realtime 參考資料和差異

本頁說明官方 GTFS Realtime 和 Google 大眾運輸規格導入方式的主要差異，包含下列方面：

  • 略過的官方規格：這些欄位屬於官方 GTFS 的一部分。Google 大眾運輸會正確擷取這些資料，但不會主動使用。

  • 不同解讀：Google 大眾運輸對官方 GTFS 中這些欄位的解讀，與 GTFS 中的定義不同。

  • 實驗性支援：Google 大眾運輸導入的這些欄位屬於實驗性質。如要導入新的實驗性欄位，請與 Google 大眾運輸團隊聯絡。

  • Google 大眾運輸支援的擴充功能：這些擴充功能「不」屬於官方 GTFS 的一部分。Google 大眾運輸支援的擴充功能包含公開擴充功能，以及 Google 大眾運輸專屬的擴充功能。任何合作夥伴都能透過動態饋給，將這些資訊傳送給 Google 大眾運輸。

Realtime 大眾運輸資訊

以下各部分列出官方 GTFS 和 Google 大眾運輸 Realtime 動態饋給導入方式的主要差異。

Realtime 動態饋給中略過的官方規格

某些略過的規格屬於實驗性質，詳情請參閱 gtfs.org。

表 1 列出 Google 大眾運輸在 Realtime 動態饋給中略過的 GTFS 定義欄位。

表 1：Realtime 動態饋給中略過的官方欄位
訊息 略過的 GTFS 定義欄位 欄位類型
Alert (訊息) image TranslatedImage
Alert (訊息) image_alternative_text TranslatedString
Alert (訊息) severity_level 列舉
Alert (訊息) tts_description_text Proto
Alert (訊息) tts_header_text Proto
CarriageDetails (訊息) id 字串
CarriageDetails (訊息) occupancy_percentage int32
Position (訊息) bearing 浮點值
Position (訊息) odometer 雙精度浮點值
Position (訊息) speed 浮點值
Shape (訊息) encoded_polyline 字串
Shape (訊息) shape_id 字串
StopTimeUpdate (訊息) (在 TripUpdate 中) arrival.uncertainty int32
StopTimeUpdate (訊息) (在 TripUpdate 中) stop_time_properties Proto
TripUpdate (訊息) trip_properties Proto
TripUpdate (訊息) vehicle VehicleDescriptor
VehicleDescriptor (訊息) license_plate 字串
VehicleDescriptor (訊息) wheelchair_accessible WheelchairAccessible
VehiclePosition (訊息) congestion_level 列舉
VehiclePosition (訊息) current_status VehicleStopStatus
VehiclePosition (訊息) current_stop_sequence uint32
VehiclePosition (訊息) multi_carriage_details.id 字串
VehiclePosition (訊息) occupancy_percentage uint32
VehiclePosition (訊息) stop_id 字串

Realtime 動態饋給中的不同解讀

雖然 Google 大眾運輸接受某些 GTFS 欄位，但解讀方式與 GTFS 有所不同。

表 2 列出 Realtime 動態饋給中的 GTFS 定義欄位，這些欄位在 Google 大眾運輸中為「選用」或「必要 (有條件)」。如果是選用欄位，這個表格會顯示 Google 大眾運輸是否支援列舉值。

表 2：解讀方式不同的 Realtime 動態饋給欄位
檔案名稱 GTFS 中定義的欄位 欄位類型 是否為 Google 大眾運輸的必要欄位？ Google 大眾運輸導入方式詳細資料
StopTimeUpdate (訊息) (在 TripUpdate 中) stop_id 字串 必要 (有條件)

如果提供 stop_id 字串，該字串必須符合下列任一條件：

  • stop_id 字串必須與對應 GTFS 動態饋給內 stops.txt 檔案中的字串相同。
  • 如果使用其他 stop_id 字串，則提供的 stop_id 字串必須是 GTFS Static 中所提供原始 stop_id 字串的同層或子字串。此外，您也必須提供對應的 stop_sequence 欄位。
StopTimeUpdate (訊息) schedule_relationship 列舉 選用

Google 大眾運輸支援下列列舉值：

  • SCHEDULED
  • SKIPPED
  • NO_DATA
TripDescriptor (訊息) schedule_relationship 列舉 選用

Google 大眾運輸不支援下列列舉值：

  • DUPLICATED
  • CANCELED：如果不是用於 TripUpdate 記錄

Google 支援下列列舉值：

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED：僅適用於 TripUpdate 記錄

Realtime 動態饋給中的實驗性支援

如果您在整合新的實驗性欄位時需要支援，請與 Google 大眾運輸聯絡。

Google 大眾運輸在 Realtime 動態饋給中支援的擴充功能

本文發布時，沒有任何欄位隸屬此類別。如果您需要協助，請與 Google 大眾運輸聯絡。