Street View Static API 中的錯誤訊息

Street View Static API 可能會在發生問題時發出錯誤或警告。本指南將說明每則錯誤訊息,並提供錯誤解決更多操作說明。

無效請求

如果要求無效,Street View Static API 會傳回 HTTP 4xx 狀態碼和說明問題的訊息。以下列舉這類錯誤狀況的例子。注意:此處僅列舉部分可能的錯誤,請查看 API 傳回的實際錯誤代碼和訊息,進一步瞭解特定問題。

錯誤條件範例 狀態碼
要求含有無效參數,或缺少必要參數。舉例來說,size 參數不在預期數值範圍內,或要求中缺少。 400 BAD REQUEST
要求中包含的 API 金鑰無效。 403 FORBIDDEN

導致無法顯示街景服務圖片的錯誤

如果要求有效,但發生其他導致無法顯示街景服務圖片的錯誤,Street View Static API 會根據錯誤傳回文字或錯誤圖片,而不是街景服務圖片。應用程式超過用量限制時,就屬於這類錯誤狀況的一個例子。

顯示錯誤圖片 (而非地圖)
圖:顯示錯誤圖片,而非街景服務圖片

如果您在沒有 API 金鑰的情況下使用 Street View Static API,或是帳戶未啟用計費功能,則頁面會顯示錯誤圖片,而非街景服務圖片,並附上指出錯誤類型的連結。例如「g.co/streetviewerror/key」。

無金鑰錯誤和解決方案
用量限制錯誤:已超過每日地圖載入量上限 您正在使用 Street View Static API,但沒有 API 金鑰。如要解決這個問題,您必須採取以下步驟:
  1. 取得 API 金鑰
  2. 啟用計費功能
  3. 簽署網址
用量限制錯誤:要求網址缺少數位簽章 您的要求缺少數位簽章 (必要)。如要解決這個問題,請 簽署網址