本頁面說明 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 控制台。