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

本页介绍了官方 GTFS 时间表和 Google 公交在以下方面实施了该规范:

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

  • 不同解释:这些字段包括官方 Google 公交解读的 GTFS 与 这些部分

  • 实验性支持:在 Google 公交的 实施。如果您想实施新的实验性字段,请联系 Google 公交团队

  • 支持 Google 公交的扩展程序:此扩展程序属于 官方 GTFS。支持公交的扩展程序同时包含两种公开扩展程序 和 Google 公交专用的扩展程序。任何合作伙伴都可以将这些信息发送给 动态中的公交信息。

静态公交

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

静态 Feed 中忽略了官方规范

“公交”会忽略的某些官方规范尚处于实验阶段。接收者 如需了解详情,请访问 gtfs.org

表 1 列出了在静态 Feed 中 Google 公交不支持的 GTFS 文件。 而且,这些文件中定义的任何字段都不受 公交。

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

表 2 列出了 静态 Feed

表格 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 中的不同解释

虽然公交接受某些由 GTFS 定义的字段,但公交会解读这些字段 与 GTFS 不同

表 3 显示了 Google 公交以不同方式实现的静态 Feed 中的字段 。

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

Google 公交扩展程序。

公共 GTFS 将值限制在 02。Google 公交接受从 05

使用此字段可设置允许的 费用。这不包括区块转移(也称为就座 传输。如果您不想对 费用,请将 transfers 字段留空。

pathways.txt pathway_mode 枚举 可选 指定 pathway_mode 字段时(如果将其保留) 为空,Google 公交会接受它,并将其视为未知。
stop_times.txt arrival_time 时间 在特定条件下必需 营业时间的值的范围是从 00 到 有 99,这对于三天的行程来说足够了。
transfers.txt transfer_type 枚举 必填

4”和“5”的值不受支持, 将会被忽略。

Google 公交支持 0123

trips.txt block_id ID 可选 如需了解详情,请参阅禁止转移示例

静态 Feed 中的实验性支持

如果您在集成此类别中的新实验性字段时需要帮助, 请联系 Google 公交

静态 Feed 中支持的 Google 公交附加信息

表 4 提供了有关 Google 公交附加信息的信息。这些字段不属于官方 GTFS。

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

此 Google 公交扩展程序仅面向以下国家/地区的合作伙伴提供 Japan。

ic_price 字段表示 使用智能卡支付此机票费用。如果没有折扣 或智能卡不受支持, ic_price 字段的值必须为 -1

fare_rules.txt contains_route_id ID 可选

Google 公交扩展程序。

此票价仅适用于行驶了一组确切路线的旅行 由所有行中的 route_id 值标识。 fare_idorigin_iddestination_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_namestop_direction_name 这两个字段均为空,那么公交导入工具会将其留空。在 在这种情况下,合作伙伴可以使用 stop_headsigntrip_headsign 值。 stop_direction_name 字段会经过标准化处理。

stops.txt signposted_as 文本 可选

Google 公交扩展程序。

signposted_as 字段包含逐字输入的文本 平台标牌上。例如“Towards Central”和 “东侧和布鲁克林。”

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

platform_codesignposted_as 字段包括:

  • 长度platform_code 字段通常 包含数字或字母,如 2C
  • 语言platform_code 字段没有 但 signposted_as 值可以有翻译。
  • 稳定性platform_code 字段将发生变化 比 signposted_as 字段低得多。
stops.txt vehicle_type 整数 可选

Google 公交扩展程序。

vehicle_type 字段用于指定 。此字段接受分层车辆类型 (HVT) 路由类型HVT 值来自于 Europe Transport 协议专家组 (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 字段表示 intent URI 用于在 Android 上实现深层链接

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 字段包含相应 ID 来自 GTFS agency.txt 文件。

ticketing_identifiers.txt stop_id ID 必填

Google 公交票务扩展程序。

为了指定默认 ticketing_stop_id 所在的经停点 字段,stop_id 字段包含来自 GTFS stops.txt 文件。

ticketing_identifiers.txt ticketing_stop_id ID 必填

Google 公交票务扩展程序。

ticketing_stop_id 字段包含 。(可选)代理机构对 ID 进行限定。

trips.txt exceptional 枚举 可选

此字段表示异常行程。他们的业务不在 或由于特殊情况而偏离常规路线 事件或计划内中断情况(如跟踪工作等)。

Google 接受以下值选项:

  • 0:常规服务
  • 1。服务异常。例如,Service 因特殊活动或服务被绕开 由于计划中的中断,继续乘坐正常路线。
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 值。