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 Static API,或帳戶尚未啟用帳單功能,則頁面會顯示錯誤圖片 (而不是街景服務圖片),以及指出錯誤類型的連結。例如 >g.co/streetviewerror/key"。

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