设置概览和要求

本文档介绍了 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 5.15.5 版 或更高版本，或者 Google 地图 26.14 版 或更高版本。

已启用精确位置信息服务

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

驱动程序意见征求对话框。

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

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

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

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

后续步骤

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