Navigation Connect API 概览

欧洲经济区 (EEA) 开发者

Navigation Connect API 是一项服务，可将司机对 Google 地图和 Waze 导航的使用情况与您的企业系统相关联。它使用行程授权令牌以及应用中的深层链接，以便司机可以点按链接或按钮，在自己选择的消费者应用中开始导航。在司机行程导航期间，您可以持续接收实时位置数据，例如实时位置、高度准确的预计到达时间以及行程生命周期状态。

Navigation Connect API 是一种轻量级替代方案，可用于替代 Navigation SDK。它使用独立的 Google 地图和 Waze 应用进行路线规划，而无需您在应用中构建和嵌入自定义导航界面。它可将驾驶员的会话安全地链接回您的后端。当司机开始行程时，他们会看到熟悉的导航界面，但其中新增了两项内容：行程数据共享同意提示（每 12 个月需要显示一次）以及用于返回您应用的品牌化返回按钮。

为何使用 Navigation Connect API

借助 Navigation Connect API，您可以将 Google 地图或 Waze 中的实时行程位置和预计到达时间 (ETA) 更新直接集成到后端流程中。这有助于您做出关键的业务决策，并与客户分享准确的最新信息，同时司机可以使用自己偏好的导航应用（Google 地图或 Waze）。

示例使用场景包括：

  • 提高网约车服务的透明度：为网约车客户和乘客提供有关司机位置和预计到达时间的准确实时更新。
  • 改进配送跟踪功能：根据实时路况和路线数据，告知客户准确的商品配送或外卖送达时间。
  • 改进车队管理和调度：通过跟踪驾驶员的实时位置，为提供按需服务（例如故障援助、维护或运输）的车队或移动劳动力做出明智的调度决策。

您可以使用 Navigation Connect API 执行的操作

借助 Navigation Connect API，您可以直接在后端接收来自 Google 地图或 Waze 的实时位置信息和预计到达时间更新。

  • 以非侵入式方式跟踪行程：跟踪行程，而不会改变驾驶员使用 Google 地图或 Waze 的选择，也不会改变其用户体验。
  • 访问实时位置数据：在整个行程中持续获取司机的实时位置信息、剩余距离和已用时间。
  • 监控行程生命周期：配置行程数据的更新频率，以跟踪行程的确切状态，并立即了解司机何时在途中、何时已到达或何时暂停行程。
  • 使用和分享预计到达时间：获取由 Google 的实时路线规划算法提供支持的高度准确的预计到达时间更新。
  • 跟踪剩余路线和路况： 接收从司机当前位置到最终目的地的剩余路线多段线和实时路况信息，与 Google 地图或 Waze 中显示的信息完全一致。此功能会触发导航连接企业版 SKU。
    • 动态裁剪：随着车辆移动，Navigation Connect 会自动裁剪驾驶员的有效路线折线（应用中导航的完整路线），以确保您仅收到剩余路线（从驾驶员当前位置到目的地的路段）。
    • 更新频率：在重新计算路线、主动进行客户端重新规划路线或路况信息发生变化时，路线和路况信息会自动更新。
  • 跟踪路线偏离情况（仅限 Waze）：检测驾驶员何时偏离路线，精确定位偏离的确切位置和时间，并确定偏离是驾驶员发起的（例如转错弯），还是系统发起的（例如绕过交通拥堵重新规划路线）。此功能会触发 Navigation Connect Enterprise SKU。
  • 灵活注入数据：使用直接 REST API 调用来使用实时行程数据，或使用 Google Cloud Pub/Sub 订阅来高效地流式传输更新。

Navigation Connect API 的运作方式

Navigation Connect API 接受包含移动应用标识符和会话配置的 CreateTrip 请求。该服务会生成一个唯一的行程实例，并返回一个行程令牌。然后，将此令牌附加到 Google 地图或 Waze 深层链接。驾驶员启动导航并授予同意权限后，该服务会处理实时导航数据并返回遥测更新，包括位置、预计到达时间和剩余距离。

资源

下表汇总了通过 Navigation Connect API 提供的资源及其返回的数据。如需了解具体详情，请参阅 Navigation Connect API 参考文档。

数据资源 返回的数据

JSON 格式的身份验证信息和移动应用标识符。

请参阅创建行程。

用于在 Google 地图或 Waze 中初始化连接的唯一行程令牌。

请参阅启动 Google 地图或 Waze。

唯一的行程 ID 以及采用 JSON 格式的拉取或推送方法。

请参阅检索行程数据。

实时行程遥测数据，包括：

  • 行程状态和元数据
  • 当前位置（纬度/经度）
  • 预计到达时间 (ETA)
  • 剩余距离和时间

请参阅处理行程数据。

如何使用 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 处理行程数据 了解如何处理行程状态和其他行程数据。