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