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