本指南說明如何排解使用 Navigation Connect 時發生的酬載錯誤和資料動態饋給問題。
未收到「運送中」狀態
如果沒有收到 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 晶片，影響位置資訊回報的準確度。