设置概览和要求

本文档介绍了设置 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 地图需要精确位置信息才能开始导航。

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

导航关联需要征得驾驶员同意才能分享行程数据。您无需触发意见征求对话框；Google 地图或 Waze 会自动处理此界面。

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

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

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

后续步骤

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