您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Maps Roads API

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Maps Roads API
  3. 建立適當的金鑰
繼續

疑難排解錯誤



發生問題時,將會傳回標準格式錯誤回應內文,且 HTTPS 狀態碼將被設定為錯誤狀態。

回應包含具有單一 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\" parameter contains an invalid value: ☃" 您的要求包含無效的引數。 造成此錯誤最可能的原因是:
  • path 參數的問題。
    請確保您的點至少有 1 個,並且少於 100 個。 每個點都應該是一對由逗點分隔的數字,例如:48.409114,-123.369158。 點應該要以直立線符號 (|) 分隔。
  • 您的要求包括無效的 placeId
  • 您的要求同時包括 placeIdpath。 針對每個要求,只能指定這些參數的其中一個。

如果針對已不存在的道路或針對不是道路的地點傳遞 placeId,則此錯誤將不會傳回。

403 PERMISSION_DENIED 未註冊的要求已被封鎖。 請使用 Google Developers Console 註冊。 您的 API 金鑰無效,或是沒有被包括在要求中。 請確定您已包括整個金鑰,並已為此金鑰啟用 API。
404 NOT_FOUND 此服務需要 HTTPS。 請確保您是將要求傳送到 https://roads.googleapis.com/ 而不是 http://roads.googleapis.com/
429 RESOURCE_EXHAUSTED 由於已達到專案的 QPS 限制,因此系統已經為要求進行節流處理。 您已超過您在 API Console 中設定的每位使用者每秒可以發出的要求的數量限制。 應該設定此限制以避免單一或小型群組的使用者耗盡您的每日配額,並同時針對所有使用者提供合理的存取權。
429 RESOURCE_EXHAUSTED 由於已達到每日限制,因此系統已經為要求進行節流處理。 您已超過專案的每日配額。

指數倒退

在要求失敗時,您應該利用指數倒退來重新嘗試要求。 例如,在要求失敗一次的情況下,請在一秒後重試。如果要求再次失敗,請在兩秒後重試,然後四秒,依此類推。 這能確保在眾多用戶端快速地重試要求的情況下,Google 伺服器不會被損壞的要求或大規模的失敗所淹沒。

傳送您對下列選項的寶貴意見...

這個網頁
Google Maps Roads API
Google Maps Roads API
需要協助嗎?請前往我們的支援網頁