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