通用公共交通 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 公共交通票务扩展程序的必填部分(如需了解详情,请参阅 通用公共交通 Feed 规范扩展程序部分)。为确保提供最佳用户体验,请阅读并遵循 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-us 或
test-gbus-br。
4. 上传和更新 Feed
按照发布 GTFS Feed 数据 指南上传和更新 GTFS 数据。每次上传数据时,系统都会对数据进行自动验证(最多需要 30 分钟),并生成验证报告。请先修复所有错误,然后再继续执行下一步。
5. 申请预览环境
GTFS 数据成功通过验证后,请按照 通过非公开预览测试 Feed 数据 中的说明启用预览环境。启用后,上传的 Feed 数据将对获准用户显示在 Google 地图中。此时,GTFS 数据现在还可以用于使用 API 服务器进行测试。
6. 申请发布质量保证审核
在预览环境中解决所有问题警告和数据质量问题后,您需要进行最终的 Google 质量保证审核,然后才能公开发布。 通过质量保证审核流程发现的问题将显示在信息中心内,解决所有未解决的问题后,GTFS 即可发布。
7. 发布 Feed
如需了解如何向公众提供 Feed,请参阅 发布 Feed 。