錯誤訊息

本頁面說明 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 參照網址錯誤

發生下列任一情況時，系統會傳回顏色較深 (有點像「負片」效果的街景服務圖片)，而且會有「僅供開發使用」浮水印：

• 您的帳戶尚未啟用結帳功能。啟用計費功能。
• 您提供的付款方式無效 (例如信用卡已過期)。如要解決這個問題，請前往 Google Cloud 控制台，並確認您已提供有效的付款方式。
• 超過自行設定的每日上限。 瞭解如何查看或變更每日可計費上限。
• 要求缺少 HTTP 參照網址，且您使用的是參照網址受限的 API 金鑰。進一步瞭解如何新增參照網址。

在瀏覽器中檢查錯誤

對於結算和 HTTP 參照網址錯誤，Maps Embed API 會將錯誤訊息寫入 window.console。對於無效的要求 (包括 API 金鑰和配額錯誤)，主控台只會回報 HTTP 4xx 狀態碼。本節說明如何查看 Google Chrome 的控制台輸出內容。如果您使用任何其他瀏覽器，請參閱瀏覽器的開發人員說明文件。以下列出在一些其他瀏覽器中查看控制台輸出內容時可使用的工具，供您參考。

• 控制台 (Internet Explorer 適用)。
• 網頁控制台 (Firefox 適用)。
• 遠端偵錯 (Android 適用)。
• 網頁檢查器 (iOS 適用)。

在 Chrome 中，您可以使用 JavaScript 控制台檢查控制台輸出內容，如下所示。

1. 如要開啟開發人員工具，請依序選取選單圖示 >「更多工具」 >「開發人員工具」。
2. 如要開啟 JavaScript 控制台，請按一下開發人員工具視窗頂端的「主控台」分頁。您也可以使用 ESC 鍵切換 JavaScript 控制台。