您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Maps JavaScript API

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Maps JavaScript API 與相關服務
  3. 建立適當的金鑰
繼續

錯誤訊息


Google Maps JavaScript API 會將錯誤與警告訊息寫入到 window.console。下表列出 Google Maps JavaScript API 傳回的可能錯誤代碼(含原因描述與問題修正方法)。如需有關尋找錯誤訊息的協助,請參閱檢查瀏覽器中的錯誤一節。

Google Maps JavaScript API 錯誤代碼

如果您在載入 Google Maps JavaScript API 時發生錯誤,請查看下表以尋找錯誤代碼的說明。

錯誤代碼 訊息 描述
InvalidKeyOrUnauthorizedURLMapError 提供的 Google API 金鑰無效,或者未授權此網站使用。

載入 API 的指令碼元素中所包括的 API 金鑰無效,或者目前載入 Google Maps JavaScript API 的 URL 未加入允許的參照網址清單。您可能需要在 Google API Console 中的 APIs 下啟用 Google Maps JavaScript API。

請參閱取得 API 金鑰

NotLoadingAPIFromGoogleMapError Google Maps JavaScript API 必須直接從 Google 的伺服器下載。

您的頁面沒有正確包含載入 Google Maps JavaScript API 的指令碼元素。如果要讓 API 正確運作,必須直接從 https://maps.googleapis.com 載入。

請參閱載入 Maps API

TOSViolationMapError This website appears to violate the Google Maps API Terms of Service.The Google Maps API has been disabled for this website.

您的應用程式不符合 Google Maps APIs 服務條款規範,因此已被封鎖,而且我們已寄發數個電子郵件通知。要解除封鎖並提交您的實作供檢閱,請完成此表單。您將在數個工作天內收到以電子郵件寄送的回應。

若您有 Google Maps APIs Premium Plan 授權,請使用您的 Google Maps APIs Premium Plan 認證以解決此錯誤。請參閱 API 金鑰與用戶端 ID 指南。

UnauthorizedURLForClientIdMapError 此 URL 未獲授權使用提供的 Google 地圖用戶端 ID。

指令碼載入中包含的 Premium Plan 或 Maps APIs for Work 用戶端 ID 無效,或正在載入 Google Maps JavaScript API 的目前位址尚未新增到授權網址清單。

請參閱註冊授權的 URL

適用於開發人員的 Google Maps JavaScript API 錯誤代碼

如果您在 Chrome JavaScript ConsoleFirefox Web Console 或瀏覽器的任何其他類似工具發現錯誤,請查看下表以尋找錯誤代碼的說明。

錯誤代碼分為兩種類型:錯誤和警告。錯誤是指在載入 Google Maps JavaScript API 時發生的嚴重問題。您的頁面無法正確載入 API,所以 API 將無法在該頁面上運作。警告是指與載入 Google Maps JavaScript API 相關的補充訊息。警告會說明錯誤的可能原因,或者提出載入 Google Maps JavaScript API 之程式碼中的潛在問題。如果您只收到警告而沒有收到任何錯誤,API 可以在該頁面正確運作。但是,我們建議您一併修正潛在的問題。

開發人員錯誤代碼 類型 描述
ApiNotActivatedMapError 錯誤

您的 API 專案中未啟用 Google Maps JavaScript API。您可能需要在 Google API Console 中的 APIs 下啟用 Google Maps JavaScript API。

請參閱取得 API 金鑰

DeletedApiProjectMapError 錯誤

您的 API 專案可能已從 Google API Console 刪除。請檢查您產生 API 金鑰的專案是否包含在 JavaScript API 載入器中。您可以建立新的 API 專案,然後在 Google API Console 取得新的金鑰。

請參閱取得 API 金鑰

ExpiredKeyMapError 錯誤

載入 API 的指令碼元素中所包含的 API 金鑰已過期。您可能需要在 Google API Console 中產生新的 API 金鑰。

請參閱取得 API 金鑰

InvalidClientIdMapError 錯誤

載入 API 的指令碼元素中所包含的用戶端 ID 無效或已過期。請確定您使用正確的用戶端 ID。用戶端 ID 必須以 "gme-" 前置詞為開頭。如果您使用正確的用戶端 ID 卻還是看到此錯誤,表示用戶端 ID 可能已過期。請聯絡您的 Google 帳戶管理員。

