疑難排解

錯誤

如果發生錯誤，系統會傳回標準格式錯誤回應主體 並將 HTTP 狀態碼設為錯誤狀態

回應包含單一 error 物件，包含下列內容： 金鑰：

  • code：這與回應的 HTTP 狀態相同。
  • message：錯誤的簡短說明。
  • status：指出錯誤性質的狀態碼。

舉例來說，傳送無效的 placeId 參數會傳回下列回應： 錯誤：

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

可能出現的錯誤包括：

程式碼 狀態 訊息 疑難排解
400 INVALID_ARGUMENT 您所提供的金鑰無效。 您的 API 金鑰無效或並未包含在要求中。 請確認您已輸入完整的金鑰， 已為這個金鑰啟用 API
400 INVALID_ARGUMENT ""路徑\"參數包含無效值：☃" 你的要求含有無效的引數。最有可能的原因 ：
  • path 參數有問題。
    請確認您擁有至少 1 個，且小於 100 個 點。每個點應為一對數字，並以半形逗號分隔， 例如：48.409114,-123.369158。分數應為 並以直立線符號「|」分隔。
  • 您的要求中含有無效的placeId。
  • 您的要求包含「placeId」和 path。您只能為 每個要求

如果傳遞 placeId，則不會傳回這個錯誤 已不存在的道路，或非道路的地點。
403 PERMISSION_DENIED 已封鎖未註冊的要求。請透過 Google Developers 註冊 控制台。 基於下列一或多項原因，要求遭拒：
  • API 金鑰遺失或無效。
  • 您的帳戶尚未啟用帳單功能。
  • 已超過自行設定的用量上限。
  • 您提供的付款方式已失效 (例如 信用卡已過期)。

必須啟用計費功能，才能使用 Google 地圖平台產品 而且所有要求都必須附上有效的 API 金鑰。如要解決這個問題 步驟如下：
404 NOT_FOUND 這項服務必須使用 HTTPS。 請確認您傳送要求給 https://roads.googleapis.com/ 而非 http://roads.googleapis.com/。
429 RESOURCE_EXHAUSTED 已達專案要求數量上限，因此要求受到限制。 您超出了 Google Cloud Platform 控制台。這項限制通常設為請求 以及每 100 秒要求數，以及每位使用者每 100 秒的要求數 建議你設定這項限制，防止特定一群使用者 卻能確保使用者 可允許所有使用者存取請參閱限制 API 用量 設定這些限制

指數輪詢

如果要求失敗，您應以指數重試要求 輪詢。舉例來說，如果要求失敗一次，請過一秒後再試一次 就會失敗、在 2 秒後重試，接著四秒，依此類推。這個 確保要求無效或大規模故障不會導致 Google 的 伺服器，許多用戶端都會迅速重試要求。

疑難排解常見問題

導入問題

我應該多久取樣車輛位置資訊？
為取得高品質的貼齊道路結果，建議每 1 到 10 秒一次。
每筆查詢可傳送的點數是否有數量上限？
有，一個查詢最多可包含 100 個點。
儲存對齊的經緯度時，我該使用的精確度 成對嗎？
確保在所有縮放等級中，貼齊路徑不會沿著道路走，即使是在 最大縮放等級，請以 7 將對齊的經緯度對組儲存 精確度的小數位數。
我可以使用編碼折線顯示貼齊的路徑嗎？
編碼折線只能指定到小數點後 5 位的精確度 這樣會產生大約 2 公尺的誤差因此，編碼折線 如果你想在高倍變焦時沿道路跟走這條路，則不適合使用這個選項 級別。

常見問題

有些資料點沒有對齊，或路徑貼齊的路徑有缺漏。做法 我更正了嗎？
  • 如果您要每隔一段時間就取樣積分，請確定 取樣間隔 (每 1 至 10 秒) 較短。如果使用較長的間隔 例如 60 秒時，自動對齊道路演算法可能無法 準確判斷行經的道路。
  • 如要手動點按地圖建立點， 建立具有少量點或稀疏點的路徑，以貼齊演算法 幾乎無法妥善處理貼齊演算法最適合用於 很接近，試用貼齊功能 「道路」示範或使用道路範例 檢查器來測試路徑
當我時 想放大圖片嗎？
  • 是否截斷經緯度組合的精確度？ ？儲存對齊的經緯度對組 若精確度小於 7 位數，系統會在 地圖上會顯示對齊的路徑。
  • 您是否使用編碼折線？編碼折線截斷 並將經緯度組合設為小數點後 5 位，導致 幾公尺，就能產生鋸齒狀 縮放等級較高的道路

如果上述兩者皆非如此，表示地圖圖塊可能已經更新 則導致它們與 。如果只有少數查詢受到影響 。由於 Google 地圖會定期更新，因此偶爾會發生 並經常在地圖上固定查看舊路徑 (例如 例如幾週前發生的路徑)。為了達到最佳視覺效果 應該在顯示舊路徑之前，先重新擷取舊路徑， 盡可能減少地圖方塊與用於道路的道路索引等不一致 。

為什麼 X 道路速限無法正確顯示？
速限來源有很多種，精確度和涵蓋範圍會不太一樣。 如果發現某些圖案，例如特定道路類型的速限，或是 如果在某個地區偶爾出現錯誤，請採取下列步驟 請提供下列資訊：
  1. 在電腦上開啟 Google 地圖，或是開啟 Android。
  2. 開啟左側選單。
  3. 選取「提供意見」。注意：系統可能會要求您登入。
  4. 選取「編輯地圖」。
  5. 選取要編輯的路段。
  6. 選取「繼續」。
  7. 在「其他」中欄位，表示該道路的速限有誤。
  8. 選取 [提交]。
，瞭解如何調查及移除這項存取權。 你也可以在這裡回報其他問題 (例如道路有 名稱不正確、繪製錯誤、已停業或私人名稱)。
為什麼我的對齊路徑會裁切，而不是跟隨公路？
如要修正這個問題，請檢查下列事項：
  • 確認 interpolate 參數已設為 true。
  • 確認原始資料點的取樣時間間隔夠近 (每 1 至 10 秒)。
為什麼我在對齊路徑中收到許多路段 沒有速限變更的道路？
當 interpolate 參數設為 true 時， 對齊道路查詢時，系統會傳回沿著角落道路的折線 包括曲線和圓環如果道路曲線，表示有多個路段 為了建立折線，即使速限維持不變也一樣 高度符合道路幾何圖形的