您已全部設定完成!

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

啟用 Google Maps JavaScript API

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

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

取得金鑰/驗證

所有 Google Maps JavaScript API 應用程式都需要驗證。

  • 標準 API 使用者:如果您是根據標準方案使用 API,則必須使用在您選擇的專案中設定的 API 金鑰。請參閱標準 API 的 API 金鑰的更多相關資訊。
  • Premium Plan 使用者:如果您是根據 Google Maps APIs Premium Plan 使用 API,則有兩個驗證選項:
    • 使用您在購買 Premium Plan 時為您建立的 Google Maps APIs Premium Plan 方案中設定的 API 金鑰
        或者
    • 使用您的用戶端編號,而不使用 API 金鑰。

    如需有關選擇最佳驗證方法的資訊,請參閱下面的 Google Maps APIs Premium Plan 一節。

標準 API 的驗證 - API 金鑰

若要使用標準 API,在載入 API 時必須包含 API 金鑰。

使用 API 金鑰的好處:

  • API 金鑰可讓您在 Google API Console 中監視應用程式的 API 使用情形。如需詳細資訊,請參閱 Google API Console 說明
  • 有了金鑰之後,您就擁有充足的免費每日配額,也可以選擇透過啟用即付即用的付費方式來增加每日配額。
  • 註冊 API 金鑰可確保 Google 可以視需要就您的應用程式相關問題與您聯絡。

取得 API 金鑰

若要開始使用 Google Maps JavaScript API,請按一下下方按鈕,它將自動引導您完成啟用 Google Maps JavaScript API 與所有相關服務的程序。

取得金鑰

或者,您也可以依照這些步驟取得 API 金鑰:

  1. 前往 Google API Console
  2. 建立或選取專案。
  3. 按一下 [Continue] 以啟用 API 與任何相關服務。
  4. 憑證頁面上,取得 API 金鑰 (並設定 API 金鑰限制)。
    注意:如果您有現有的不受限制 API 金鑰,或具有瀏覽器限制的金鑰,您可以使用該金鑰。
  5. 如果要防止配額遭竊,請依照這些最佳做法來保護您的 API 金鑰
  6. (選擇性)啟用計費功能。如需詳細資訊,請參閱使用限制


在 Google API Console 中,您也可以查詢現有金鑰檢視已啟用的 API 清單

如需有關使用 Google API Console 的詳細資訊,請參閱 API Console 說明

API 金鑰限制的類型

Google Maps API 適用於 Android 或 iOS 應用程式、網頁瀏覽器,而且可透過 HTTP Web 服務使用。任何平台中的 API 都可以使用一般(不受限制)API 金鑰。您可以選擇性地新增限制(例如 HTTP 參照網址)到 API 金鑰。完成限制之後,金鑰就只能在支援該限制類型的平台上執行。深入了解金鑰和憑證

載入 API 時指定金鑰

如果要指定金鑰,請在載入 API 時,將金鑰包括為 key 參數的值。

例如:

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

針對 Google Maps APIs Premium Plan 客戶的驗證

本節資訊僅適用於 2016 年 1 月 6 日推出的新 Google Maps APIs Premium Plan。

擁有舊版 Maps APIs for Work 或 Maps API for Business 授權嗎?請參閱我們的 Maps APIs for Work 授權指南。若要判斷您是否擁有舊的授權:在 Google Cloud Support Portal 中,按一下左側的 [Maps:Usage Report]。如果報告頂端的 ID 屬於下列格式,則您擁有新的 Premium Plan:
gme-[company] & proj-[number] ([type])
反之,則您擁有舊的授權。

Google Maps APIs Premium Plan 授權使用 Google Maps JavaScript API 時,必須使用 API 金鑰或用戶端編號來驗證您的應用程式。注意:如果您有舊的 Maps API for Business 授權,則必須使用用戶端編號,不能使用 API 金鑰。

在決定要使用哪一種驗證方法時,請考量下列事項:

  • API 金鑰 (可供 Google Maps APIs Premium Plan 客戶使用,但不供舊的 Maps API for Business 授權持有者使用) - 藉著使用 API 金鑰來驗證要求,您可以:
  • 用戶端編號 - 藉著使用您的用戶端編號(而不使用 API 金鑰)來驗證要求,您可以:
    • 新增 channel 參數到要求,讓您可以檢視更詳細的使用量報告
    • Google Cloud Support Portal 中檢視包含超過 30 天資料的使用量報告
    • 使用 Maps JavaScript API 的 Maps Analytics 工具

取得有關 Premium Plan 客戶可用報告的更多資訊。

使用 API 金鑰

若要使用 API 金鑰驗證 Google Maps JavaScript API,請按一下下方按鈕,它將自動引導您完成取得 API 金鑰的程序。

