當發生問題時，Maps Static API 可能會發出錯誤或警告。本指南將說明每個錯誤訊息，並進一步提供解決錯誤的操作說明。
無效的要求
如果要求無效，Maps Static API 會傳回 HTTP 4xx 狀態碼和問題說明訊息。以下是這類錯誤條件的範例。注意：這份清單並未列出所有可能的錯誤。請查看 API 傳回的實際錯誤代碼和訊息，瞭解特定問題的詳細資料。
| 錯誤狀況範例 | 狀態碼 |
|---|---|
要求含有無效參數，或缺少必要參數。舉例來說，size 參數並不在預期值的數值範圍內，或要求中缺少。 |
400 BAD REQUEST |
| 要求內含的 API 金鑰無效。 | 403 FORBIDDEN |
導致地圖無法顯示的錯誤
如果要求有效，但發生其他錯誤導致地圖無法顯示，Maps Static API 會傳回錯誤或錯誤圖片 (而非地圖)，視錯誤而定。舉例來說，應用程式超過用量限制時，就會發生這類錯誤狀況。
API 金鑰和帳單相關錯誤
如果您使用的 API Static API 沒有 API 金鑰，或是帳戶尚未啟用帳單功能，則頁面會顯示錯誤圖片 (而非地圖)，並提供連結指向錯誤類型。例如 >g.co/staticmaperror/key"。
| 無鍵錯誤和解決方案 | |
|---|---|
 |
您使用 API 金鑰時沒有 Maps Static API，如要解決這個問題，請按照下列步驟操作： |
 |
您的要求缺少數位簽章 (必填)。如要解決這個問題，請簽署網址 |
警告
在某些錯誤條件下，API 會傳回地圖，但部分資訊可能會遺失。發生這種情況時，系統會顯示兩個條件來通知您。
- 會先顯示地圖，但地圖上方疊加了黃色錯誤列，並顯示「地圖錯誤：g.co/staticmaperror"」字樣。
- 第二，API 會以 HTTP 標頭的形式，傳回
X-Staticmap-API-Warning的警告。
舉例來說，下列網址的 markers 參數包含非預期的值：
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
API 會傳回地圖，但上方疊加的黃色錯誤列會顯示「地圖錯誤：g.co/staticmaperror"」
API 也會傳回下列 HTTP 標頭：
X-Staticmap-API-Warning:Error geocoding: marker 1
下表說明 API 可能會以 HTTP 標頭發出的警告：
X-Staticmap-API-Warning 標頭中的警告 |
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
嘗試對要求進行地理編碼時發生錯誤。這則訊息有很多種變化版本，視地理編碼失敗的元素 (置中、標記、可見或路徑) 及失敗元素數量而定。如上例所示，這項警告的示例為 X-Staticmap-API-Warning:Error geocoding: marker 1。 |
Too many geocoded markers requested (max is 15). |
要求指定的使用者可標記標記數量超過系統允許標記的數量上限。上限為 15 個。請注意，此限制僅適用於指定為地理編碼且使用者可理解的地址標記。不適用於以緯度/經度座標指定的標記。 |
Too many geocoded polyline vertices requested (max is 15). |
要求指定了超過可讀地址的折線數量上限。上限為 15 個。請注意，這項限制僅適用於指定地址為需要地理編碼的使用者可判讀地址的折線。不適用於以緯度/經度座標指定的折線。 |
您可以在 Chrome 開發人員工具、Firefox Web Console 或瀏覽器中的其他對等工具中查看 HTTP 標頭警告。