本指南介绍了在使用 Navigation Connect 时如何排查载荷错误和数据 Feed 问题。
未收到 ENROUTE 状态
如果您未收到 ENROUTE 状态，则可能发生了身份验证错误。检查初始 CreateTrip 响应中是否存在拼写错误的 API 参数或过期的行程令牌。
如果状态仍为 NEW，则可能是驾驶员的设备阻止了身份验证。
由于 Navigation Connect 不会针对这些情况发送错误消息，因此请检查以下场景：
- 如果导航应用找不到目的地，请确认您在启动网址中传递了有效的目的地。
- 如果不存在有效路线，请验证起点和目的地是否正确，以及是否可通过公路到达。
- 如果会话无法通过身份验证，请检查
CreateTrip响应中是否存在拼写错误的 API 参数或过期的行程令牌。 - 如果在检查上述情况后，状态仍为
NEW，则让司机在 Google 地图或 Waze 中启用精确位置信息并接受同意提示。 - 如果司机在 Google 地图中处于无痕模式，应用会显示错误，并且会话无法开始。让驾驶员关闭无痕模式。
在行程开始时收到 FAILED 或 CLIENT_ERROR 状态
如果司机开始行程时状态变为 FAILED 或 CLIENT_ERROR，则表示有某些因素阻止了行程数据共享。检查是否存在以下原因：
- 驱动程序连接问题。
- 驾驶员正在使用 Android Auto 或 Apple CarPlay。
- 司机未接受或撤消了同意声明。
- 司机身份验证方面存在挑战。
- 司机在美国境内开始了一段行程，但您的应用未启用美国境内的行程数据共享功能。
未收到进一步的行程更新
如果您的 Google Cloud Pub/Sub 主题或 GetTrip API 调用在 ENROUTE 之后未收到 FAILED 或进一步的行程更新，则以下问题可能会导致行程更新缺失：
- Google 地图或 Waze 意外退出。
- 司机手机上的网络连接问题。
未收到预期载荷
如果您在检查上述步骤后未收到预期的载荷，并且确认所有设置均正确无误，则以下原因可能会导致载荷缺失：
- 网络连接问题可能会导致载荷丢失。
- GPS/GNSS 信号较弱：导航需要 GPS/GNSS 卫星提供精确的位置信息。在地下停车场、城市峡谷或隧道中，可能无法实现此操作。设备在车辆中的位置也会影响信号质量。
- 设备质量和使用时长：较旧或较便宜的设备可能配备质量较差的 GPS 芯片，从而影响位置信息报告的准确性。