Google 公交 GTFS 时刻表参考和差异

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

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

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

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

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

静态转接

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

忽略了静态 Feed 中的官方规范

Transit 会忽略某些官方规范，因为这些规范属于实验性质。如需了解详情，请访问 gtfs.org。

表 1 列出了静态 Feed 中公交不支持的 GTFS 文件。此外，Transit 不支持这些文件中定义的任何字段。

表 1. 静态 Feed 中包含不受支持的 GTFS 文件
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

表 2 列出了静态 Feed 中 Transit 会忽略的所有 GTFS 定义的字段。

表格 2. 忽略了静态 Feed 中的 GTFS 字段
文件名 GTFS 中定义的被忽略字段 字段类型
fare_attributes.txt payment_method 枚举
feed_info.txt default_lang 语言代码
feed_info.txt feed_publisher_name 文本
pathways.txt max_slope 浮点数
routes.txt continuous_drop_off 枚举
routes.txt continuous_pickup 枚举
routes.txt network_id ID
routes.txt route_desc 文本
routes.txt route_sort_order 非负整数
stops.txt level_id ID
stops.txt stop_desc 文本
stops.txt stop_url 网址
stops.txt tts_stop_name 文本
trips.txt bikes_allowed 枚举

静态 Feed 中的不同解读

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

表 3 显示了静态 Feed 中 Transit 的实现方式与 GTFS 中所述的不同之处。

表格 3. 不同实现方式的静态 Feed 字段
文件名 GTFS 中定义的字段 字段类型 Google 公交是否要求提供？ Google 公交实现详情
fare_attributes.txt transfers 枚举 必需

Google 公交扩展程序。

公开 GTFS 将值限制在 0 到 2 的范围内。Google 公交接受的值介于 0 到 5 之间。

使用此字段可设置允许的转乘次数上限。不包括车站换乘，也称为车厢换乘。如果您不想对费率的换乘次数设置限制，请将 transfers 字段留空。
pathways.txt pathway_mode 枚举 可选 指定 pathway_mode 字段后，如果将其留空，Google 公交会接受该字段，并将其视为未知。
stop_times.txt arrival_time 时间 在特定条件下必需 小时数限制在 00 到 99 之间的值，这对于 3 天行程来说已经足够了。
transfers.txt transfer_type 枚举 必需

不支持 4 和 5 的值，系统会忽略这些值。

Google 公交支持的值为 0、1、2 和 3。
trips.txt block_id ID 可选 如需了解详情，请参阅分块传输示例。

静态 Feed 中的实验性支持

如果您需要有关如何集成此类别中新实验性字段的支持，请与 Google 公交团队联系。

静态 Feed 中受 Google 公交支持的扩展

表 4 提供了有关 Google 公交扩展的信息。这些字段不是官方 GTFS 的一部分。

表格 4.支持的静态 Feed 扩展
文件名 字段 字段类型 Google 公交是否要求提供？ Google 公交实现详情
fare_attributes.txt ic_price 浮点数 可选

此 Google 公交扩展程序仅适用于日本的合作伙伴。

ic_price 字段表示使用智能卡支付此费率的折扣金额。如果此费率不提供任何折扣，或者不支持智能卡，则 ic_price 字段的值需要为 -1。
fare_rules.txt contains_route_id ID 可选

Google 公交扩展程序。

此费率仅适用于访问由 fare_id、origin_id 和 destination_id 列的此组合中所有行的 route_id 值标识的一组确切路线的旅行。

如果缺少 contains_route_id 列，或者此费率的所有值均为 null，则此参数中不会对此费率进行限制。如果为费率指定了 contains_route_id 字段，则 route_id 字段必须为空。
routes.txt checkin_duration 整数 可选

Google 公交扩展程序。

checkin_duration 字段指定建议乘客在预定的出发时间前提前多少秒到达，以便办理登记手续和上车。

如果乘客通过转乘连接到出发地点，则任何指定的转乘时间都会替换 checkin_duration 值。

checkin_duration 值只是通常由公交运营商提供的建议值。它可能无法反映乘客能够到达并仍能上车的绝对最后一刻。
routes.txt route_type 枚举 必需

Google 公交扩展程序。

如需了解 Google 公交如何扩展 GTFS 接受的 route_type 值选项，请参阅扩展的 GTFS 路线类型。
stop_times.txt stop_direction_name 文本 可选

Google 公交扩展程序。

stop_direction_name 字段用于向乘客指明行程的方向。方向存储为从此经停点出发的 direction_name 值。

如果 stop_direction_name 字段为空，则系统会改用支持公交的 trip_direction_name 字段。 如果 trip_direction_name 和 stop_direction_name 字段均为空，则过境数据导入器会将其留空。在这种情况下，合作伙伴可以改用 stop_headsign 或 trip_headsign 值。stop_direction_name 字段的值会进行大小写规范化处理。
stops.txt signposted_as 文本 可选

