要求失敗時，Maps Static API 會發出錯誤或警告。本指南將說明錯誤訊息，並提供解決方法。
無效要求
如果要求無效，Maps Static API 會傳回 HTTP 4xx 狀態碼，以及說明問題的訊息，如下表所示。如要瞭解特定問題的詳細資料，請查看 API 傳回的實際錯誤代碼和訊息。
- 要求內含無效參數，或缺少必要參數。舉例來說，
size參數不在預期的數值範圍內，或是請求中缺少該參數。 400 BAD REQUEST- 要求中包含的 API 金鑰無效。
403 FORBIDDEN
導致地圖無法顯示的錯誤
如果要求有效，但發生其他錯誤導致地圖無法顯示，Maps Static API 會傳回文字或錯誤圖片，而非地圖。舉例來說，如果應用程式超過用量限制，就會發生錯誤。
與 API 金鑰和帳單相關的錯誤
如果您使用 Maps Static API 時未提供 API 金鑰，或帳戶未啟用帳單功能，網頁會顯示錯誤圖片而非地圖，並提供指出錯誤類型的連結。例如「g.co/staticmaperror/key」。
| 無鑰匙錯誤和解決方法 | |
|---|---|
 |
您使用的 Maps Static API 沒有 API 金鑰。如要解決這項錯誤，請完成下列步驟： |
 |
您的要求缺少必要數位簽章。如要解決這項錯誤，請 簽署網址。 |
警告
在某些錯誤情況下，API 會傳回地圖，但地圖可能缺少部分資訊。發生這種情況時，您可以根據下列條件找出警告：
- 地圖上會疊加黃色錯誤列，並顯示「地圖錯誤：g.co/staticmaperror」。
- API 會以名為
X-Staticmap-API-Warning的 HTTP 標頭形式傳回警告。
舉例來說，下列網址的 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, ]* |
嘗試對要求進行地理編碼時發生錯誤。視地理編碼失敗的元素 (例如 center、marker、visible 或 path) 和失敗的元素數量而定，這則訊息有許多變體。其中一個例子是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 網頁控制台或瀏覽器中的其他同類工具，查看 HTTP 標頭警告。