如果您沒有 Premium Plan 或 Maps APIs for Work 授權,您必須使用 key 參數來搭配您的 API 金鑰,而非使用 client 參數。

請參閱您的用戶端 ID

InvalidKeyMapError 錯誤

載入 API 的指令碼元素中找不到 API 金鑰。請確定您使用正確的 API 金鑰。您可以在 Google API Console 產生新的 API 金鑰。

請參閱取得 API 金鑰

MissingKeyMapError 錯誤

載入 API 的指令碼元素缺少必要驗證參數。如果您是使用標準 Maps JavaScript API,您必須使用 key 參數來搭配有效的 API 金鑰使用。如果您是 Premium Plan 客戶,您必須使用 client 參數搭配您的用戶端 ID 或使用 key 參數搭配有效的 API 金鑰。

請參閱 API 金鑰與用戶端 ID 指南。

ProjectDeniedMapError 錯誤

您的要求未完成。您可能可以在 Google API Console 中找到有關錯誤的更多詳細資料。

請參閱 Google API Console

RefererDeniedMapError 錯誤

您的應用程式不符合 Google Maps APIs 服務條款規範,因此已被封鎖,而且我們已寄發數個電子郵件通知。要解除封鎖並提交您的實作供檢閱,請完成此表單。您將在數個工作天內收到以電子郵件寄送的回應。

RefererNotAllowedMapError 錯誤

目前載入 Google Maps JavaScript API 的 URL 未加入允許的參照網址清單。請在 Google API Console 檢查您 API 金鑰的參照網址設定。

請參閱 Google API Console 中的 API 金鑰。如需詳細資訊,請參閱安全地使用 API 金鑰的最佳做法

OverQuotaMapError 錯誤

要求數目超過 Google Maps JavaScript API 的使用限制。您的應用程式要求將在下次每日配額重設時生效。

如需更多詳細資料,請參閱使用限制指南。該頁面也說明如何取得較高的使用限制。

ClientIdLooksLikeCryptoKey 警告

您可能在 client 參數提供了密碼編譯金鑰。如果您有 Premium Plan 或 Maps APIs for Work 授權,請指定您的用戶端 ID 做為 client 參數。您不需要為 Google Maps JavaScript API 使用密碼編譯金鑰。

請參閱適用於 Premium Plan 與 Maps APIs for Work 客戶的用戶端 ID 指南。

ClientIdLooksLikeKey 警告

您可能在 client 參數提供了 API 金鑰。如果您有 Premium Plan 或 Maps APIs for Work 授權,請指定您的用戶端 ID 做為 client 參數。如果您有 Google Maps APIs Premium Plan,您可以使用 client 參數或 key 參數。如果您沒有任何授權,您必須使用 key 參數而不要使用 client 參數。

請參閱用戶端 ID 與 API 金鑰指南。

InvalidChannel 警告

您可能提供了無效的 channel 參數。管道必須是 ASCII 英數字串,可包含句點 (.)、底線 (_) 和連字號 (-)。請確定您指定了有效的 channel 參數。

請參閱報告 | Google Maps APIs Premium Plan

InvalidClientId 警告

client 參數似乎不包含正確的用戶端 ID。用戶端 ID 開頭應該是 "gme-"。

請參閱適用於 Premium Plan 或 Maps APIs for Work 客戶的用戶端 ID 指南。

InvalidKey 警告

載入 API 的指令碼元素中所包含的 API 金鑰看起來不正確。請確定您使用正確的 API 金鑰。您可以在 Google API Console 產生新的 API 金鑰。

請參閱取得 API 金鑰

InvalidVersion 警告

您可能在指令碼元素中提供了不正確的版本號碼。請確定您使用正確的版本號碼。

請參閱版本控制 | Google Maps JavaScript API

KeyLooksLikeClientId 警告 您可能對 key 參數提供了用戶端 ID。如果您有 Premium Plan 或 Maps APIs for Work 授權,請為 client 參數而不是 key 參數指定您的用戶端 ID。如果您有 Google Maps APIs Premium Plan,您可以使用 client 參數或 key 參數。如果您沒有任何授權,您必須使用 key 參數而不要使用 client 參數。

