本頁面說明 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 Console，確認您已提供有效的付款方式。
- 已超過自行設定的每日上限。瞭解如何查看或變更每日計費限制。
- 要求缺少 HTTP 參照網址，您使用的是參照網址參照網址限制的 API 金鑰。進一步瞭解如何新增參照網址。
在瀏覽器中檢查錯誤
如果是帳單和 HTTP 參照網址，Maps Embed API 會將錯誤訊息寫入 window.console。針對無效要求 (包括 API 金鑰和 QPS 錯誤)，控制台只會回報 HTTP 4xx 狀態碼。本節說明如何在 Google Chrome 中查看主控台的輸出內容。如果您使用任何其他瀏覽器，請參閱瀏覽器的開發人員說明文件。為了方便參考，您可以在此查看其他瀏覽器的主控台輸出內容。
- Console (Internet Explorer)。
- Web Console：Firefox。
- Android 裝置的遠端偵錯。
- 網頁檢查器 (適用於 iOS)。
在 Chrome 中，您可以使用 JavaScript 控制台來檢查主控台輸出內容，如下所示。
- 如要開啟開發人員工具，請選取選單圖示 > [More Tools] (更多工具) > [Developer Tools] (開發人員工具)。
- 如要開啟 JavaScript 控制台，請按一下「開發人員工具」視窗頂端的「Console」分頁標籤。您也可以使用 ESC 鍵來切換 JavaScript 主控台。