Google 公交扩展程序。

signposted_as 字段包含平台标牌上书写的逐字文本。示例包括“Towards Central”（朝向中央）和“East side & Brooklyn”（东区和布鲁克林）。

您可以同时设置 GTFS platform_code 字段和公交支持的 signposted_as 字段。

platform_code 和 signposted_as 字段之间的区别包括：

  • 长度。platform_code 字段通常包含数字或字母，例如 2 或 C。
  • 语言。platform_code 字段没有语言，但 signposted_as 值可以有翻译。
  • 稳定性。platform_code 字段的更改频率远低于 signposted_as 字段。
stops.txt vehicle_type 整数 可选

Google 公交扩展程序。

vehicle_type 字段用于指定相应经停点使用的车辆类型。此字段接受分层车辆类型 (HVT) 路线类型。HVT 值派生自欧洲交通协议专家组 (TPEG) 标准。
agency.txt ticketing_deep_link_id ID 可选

Google 公交票务扩展程序。

在 agency.txt 文件中，ticketing_deep_link_id 字段表示用于为此代理机构的旅行发票的深层链接。
routes.txt ticketing_deep_link_id ID 可选

Google 公交票务扩展程序。

在 routes.txt 文件中，ticketing_deep_link_id 字段表示用于为此路线的乘车发票的深层链接。
stop_times.txt ticketing_stop_time_id ID 可选

Google 公交票务扩展程序。

如果 stop_times.txt 文件中存在 ticketing_stop_time_id 字段，则该字段会替换表示使用深层链接的票务服务停止时间的标识符。
stop_times.txt ticketing_type 枚举 可选

Google 公交票务扩展程序。

ticketing_type 字段指定适用于此经停时间的票务类型。

Google 公交接受以下值：

  • Empty。默认值 - 由行程定义。
  • 0。仅当代理机构或路线启用了票务深层链接时才可用。
  • 1。不可用。
ticketing_deep_links.txt android_intent_uri URI 可选

Google 公交票务扩展程序。

android_intent_uri 字段表示用于在 Android 上进行深层链接的 intent URI。
ticketing_deep_links.txt ios_universal_link_url 网址 可选

Google 公交票务扩展程序。

ios_universal_link_url 字段表示用于在 iOS 上实现深层链接的通用链接网址。
ticketing_deep_links.txt ticketing_deep_link_id ID 必需

Google 公交票务扩展程序。

ticketing_deep_link_id 字段表示深层链接的标识符。
ticketing_deep_links.txt web_url 网址 可选

Google 公交票务扩展程序。

web_url 字段表示用于在网络上进行深层链接的网址。
ticketing_identifiers.txt agency_id ID 必需

Google 公交票务扩展程序。

如需指定为默认 ticketing_stop_id 字段定义的车站的代理机构，agency_id 字段应包含 GTFS agency.txt 文件中的 ID。
ticketing_identifiers.txt stop_id ID 必需

Google 公交票务扩展程序。

如需指定默认 ticketing_stop_id 字段的定义停靠点，stop_id 字段应包含 GTFS stops.txt 文件中的 ID。
ticketing_identifiers.txt ticketing_stop_id ID 必需

Google 公交票务扩展程序。

ticketing_stop_id 字段包含应用于相应经停点的票务 ID。代理机构可以选择对 ID 进行资格认证。
trips.txt exceptional 枚举 可选

此字段表示异常行程。这些车次的运行时间不在常规时间表内，或者因特殊活动或计划中断（例如轨道作业等）而偏离常规路线。

Google 接受以下值选项：

  • 0 常规服务
  • 1。服务异常。例如，因特殊活动而添加的服务，或因计划中断而偏离常规路线的服务。
trips.txt ticketing_trip_id ID 可选

Google 公交票务扩展程序。

如果存在 ticketing_trip_id 字段，则其值会替换 trip_id 字段，以便使用深层链接为行程创建票券。
trips.txt ticketing_type 枚举 可选

Google 公交票务扩展程序。

ticketing_type 字段指定适用于此行程的票券类型。

Google 公交接受以下值：

  • 0。默认值。仅当代理机构或路线启用了票务深层链接时才可用。
  • 1。不可用。
translations.txt lang 语言代码 可选

Google 公交扩展程序。

lang 字段不是官方 GTFS 的一部分，但如果存在，Google 公交会使用此值。

如需指定字词的译文，请使用 lang 字段。其值不得为空或 und（未定义的语言）。
translations.txt trans_id ID 可选

Google 公交扩展程序。

trans_id 字段不是官方 GTFS 的一部分，但 Google 公交会在存在此字段时使用此值。

