驗證與授權

本頁面僅適用於舊版 Maps APIs for Work 或 Maps API for Business 授權的客戶。本頁面不適用於 2016 年 1 月推出之新版 Google Maps APIs Premium Plan 的客戶。

用戶端編號

Google Maps APIs for Work 客戶對於 Google Maps JavaScript API 的驗證需要一組結合網址註冊的唯一用戶端編號。

取得用戶端編號

存取任何 API 程式庫或服務時,您必須提供用戶端編號,才能存取 Google Maps APIs for Work 的特殊功能。註冊 Google Maps APIs for Work 時,您將收到 Google Cloud Support Portal 寄來的用戶端編號。所有用戶端編號皆以 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 for Work SLA 中。

註冊您的已授權網址

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

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

  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 for Work 實作的授權疑難排解