疑難排解

提醒：如要使用 Maps JavaScript API，請滿足下列條件：

• 所有 Maps JavaScript API 要求都必須包含 API 金鑰，我們已不再支援無金鑰存取。
• 您必須在每個專案中啟用計費功能。

API 金鑰和帳單錯誤

在某些情況下，地圖顏色可能會變得比較深 (有點像「負片」效果的街景服務圖片)，而且會有「僅供開發使用」浮水印。這通常代表有 API 金鑰或帳單方面的問題。如要使用 Google Maps Platform 的各項產品，帳戶必須啟用計費功能，且所有要求都必須包含有效的 API 金鑰。下列流程可協助您排解這個問題：

您目前是否使用 API 金鑰？

我不確定，要怎麼檢查我是否使用 API 金鑰？

API 金鑰會以 key 參數的形式傳遞，用來載入 Maps JavaScript API。您可以透過下列這幾種方式，檢查自己是否使用 API 金鑰：

• 使用 Google Maps Platform API 檢查工具 Chrome 擴充功能，這可讓您判斷網站是否已正確導入 Google 的授權 Maps API。
• 如果您是使用程式庫或外掛程式來載入 Maps JavaScript API，請檢查該程式庫的設定並尋找 API 金鑰選項。
• 檢查瀏覽器中的錯誤。如果看到下列訊息，表示您並未正確使用 API 金鑰：
  • Google Maps JavaScript API 警告：NoApiKeys
  • Google Maps JavaScript API 錯誤：MissingKeyMapError

網頁程式開發人員適用：

• 如果您可以存取應用程式的原始碼，請尋找用來載入 Maps JavaScript API 的 <script> 標記。載入 Maps JavaScript API 時，請將下方程式碼中的 YOUR_API_KEY 替換成您的 API 金鑰。

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>

• 在瀏覽器中查看網站產生的網路流量。在 Chrome 中，您可以前往開發人員工具的「網路」分頁，這裡會顯示由您網站發出的網路要求。使用 Maps JavaScript API 發出的要求會列在路徑 maps/api/js 下方，而您可以在這裡查看要求是否使用 key 參數。查看「網路」分頁時，依 maps/api/js 篩選網路流量，可能會比較容易找到您需要的資訊。

否，我並未使用 API 金鑰。

如要取得 API 金鑰，請點選下方按鈕。如果未看到任何設定指引，請按照「開始使用 Google 地圖平台」一文中的完整操作說明進行。
開始使用

是，我目前使用 API 金鑰。

太好了！接著我們來檢查帳單帳戶是否已連結至專案。

您的專案是否已連結帳單帳戶？

我不確定，要怎麼檢查帳單帳戶是否已連結至我的專案？

前往 Google Cloud 控制台的 「帳單」頁面，然後選取當初您建立 API 金鑰的專案。如要確認金鑰是否已與專案連結，請按照以下步驟進行：

1. 從左側欄的「Google Maps Platform」>「憑證」，前往「憑證」部分。
2. 查看自家網站是否已列出您目前使用的 API 金鑰。如果沒有，請切換至其他專案再查看一次憑證。
3. 假如都找不到 API 金鑰的專案，代表您可能已經無法存取該專案。請向貴機構組織中的相關人員尋求協助。如果找不到原始專案，建議您：
   1. 建立新專案，方法是在專案清單中選取「新增專案」，或在 Resource Manager 頁面選取「建立專案」。
   2. 建立新的 API 金鑰，在「憑證」頁面中即可建立。按一下「建立憑證」，然後選取「API 金鑰」。

在 Cloud 控制台中找到您的專案後，前往左側選單的「帳單」部分，查看帳單帳戶是否已連結完成。

否，我的專案未連結任何帳單帳戶。

前往 Cloud 控制台的「啟用計費功能」頁面，並在專案中新增帳單帳戶。詳情請參閱「開始使用 Google 地圖平台」一文。

是，我的專案已連結帳單帳戶。

太好了！接下來請確認您提供的付款方式是否有效。

您提供的付款方式是否不再有效 (例如信用卡已過期)？

您可以在 Cloud 控制台中 新增、移除或更新付款方式。

是否超過您自行設定的 API 每日配額限制？

如果您是為避免支出突然增加，而對 API 設定了每日上限 (這是常見的預防做法)，只要提高每日上限就能解決這個問題。

您可以前往 Cloud 控制台中的「API 和服務」資訊主頁，查看每日配額限制。進入資訊主頁後：

1. 畫面出現提示時，請選取專案。
2. 從清單中選取 API，然後按一下「配額」分頁標籤。

您的 API 金鑰是否有 IP 位址限制？

設有 IP 位址限制的 API 金鑰，只能用於適合在伺服器端使用的 Web 服務 (例如 Geocoding API 和其他 Web 服務 API)。大多數 Web 服務在 Maps JavaScript API 中都有對應的服務項目 (相關範例請參閱地理編碼服務)。如要使用 Maps JavaScript API 用戶端服務，您必須另外建立一個能設定 HTTP 參照網址限制的安全 API 金鑰 (請參閱「取得、新增及限制 API 金鑰」一文)。

如果程式碼無法運作：

為協助您讓地圖程式碼可以順利運作，Brendan Kenny 與 Mano Marks 在這部影片中指出一些常見問題和修正方式。

• 檢查是否有錯字。請記住，JavaScript 語言區分大小寫。
• 檢查基本設定。部分常見問題發生在建立地圖的初始階段，例如：
  • 確認您已在地圖選項中指定 zoom 和 center 屬性。
  • 確認您已宣告會在畫面上顯示地圖的 div 元素。
  • 確認地圖的 div 元素具有明確的非零 CSS 高度 (例如 height: 400px)。根據預設，div 元素建立時的高度為 0，因此不可見。
  請查看範例來參考導入方式。
• 使用 JavaScript 偵錯工具協助找出問題，例如 Chrome 開發人員工具中的偵錯工具。請先透過 JavaScript 控制台找出錯誤，例如 InvalidKeyMapError 或 ApiNotActivatedMapError，然後參閱錯誤訊息指南來解決問題。
• 將問題發布到 Stack Overflow 網站。如要瞭解發布問題的技巧，請參閱「支援」頁面。