基于 GTFS 的集成

通用公交 Feed 规范 (GTFS) 是一种现有的公交时刻表和相关地理信息格式。基于 GTFS 的集成使用 GTFS 和 Google 公交票务扩展完成旅行交通集成的第 1 步 - 提供静态数据 Feed。

Partner Server API 将使用 GTFS 提供的标识符(例如 ticketing_trip_id),因此必须存在有效的 GTFS Feed,才能使用该 API。请按照以下步骤提供有效的 GTFS Feed。

创建 GTFS 静态 Feed

为了让用户能够使用基于 GTFS 的集成来搜索和查找城际旅行路线和时刻表,合作伙伴需要 GTFS Feed。GTFS Feed 数据将包含有关时刻表、路线和票务信息的静态信息,然后 Google 会使用这些信息连接到合作伙伴 API

1. 创建公交账号

如果尚未填写,请转到 Google 公交使用入门,然后使用表单申请帐号。审核完成后,系统将创建一个帐号并显示 GTFS 信息中心。如需详细了解如何访问和配置信息中心,请参阅访问公交合作信息中心

2. 使用附加信息创建 GTFS Feed

创建 GTFS Feed,其中包括 Google 公交票务扩展的必需部分(如需了解详情,请参阅“GTFS 扩展”部分)。为确保提供最佳用户体验,请阅读并遵循 GTFS 质量要求和最佳做法

3. 命名 Feed

建议的 Feed 命名惯例是:agency-region-country_code(例如 gbus-ca-us)或 agency-country_code(如果不需要区域),例如 gbus-br。对于测试 Feed,建议的 Feed 命名惯例为:test-agency-country_code,例如 test-gbus-ca-ustest-gbus-br

4. 上传和更新 Feed

按照发布 GTFS Feed 数据指南上传和更新 GTFS 数据。每次上传数据时,系统都会对数据进行自动验证(最多需要 30 分钟),并生成验证报告。请先修正所有错误,然后再继续下一个步骤。

5. 请求预览环境

GTFS 数据成功通过验证后,请按照使用非公开预览测试 Feed 数据中的说明启用预览环境。启用后,上传的 Feed 数据将在 Google 地图中显示已获许可的用户。此时,GTFS 数据也可用于通过 API 服务器进行测试。

6. 请求发布质量检查审核

在预览版环境中解决任何有问题的警告和数据质量问题后,必须在公开发布之前进行最终的 Google 质量检查审核。通过质量检查审核流程发现的问题将显示在信息中心内。所有未解决的问题得到解决后,就可以发布 GTFS 了。

7. 启动 Feed

如需了解如何将 Feed 公开,请参阅发布 Feed