本页面介绍了官方 GTFS 时刻表与 Google 公交在以下方面实现该规范的主要差异:
被忽略的官方规范:这些字段是官方 GTFS 的一部分。Google 公交会准确无误地提取这些数据,但不会主动使用这些数据。
解释不同:这些字段包含官方 GTFS 中,Google 公交对这些部分的解释不同于这些部分的 GTFS 定义。
实验性支持:这些字段在 Google 公交的实现中处于实验阶段。如果您想实现新的实验性字段,请与 Google 公交团队联系。
支持 Google 公交的扩展程序:此扩展程序不属于官方 GTFS。支持公交的扩展程序包括公共扩展程序和 Google 公交专用的扩展程序。任何合作伙伴都可以通过其 Feed 将此信息发送到 Google 公交。
静态公交
以下各部分记录了官方 GTFS 与 Google 公交的静态 Feed 实现之间的主要区别。
静态 Feed 中被忽略的官方规范
Google 公交会忽略的一些官方规范是实验性规范。如需了解详情,请访问 gtfs.org。
表 1 列出了静态 Feed 中公交不支持的 GTFS 文件。此外,Google 公交也不支持这些文件中定义的任何字段。
areas.txt |
fare_leg_rules.txt |
fare_products.txt |
fare_transfer_rules.txt |
levels.txt |
stop_areas.txt |
表 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 |
文字 |
stops.txt |
bikes_allowed |
枚举 |
静态 Feed 中有不同的解读
虽然 Transit 接受由 GTFS 定义的某些字段,但 Transit 以与 GTFS 不同的方式解读这些字段。
表 3 显示了 Google 公交在静态 Feed 中实现与 GTFS 中描述不同的字段。
文件名 | 在 GTFS 中定义的字段 | 字段类型 | 是否需要 Google 公交? | Google 公交实现详情 |
---|---|---|---|---|
fare_attributes.txt |
transfers |
枚举 | 必需 | Google 公交扩展程序。 公共 GTFS 将值限制在 使用此字段可设置票价允许的换乘次数上限。这不包括块移(也称为“就座转移”)。如果您不想设置票价的中转次数限制,请将 |
pathways.txt |
pathway_mode |
枚举 | 可选 | 指定 pathway_mode 字段后,如果将其留空,Google 公交会接受该字段,并将其视为未知。 |
stop_times.txt |
arrival_time |
时间 | 在特定条件下必需 | 小时数的范围限定在 00 到 99 之间,这对于三天行程来说足够了。 |
transfers.txt |
transfer_type |
枚举 | 必需 |
Google 公交支持 |
trips.txt |
block_id |
ID | 可选 | 如需了解详情,请参阅屏蔽转移示例。 |
静态 Feed 中的实验性支持
如果您需要相关支持以在此类别中集成新的实验性字段,请与 Google 公交联系。
静态 Feed 中支持 Google 公交的扩展程序
表 4 提供了有关 Google 公交扩展程序的信息。这些字段不属于官方 GTFS。
文件名 | 字段 | 字段类型 | 是否需要 Google 公交? | Google 公交实现详情 |
---|---|---|---|---|
fare_attributes.txt |
ic_price |
浮点值 | 可选 | 此 Google 公交扩展程序仅面向日本的合作伙伴提供。
|
fare_rules.txt |
contains_route_id |
ID | 可选 | Google 公交扩展程序。 此费用仅适用于访问由 如果缺少 |
routes.txt |
checkin_duration |
整数 | 可选 | Google 公交扩展程序。
如果乘客通过换乘来接通出发,则任何定义的换乘时间都会替换
|
routes.txt |
route_type |
枚举 | 必需 | Google 公交扩展程序。 如需了解 Google 公交如何扩展 GTFS 接受的 |
stop_times.txt |
stop_direction_name |
文字 | 可选 | Google 公交扩展程序。
如果 |
stops.txt |
signposted_as |
文字 | 可选 | Google 公交扩展程序。
您可以同时设置 GTFS
|
stops.txt |
vehicle_type |
整数 | 可选 | Google 公交扩展程序。
|
agency.txt |
ticketing_deep_link_id |
ID | 可选 | Google 公交票务扩展程序。 在
|
routes.txt |
ticketing_deep_link_id |
ID | 可选 | Google 公交票务扩展程序。 在
|
stop_times.txt |
ticketing_stop_time_id |
ID | 可选 | Google 公交票务扩展程序。 如果出现在
|
stop_times.txt |
ticketing_type |
枚举 | 可选 | Google 公交票务扩展程序。
Google 公交接受以下值:
|
ticketing_deep_links.txt |
android_intent_uri |
URI | 可选 | Google 公交票务扩展程序。
|
ticketing_deep_links.txt |
ios_universal_link_url |
网址 | 可选 | Google 公交票务扩展程序。
|
ticketing_deep_links.txt |
ticketing_deep_link_id |
ID | 必需 | Google 公交票务扩展程序。
|
ticketing_deep_links.txt |
web_url |
网址 | 可选 | Google 公交票务扩展程序。
|
ticketing_identifiers.txt |
agency_id |
ID | 必需 | Google 公交票务扩展程序。 如需指定为其定义了默认 |
ticketing_identifiers.txt |
stop_id |
ID | 必需 | Google 公交票务扩展程序。 为了指定为其定义默认 |
ticketing_identifiers.txt |
ticketing_stop_id |
ID | 必需 | Google 公交票务扩展程序。
|
trips.txt |
exceptional |
枚举 | 可选 |
此字段表示异常行程。此类线路会在非正常时刻运行,或者由于特殊事件或有计划的中断(如轨道维修等)而改道常规路线。 Google 接受以下值选项:
|
trips.txt |
ticketing_trip_id |
ID | 可选 | Google 公交票务扩展程序。 如果存在 |
trips.txt |
ticketing_type |
枚举 | 可选 | Google 公交票务扩展程序。
Google 公交接受以下值:
|
translations.txt |
lang |
语言代码 | 可选 | Google 公交扩展程序。
如需指定短语的翻译,请使用 |
translations.txt |
trans_id |
ID | 可选 | Google 公交扩展程序。
如需指定提供翻译的短语的 ID 令牌,请使用 |
trips.txt |
original_trip_id |
ID | 可选 | Google 公交扩展程序。 如果出现在
|
trips.txt |
trip_direction_name |
文字 | 可选 | Google 公交扩展程序。
如果
|
trips.txt |
vehicle_category_id |
ID | 可选 | Google 公交扩展程序。 在
|