Google 公交 GTFS 实时参考和差异

本页面介绍了官方 GTFS Realtime 与 Google 公交在以下方面实现该规范的主要差异：

  • 被忽略的官方规范：这些字段是官方 GTFS 的一部分。Google 公交会准确无误地提取这些数据，但不会主动使用这些数据。

  • 解释不同：这些字段包含官方 GTFS 中，Google 公交对这些部分的解释不同于这些部分的 GTFS 定义。

  • 实验性支持：这些字段在 Google 公交的实现中处于实验阶段。如果您想实现新的实验性字段，请与 Google 公交团队联系。

  • 支持 Google 公交的扩展程序：此扩展程序不属于官方 GTFS。支持公交的扩展程序包括公共扩展程序和 Google 公交专用的扩展程序。任何合作伙伴都可以通过其 Feed 将此信息发送到 Google 公交。

实时公交

以下各部分记录了官方 GTFS 与 Google 公交的实时公交 Feed 实现之间的主要区别。

实时 Feed 中被忽略的官方规范

一些被忽略的规范尚处于实验阶段。如需了解详情，请访问 gtfs.org。

表 1 列出了实时 Feed 中公交系统忽略的由 GTFS 定义的字段。

表 1. 实时 Feed 中被忽略的官方字段
消息 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 字符串

实时 Feed 中有不同的解读

虽然 Google 公交接受某些 GTFS 字段，但 Google 公交对这些字段的解读方式与 GTFS 不同。

表 2 列出了实时 Feed 中由 GTFS 定义的字段，这些字段是公交系统有条件地可选或必需的字段。对于可选字段，该表会显示公交是否支持枚举值。

表 2. 解读方式不同的实时 Feed 字段
文件名 在 GTFS 中定义的字段 字段类型 是否需要 Google 公交？ Google 公交实现详情
消息 StopTimeUpdate（在 TripUpdate 中） stop_id 字符串 在特定条件下必需

如果提供 stop_id 字符串，它必须满足以下条件之一：

  • stop_id 字符串必须与相应 GTFS Feed 的 stops.txt 文件中的字符串相同。
  • 如果使用不同的 stop_id 字符串，则提供的 stop_id 字符串必须是静态 GTFS 中提供的原始 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 记录

实时 Feed 中的实验性支持

如果您需要相关支持来集成新的实验性字段，请与 Google 公交联系。

实时 Feed 中支持 Google 公交的扩展程序

发布本文时，没有任何字段属于此类别。如需任何帮助，请与 Google 公交联系。