重要:在專案的下拉式選單中,請務必選取您在訂購 Premium Plan 時,系統為您建立的專案。專案名稱將會以 Google Maps APIs for Business or Google Maps for Work or Google Maps 做為開頭。*

取得金鑰

或者,您也可以依照這些步驟取得 API 金鑰:

  1. 前往 Google API Console
  2. 從專案的下拉式選單中,選取 Google Maps Premium 專案。*
  3. 按一下 [Continue]
  4. 憑證頁面上,取得 API 金鑰 (並設定 API 金鑰限制)。
    注意:如果您有現有的不受限制 API 金鑰,或具有瀏覽器限制的金鑰,您可以使用該金鑰。
  5. 如果要防止配額遭竊,請依照這些最佳做法來保護您的 API 金鑰

* 注意:在專案的下拉式選單中,您必須選取訂購 Premium Plan 時,系統為您建立的專案。專案名稱將會以 Google Maps APIs for Business or Google Maps for Work or Google Maps 做為開頭。重要:如果您有舊的 Maps API for Business 授權,則必須使用用戶端編號,不能使用 API 金鑰。


您也可以在 Google API Console 中查詢現有金鑰

如需有關使用 Google API Console 的詳細資訊,請參閱 API Console 說明

載入 API 時指定金鑰

如果要指定金鑰,請在載入 API 時,將金鑰包括為 key 參數的值。

例如:

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

使用用戶端編號

使用用戶端編號(而不使用 API 金鑰)驗證 Google Maps JavaScript API,需要唯一用戶端編號並結合 URL 註冊

如果您過去使用 API 金鑰驗證,現在要改用用戶端編號驗證,則必須先移除 key 參數,之後才載入 API。如果用戶端編號與 API 金鑰都包含在內,則 API 會載入失敗

您的用戶端編號

購買 Google Maps APIs Premium Plan 授權時,您會收到 Google 寄來的歡迎電子郵件,當中包含您的用戶端編號。您的用戶端編號用於存取 Google Maps APIs Premium Plan 的特殊功能。所有用戶端編號皆以 gme- 前置詞為開頭。

此用戶端編號並非金鑰。用戶端編號只會運作於您授權的 URL,所以您不需費心加以保密。

載入 API 時指定用戶端編號

載入 Google Maps JavaScript API 時,請將您的用戶端編號指定為 client 參數的值:

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

如以上範例所示,您必須附加 v=3.26 參數,來指定發行版本 (又稱為功能穩定版本)或較早的版本。使用實驗功能版本的應用程式並未涵蓋在 Google Maps APIs Premium Plan SLA 中。

註冊授權的 URL

為避免第三方在他們網站上使用您的用戶端編號,用戶端編號的使用範圍僅限於您明確授權的網址清單。

若要查看您已授權哪些網址,或要授權更多網址:

  1. 登入 Google Cloud Support Portal
  2. 在左側選單中,按一下 [Maps:Manage Client ID]

您一次可以新增最多 100 個網址,總計最多 3000 個網址。如果您需要更高的上限,請聯絡支援

針對已授權的網址,有下列幾點注意事項:

網域名稱或 IP 位址不需為可供大眾存取。
例如,http://myintranethttp://192.168.1.1 皆為有效。
指定網域下的所有子網域也都會獲得授權。
例如,若 http://example.com 已獲得授權,則 http://www.example.com 也將獲得授權。反之卻不然:若 http://www.example.com 已獲得授權,那麼 http://example.com 未必會獲得授權。
已授權之路徑下的所有子路徑也都會獲得授權。
例如,若 http://example.com 已獲得授權,則 http://example.com/foo 也將獲得授權。此外,由於指定網域的子網域也會獲得授權,因此 http://sub.example.com/bar 也獲得授權。
路徑區分大小寫。
例如,http://www.example.com/ThisPath/http://www.example.com/thispath/ 不同。
您可以將有效網址限定為使用特定連接埠的網址。
例如,若指定 http://example.com:8080/foo,並不會授權 http://example.com
HTTP 和 HTTPS 通訊協定會被視為不同網址。
例如,若 https://example.com 已獲得授權,那麼 http://example.com 未必會獲得授權。如果您想一次同時授權兩者,新增網域時可以不使用通訊協定: example.com/

以上所有規則適用於每個授權,因此請您務必仔細規劃授權。例如,由於指定路徑的所有子路徑以及所有子網域都能獲得授權,最終您可能會授權原本不打算授權的頁面。例如:

http://example.com/ 同時也授權 http://sub.example.com/path

如需詳細資訊,請參閱疑難排解 Google Maps APIs Premium Plan 授權

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

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