设置概览和要求

本文档介绍了 Navigation Connect API 的设置流程,并列出了使用 Navigation Connect API 的司机设备要求。

Navigation Connect 设置流程

您必须先完成以下设置步骤,然后才能使用 Navigation Connect API:

  1. 创建并配置 Google Cloud 项目。
  2. 启用 Navigation Connect API 并验证您的应用。
  3. 设置 OAuth 以创建 OAuth 令牌。
  4. 设置服务账号,以便在后端基础架构与 Google 地图或 Waze 之间建立通信。

使用 Navigation Connect 的最低设备要求

这些要求对于驾驶员的设备成功运行 Navigation Connect 会话是必要的。会话使用 Navigation Connect API 将实时行程数据(例如位置和预计到达时间)发送到您的后端服务器。

支持的应用版本

设备必须安装 Waze 或 Google 地图(Android 版)。下表列出了 Navigation Connect 以及需要更高版本的各项功能所需的每个应用的最低版本。

App 最低版本 剩余路线报告 路线偏离报告
Android 版 Waze 5.15.5 5.20.0.2 5.22
iOS 版 Waze 5.15.5 5.20.0.1 5.22
Google 地图(Android 版) 26.14 26.27 不支持

已启用精确位置信息服务

提示司机在其设备上开启精确位置信息权限。Waze 和 Google 地图需要精确位置信息才能开始导航。

司机意见征求对话框。

Navigation Connect 需要征得司机同意才能分享行程数据。您无需触发意见征求对话框;Google 地图或 Waze 会自动处理此界面。

在从您的应用发起的首次行程中,Google 地图或 Waze 会提示司机分享其行程数据。

  • 如果司机点按允许,Navigation Connect 会开始与您的后端共享实时位置信息和预计到达时间数据。
  • 如果司机点按不允许,或稍后撤消同意,Google 地图或 Waze 会提供精细导航,但 Navigation Connect 不会发送数据。您的后端会在行程数据载荷中收到 CLIENT_ERROR 状态。

司机必须每 12 个月重新确认一次此同意声明。

后续步骤

设置 Navigation Connect API 的第一步是创建并配置 Google Cloud 项目。