Google 公交 GTFS Realtime 参考文档和差异

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

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

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

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

  • Google 公交支持的扩展程序：此扩展程序不属于官方 GTFS 的一部分。受公交支持的扩展程序包括公共扩展程序和 Google 公交专用扩展程序。任何合作伙伴都可以在其 Feed 中向 Transit 发送此类信息。

实时公交

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

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

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

表 1 列出了 Transit 在实时 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 字符串
message StopTimeUpdate（在 TripUpdate 中） arrival.uncertainty int32
message 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 中的不同解读

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

表 2 列出了实时 Feed 中由 GTFS 定义的字段，这些字段由 Transit 视情况而定为可选字段或必填字段。对于可选字段，该表会显示 Transit 是否支持枚举值。

表格 2. 不同解读的实时 Feed 字段
文件名 GTFS 中定义的字段 字段类型 Google 公交是否要求提供？ Google 公交实现详情
message 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 公交团队联系。