Navigation Connect API 是一种轻量级替代方案，可使用独立的 Google 地图和 Waze 应用进行路线规划，而无需您在应用中构建和嵌入自定义导航界面。它可将驾驶员的会话安全地链接回您的后端。当驾驶员开始行程时，他们会看到熟悉的导航界面，其中包含两项新增功能：行程数据共享权限提示（每 12 个月需要提供一次）以及用于返回您应用的品牌化返回按钮。
为何使用 Navigation Connect API
借助 Navigation Connect API，您可以将 Google 地图或 Waze 中的实时行程位置和预计到达时间更新直接集成到后端流程中。这有助于您做出关键的业务决策，并与客户分享准确的最新信息，同时司机可以使用自己偏好的导航应用（Google 地图或 Waze）。
示例使用场景包括：
- 提高网约车服务的透明度：为网约车客户和乘客提供有关司机位置和预计到达时间的准确实时更新信息。
- 改进配送跟踪功能：根据实时路况和路线数据，向客户提供准确的送货或外卖时间。
- 改进车队管理和调度：通过跟踪实时司机位置，为提供按需服务（例如故障援助、维护或运输）的车队或移动劳动力做出明智的调度决策。
您可以使用 Navigation Connect API 执行的操作
借助 Navigation Connect API，您可以直接在后端接收来自 Google 地图或 Waze 的实时位置信息和预计到达时间 (ETA) 更新。
- 以非侵入式方式跟踪行程：跟踪行程，而不会改变驾驶员使用 Google 地图或 Waze 的选择，也不会改变其用户体验。
- 访问实时位置数据：在整个行程中持续获取司机的实时位置信息、剩余距离和已用时间。
- 监控行程生命周期：配置行程数据的更新频率，以便跟踪行程的确切状态，并在司机在途、到达或暂停行程时立即获知。
- 使用和分享预计到达时间：检索由 Google 的实时路线规划算法提供支持的高度准确的预计到达时间更新。
- 跟踪剩余路线和路况（仅限 Waze）：接收从驾驶员当前位置到最终目的地的有效路线折线和实时路况，与 Waze 中显示的内容完全一致。
- 动态裁剪：随着车辆移动，Navigation Connect 会自动裁剪有效路线多段线，确保您仅收到剩余行程部分。
- 更新频率：在重新计算路线、主动进行客户端重新规划路线或路况信息发生变化时，路线和路况信息会自动更新。
- 灵活注入数据：使用直接 REST API 调用来使用实时行程数据，或使用 Google Cloud Pub/Sub 订阅高效地流式传输更新。
Navigation Connect API 的运作方式
Navigation Connect API 接受包含移动应用标识符和会话配置的 CreateTrip 请求。该服务会生成唯一的行程实例并返回行程令牌。然后，此令牌会附加到 Google 地图或 Waze 深层链接。司机启动导航并授予同意权限后，该服务会处理实时导航数据并返回遥测更新，包括位置、预计到达时间和剩余距离。
资源
下表汇总了通过 Navigation Connect API 提供的资源及其返回的数据。如需了解具体详情，请参阅 Navigation Connect API 参考文档。
| 数据资源 | 返回的数据 |
|---|---|
|
JSON 格式的身份验证和移动应用标识符。 请参阅创建行程。 |
用于在 Google 地图或 Waze 中初始化连接的唯一行程令牌。 |
|
JSON 格式的唯一行程 ID 和拉取或推送方法。 请参阅检索行程数据。 |
实时行程遥测数据，包括：
请参阅处理行程数据。 |
如何使用 Navigation Connect API
| 1 | 开始设置 | 首先设置您的 Google Cloud 项目，然后完成后续说明。 |
| 2 | 创建行程 | 发送 Navigation Connect API 调用以创建具有唯一 ID 的行程，并保存令牌。 |
| 3 | 启动 Google 地图或 Waze | 传递行程令牌并启动 Google 地图或 Waze，以启用行程数据共享功能。 |
| 4 | 检索行程数据 | 发送 Navigation Connect API 调用以检索行程数据。（可选）使用 Google Cloud Pub/Sub 订阅更新。 |
| 5 | 处理行程数据 | 了解如何处理行程状态和其他行程数据。 |