街景服務 Static API 中的錯誤訊息

如果要求失敗，街景服務 Static API 會傳回錯誤或警告。本指南將說明錯誤訊息，並提供解決方法。

無效要求

如果要求無效，Street View Static API 會傳回 HTTP 4xx 狀態碼和說明問題的訊息。下表列出這類錯誤情況的範例，但並未列出所有可能發生的錯誤。您可以查看 API 傳回的實際錯誤代碼和訊息，瞭解特定問題的詳細資料。

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

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

如果要求有效，但發生其他錯誤導致無法顯示街景服務圖片，Street View Static API 會視錯誤情況傳回文字或錯誤圖片，而非街景服務圖片。舉例來說，如果應用程式超出用量限制，就會發生這類錯誤。

系統顯示錯誤圖片，而非街景服務圖片
圖：系統顯示錯誤圖片，而非街景服務圖片

如果您使用 Street View Static API 時未提供 API 金鑰，或帳戶未啟用帳單功能，頁面會顯示錯誤圖片，而非街景服務圖片，並附上指出錯誤類型的連結。例如「g.co/streetviewerror/key」。

無鑰匙錯誤和解決方法
用量限制錯誤：超過每日地圖載入次數上限 您使用街景服務 Static API 時未提供 API 金鑰。如要解決這項錯誤，請完成下列步驟：
  1. 取得 API 金鑰
  2. 啟用計費功能
  3. 簽署網址
用量限制錯誤：要求網址缺少數位簽章 您的要求缺少必要數位簽章。如要解決這項錯誤，請 簽署網址。