如需指定要为其提供翻译的短语的 ID 令牌，请使用 trans_id 字段。translations.txt 表中的每一行都表示，在语言 lang 中，短语 trans_id 的翻译是 translation。
trips.txt original_trip_id ID 可选

Google 公交扩展程序。

如果 trips.txt 文件中存在该值，则 original_trip_id 值会替换 trip_id 值，以供其他系统使用。例如，实时匹配。
trips.txt trip_direction_name 文本 可选

Google 公交扩展程序。

trip_direction_name 字段用于向乘客指明行程的方向。此字段中的值会存储为每次行程的 direction_name 值。

如果 stop_times 表中的 stop_direction_name 值在行程中发生变化，则可能会替换 trip_direction_name 值。

trip_direction_name 字段中的值会经过大小写规范化处理。
trips.txt vehicle_category_id ID 可选

Google 公交扩展程序。

在 trips.txt 文件中，vehicle_category_id 字段用于标识分配给此行程的车辆。如果此字段位于 trips.txt 文件中，则其值会覆盖 routes.txt 文件中的 vehicle_category_id 值。
vehicle_categories.txt vehicle_category_id ID 必需

Google 公交扩展程序。

用于标识车辆类别。
vehicle_categories.txt vehicle_amenity_id ID 可选

Google 公交扩展程序。

用于标识车辆类别中所有乘客可用的一组设施。或者，请参阅 vehicle_category_amenities.txt ，了解同一车辆类别中是否提供不同的设施套餐。
vehicle_amenities.txt vehicle_amenity_id ID 必需

Google 公交扩展程序。

用于标识一组设施。
vehicle_amenities.txt ac_availability 枚举 可选

Google 公交扩展程序。

定义空调是否可用。

Google 接受以下值：

  • 0。默认值。未知。
  • 1。随时随地都可使用。
  • 2。不可用。
vehicle_amenities.txt wifi_availability 枚举 可选

Google 公交扩展程序。

定义车载 Wi-Fi 是否可用。

Google 接受以下值：

  • 0。默认值。未知。
  • 1。随时随地都可使用。
  • 2。不可用。
vehicle_amenities.txt toilet_availability 枚举 可选

Google 公交扩展程序。

定义车辆内是否有厕所。

Google 接受以下值：

  • 0。默认值。未知。
  • 1。随时随地都可使用。
  • 2。不可用。
vehicle_amenities.txt gender_accessibility 枚举 可选

Google 公交扩展程序。

定义是否适用性别限制。

Google 接受以下值：

  • 0。默认值。未知。
  • 1。无性别限制。
  • 2。仅限女性。
  • 3。仅限男性。
vehicle_amenities.txt seat_type 枚举 可选

Google 公交扩展程序。

定义座位的类型。

Google 接受以下值：

  • 0。默认值。座椅（不可折叠，但可以向后倾斜）。
  • 1。固定式床（无法向后倾斜作为座椅）。
  • 2。可调节靠背的座椅。
vehicle_amenities.txt service_class 枚举 可选

Google 公交扩展程序。

定义座位的舱位等级。

Google 接受以下值：

  • 0。默认值。未知。
  • 1 头等舱。
  • 2。第二类。
  • 3 第三类。
  • 4 商家。
  • 5 豪华经济舱。
  • 6 经济。
vehicle_amenities.txt service_class_code 字符串 可选

Google 公交扩展程序。

定义简写类代码（例如，1A 表示空调一等座）。此字段是类字段的更具体版本，可用于指定类枚举中不提供的类。
vehicle_amenities.txt seat_plug 枚举 可选

Google 公交扩展程序。

定义座位是否配备电源插头或 USB 插头（任何类型）。

Google 接受以下值：

  • 0。默认值。未知。
  • 1。所有座位均可使用。
  • 2。不可用。
vehicle_amenities.txt row_layout_summary 字符串 可选

Google 公交扩展程序。

定义车辆一排中的座位或床位数。示例包括：“2”（一排 2 个座位，但不知道它们是分开的还是挨在一起的）、“1+1”（一排 2 个单独的座位）、“2+2”（一排 4 个座位，中间有分隔）。
vehicle_amenities.txt row_leg_space 枚举 可选

Google 公交扩展程序。

定义行是否有额外的腿部空间。

Google 接受以下值：

  • 0。默认值。未知 / 不适用。
  • 1。标准腿部空间。
  • 2。额外的腿部空间。
vehicle_category_amenities.txt vehicle_category_id ID 必需

Google 公交扩展程序。

标识车辆类别。通过在多行中重复此字段的值，同一车辆类别可以具有多个设施套餐。如果车辆类别具有不同的服务类别，这通常会很有用。
vehicle_category_amenities.txt vehicle_amenity_id ID 必需

Google 公交扩展程序。

用于标识车辆类别中所有乘客可用的一组设施。