本頁將說明伺服器可能傳回的錯誤訊息 Maps Embed API。發生錯誤時， Maps Embed API 會以錯誤訊息文字取代地圖。 也可能會發生某些錯誤狀況，這會導致 將浮水印地圖調暗。
無效請求
如果要求無效，Maps Embed API 會傳回
HTTP 4xx 狀態碼，以及
問題。以下是這類錯誤情況的示例。注意：這並非
所有可能錯誤的完整清單。請檢查實際的錯誤代碼
以及 API 傳回的訊息，瞭解特定問題的詳細資訊。
| 錯誤狀況示例 | 狀態碼 |
|---|---|
請求包含無效參數，或必要參數為
舉例來說，zoom 參數不在
數值範圍的預期範圍，或是 中缺少必要參數
要求。 |
400 BAD REQUEST |
| 要求中的 API 金鑰無效。 | 403 FORBIDDEN |
API 金鑰和配額錯誤
系統會將 API 金鑰和配額錯誤視為無效要求。可能原因 包括：
- API 金鑰遺失或無效。如要解決這個錯誤，請確認您的 要求內含有效的 API 金鑰。 取得 API 金鑰。
- 您的專案未啟用 Maps Embed API。瞭解 啟用及停用 API。
- API 金鑰違反限制。閱讀 進一步瞭解 API 金鑰最佳做法。
帳單和 HTTP 參照網址錯誤
顏色變深的地圖，或稱「負面」街景服務圖片，有「for」浮水印 僅供開發用途」符合以下任一條件時就會傳回 ：
- 您的帳戶尚未啟用帳單功能。啟用計費功能。
- 提供的付款方式無效 (例如抵免額已過期) 資訊卡)。如要解決這個問題，請前往 Google Cloud 控制台，確認您已提供有效的付款方式。
- 已超過自行設定的每日上限。 瞭解如何查看或變更每日計費上限。
- 要求缺少 HTTP 參照網址，而您使用的是 受參照網址限制的 API 金鑰。瞭解詳情 進一步瞭解如何新增參照網址。
檢查瀏覽器的錯誤
如果是帳單和 HTTP 參照網址錯誤，Maps Embed API 會寫入
傳送給 window.console 的訊息。無效請求 (包括
API 金鑰和配額錯誤)，系統只會回報 HTTP 4xx 狀態碼
。本節說明如何在
Google Chrome。如果您使用其他瀏覽器，請洽詢開發人員
瀏覽器的說明文件。本清單列出
在其他瀏覽器中檢查控制台輸出內容。
在 Chrome 中，您可以使用 JavaScript 控制台 按照下列方式檢查控制台輸出內容
- 如要開啟開發人員工具，請選取選單圖示 >更多工具 > 開發人員工具：
- 如要開啟 JavaScript 控制台，請按一下頂端的「Console」(控制台) 分頁標籤 開啟「開發人員工具」視窗您也可以使用 ESC 鍵切換 JavaScript 控制台。