請參閱用戶端 ID 與 API 金鑰指南

KeyLooksLikeCryptoKey 警告

您可能在 key 參數提供了密碼編譯金鑰。如果您有 Premium Plan 或 Maps APIs for Work 授權,請為 client 參數指定您的用戶端 ID,然後從指令碼元素移除 key 參數。Google Maps JavaScript API 不需要密碼編譯金鑰。如果您有 Google Maps APIs Premium Plan,您可以使用 client 參數或 key 參數。如果您沒有任何授權,可以從 Google API Console 取得免費的 API 金鑰。

請參閱用戶端 ID 與 API 金鑰指南

KeyLooksLikeProjectNumber 警告

您可能對 key 參數提供了專案號碼。請確定您使用正確的 API 金鑰。您可以在 Google API Console 產生新的 API 金鑰。

請參閱取得 API 金鑰

NoApiKeys 警告

用於載入 API 的 script 元素沒有 API 金鑰。請務必包含有效的 API 金鑰做為 key 參數。您可以在 Google API Console 產生新的 API 金鑰。

請參閱取得 API 金鑰

RetiredVersion 警告

您可能在指令碼元素中提供了不再使用的版本。3.0 - 3.24 版本已不再使用,您可能會改為收到 3.25。請更新您的應用程式以使用可用的版本。

請參閱版本控制 | Google Maps JavaScript API

SensorNotRequired 警告

Google Maps JavaScript API 已不再需要 sensor 參數。這個參數不會讓 Google Maps JavaScript API 無法正常運作,但是我們建議您從指令碼元素移除 sensor 參數。

SignatureNotRequired 警告

Google Maps JavaScript API 不需要 signature 參數。這個參數不會讓 Google Maps JavaScript API 無法正常運作,但是可能會引發安全性風險。請將它從指令碼元素移除。

SignedInDeprecated 警告

signed_in 參數已淘汰,而且將在未來的 Google Maps JavaScript API 版本中被忽略。在登入模式淘汰之後,它不會防止 Google Maps JavaScript API 運作,但如果您仰賴目前的登入功能,您的應用程式行為可能會變更。

請檢閱您的應用程式並參閱登入地圖 | Google Maps JavaScript API 以取得有關即將進行之變更的詳細資料。

UrlAuthenticationCommonError 錯誤

發生不屬於此頁面上其他類別的錯誤。這可能是暫時性問題所造成。請稍後再重試要求。如果那樣無法解決問題,請檢閱開發人員指南以確定要求格式正確。

檢查瀏覽器中的錯誤

Google Maps JavaScript API 會將錯誤訊息寫入到 window.console。此節說明如何檢查 Google Chrome 中的 window.console 輸出。如果您使用任何其他瀏覽器,請檢查瀏覽器的開發人員文件。為提供給您參考,這是可用於在一些其他瀏覽器中檢查 window.console 輸出的工具清單。

在 Chrome 中,您可以使用 JavaScript 控制台來檢查 window.console 輸出,如下所示。

  1. 如果要開啟「開發人員工具」,請選取選單圖示 > [更多工具] > [開發人員工具]。
  2. 如果要開啟 JavaScript 控制台,請按下鍵盤上的 ESC 鍵。ESC 鍵將會切換 JavaScript 控制台。如果您關閉控制台,請按下 ESC 鍵以重新開啟它。

如果載入 Google Maps JavaScript API 時發生任何錯誤或警告,它們會顯示為控制台中的一或多行。錯誤或警告訊息具有下列格式:

Google Maps API 錯誤: [錯誤代碼] [API 文件連結]

Google Maps API 警告: [錯誤代碼] [API 文件連結]

您可以檢查上面的錯誤代碼表格以尋找錯誤訊息中的錯誤代碼。您也可以在訊息中的連結 API 文件中尋找有關錯誤訊息的詳細資料。

注意:您能以程式設計方式接聽驗證錯誤

傳送您對下列選項的寶貴意見...

這個網頁
Google Maps JavaScript API
Google Maps JavaScript API
需要協助嗎?請前往我們的支援網頁