处理错误

本指南介绍如何在使用 Navigation Connect 时排查载荷错误和数据 Feed 问题。

未收到 ENROUTE 状态

如果您未收到 ENROUTE 状态,则可能是发生了身份验证错误。请在初始 CreateTrip 响应中检查是否有拼写错误的 API 参数或过期的行程令牌。

如果状态仍为 NEW,则可能是驾驶员的设备阻止了身份验证。 由于 Navigation Connect 不会针对这些情况发送错误消息,因此请检查以下场景:

  • 如果导航应用找不到目的地,请确认您在启动网址中传递了有效目的地。
  • 如果没有有效路线,请验证起点和目的地是否正确,并且可以通过公路到达。
  • 如果会话无法进行身份验证,请在 CreateTrip 响应中检查是否有拼写错误的 API 参数或过期的行程令牌。
  • 如果在检查上述场景后状态仍为 NEW,请让驾驶员启用精确位置信息,并在 Google 地图或 Waze 中接受同意提示。
  • 如果驾驶员在 Google 地图中处于无痕模式,应用会显示错误,并且会话无法启动。请让驾驶员关闭无痕模式。

在行程开始时收到 FAILED 或 CLIENT_ERROR 状态

如果驾驶员开始行程时状态变为 FAILEDCLIENT_ERROR,则表示有某些因素阻止了行程数据共享。请检查以下原因:

  • 驾驶员连接问题。
  • 驾驶员使用的是 Android Auto 或 Apple CarPlay。
  • 驾驶员未接受或撤消了同意。
  • 驾驶员身份验证方面存在问题。
  • 驾驶员在美国境内开始行程,但您的应用未启用美国境内的行程数据共享。

未收到进一步的行程更新

如果您的 Google Cloud Pub/Sub 主题或 GetTrip API 调用在 ENROUTE 之后未收到 FAILED 或进一步的行程更新,则以下问题可能会导致行程更新缺失:

  • Google 地图或 Waze 意外退出。
  • 驾驶员手机上的网络连接问题。

未收到预期载荷

如果您在检查上述步骤后未收到预期载荷,并且确认所有设置均正确无误,则以下原因可能会导致载荷缺失:

  • 网络连接问题 可能会导致载荷丢失。
  • GPS/GNSS 信号较弱:导航需要来自 GPS/GNSS 卫星的精确位置信息。在地下停车场、城市峡谷或隧道中,可能无法实现这一点。设备在车辆中的位置也会影响信号质量。
  • 设备质量和使用年限:较旧或较便宜的设备可能配备质量较差的 GPS 芯片,从而影响位置信息报告的准确性。