本指南介绍了如何与 Google 集成,以便在各种 Google 平台(包括 Google 地图和 Google 搜索)上为用户提供顺畅的交通搜索体验。从宏观层面来看,主要集成规范包括:
- 提供静态数据的两种方式:
- 基于 GTFS 的集成:提供包含售票扩展程序的 GTFS Feed,适用于您是时刻表数据提供商的情况。对于基于 GTFS 的集成,我们还有一些额外的要求。
- 仅提供停靠站的集成:仅提供停靠站列表,适用于 Google 已从其他来源获取时刻表数据的情况。
- 用于提供动态数据的合作伙伴 API 规范:
- 合作伙伴配置:提供合作伙伴信息,例如品牌信息和联系详情。
- 合作伙伴服务器:支持合作伙伴服务器 API 的实现服务器。
与 Travel Transport 集成的步骤
下面简要介绍了构建和测试端到端系统以支持 Google 的运输功能所需的步骤。集成过程主要分为三个步骤:
- 查看参与要求。
- 向 Google 提供静态数据 Feed。
- 支持 Travel Transport API,以便动态查询价格和房源状况等快速变化的数据。该 API 会利用第 1 步中静态数据 Feed 提供的标识符(例如
ticketing_stop_id
)来识别经停点。
1. 参与要求
Google 的交通功能单元会显示行程和包含价格的预订选项。如需在列表中显示您的商品,您需要提供优质的链接和匹配的最终价格。如需了解详情,请参阅我们的参与要求。
2. 提供静态数据 Feed
您可以通过以下两种方式提供静态数据,每种方式都适用于特定情况。决定使用哪种选项的主要标准是,您是否是您想要提供预订功能的公交连接的时刻表数据提供方。检查 Google 是否已拥有时刻表数据的最简单方法是在 Google 地图上尝试查找特定运营商的连接。
功能 | 基于 GTFS 的集成 | 仅停止集成 |
---|---|---|
用例 | 您已提供包含时刻表和票务信息的 GTFS。 | Google 已从其他来源获取该运营商的时刻表数据。 |
必需的数据 | GTFS ID。 | 您的站点 ID 列表,其中包含地理坐标。 |
工作量 | 低 | 中 |
如果您是运营商的 GTFS Feed 提供方,则适用选项 1。 在这种情况下,您还需要先设置 GTFS Feed,以便为 Google 提供时刻表信息。然后,按照 GTFS 集成部分中的说明操作。
如果 Google 已从其他来源接收运营商的时刻表数据,则适用选项 2。在这种情况下,我们不需要完整的行程信息,但仍需要一份可用于 Travel Transport API 的经停点 ID 列表(请参阅下文)。如需提供经停点列表,请按照仅包含经停点的集成部分中的说明操作。
3. 支持 Travel Transport API
若要以预订合作伙伴的身份列出运输单位的价格,Google 需要能够从合作伙伴处获取最新的价格和供应情况信息。为此,合作伙伴需要提供实现合作伙伴服务器 API 的服务。
3.1. 实现合作伙伴服务器 API
有关如何实现 Partner Server API 的详细信息,请参阅 API 参考文档和合作伙伴服务器指南。借助该 API,Google 可以从合作伙伴处获取最新的价格和库存信息,并且 Google 将调用该 API 以执行以下操作:
- 生成缓存以快速返回价格。
- 当用户点击特定行程时,获取最新价格。
如果合作伙伴希望 Google 显示价格,则必须实现 Partner Server API。
3.2. API 验证和测试
当您的 API 实现即将完成且实现该 API 的服务已启动并运行后,请发送电子邮件至 transport-help@google.com 并附上服务器信息,以便我们开始验证您的实现。
未来,我们计划提供用于验证 API 实现的自动化工具,但目前尚不可用。