取得 Google Places API for Work 的金鑰

針對擁有舊版 Google Maps APIs for Work 或 Google Maps API for Business 授權的客戶,Google Places API 是作為 Google Places API for Work 的一部分而購買的。

本節介紹該 API 的設定。

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

Google Places API for Work 會使用 API 金鑰來識別您的應用程式。 API 金鑰同於搭配 Google Maps JavaScript API 或其他 Google Maps APIs for Work Web 服務使用的用戶端編號。

在要求中包括金鑰,可讓您在 Google API Console 中監視應用程式的 API 使用狀況、啟用以個別金鑰(而非以個別 IP 位址)為基準的配額限制,以及確保 Google 可以視需要就您的應用程式相關問題與您聯絡。

如需詳細資訊,請參閱 Google API Console 說明

取得 API 金鑰

如果要開始使用 Google Places API for Work,請按一下下方按鈕,它將能帶您前往 Google API Console,引導您完成程序,並自動啟用 Google Places API Web Service。

重要: 在專案的下拉式選單中,請務必選取您在訂購 Google Places API for Work* 時,系統為您建立的專案。

取得金鑰

或者,您也可以依照這些步驟取得 Google Places API for Work 的 API 金鑰:

  1. 前往 Google API Console
  2. 選取在您註冊時為您建立的專案。
    專案名稱將會以 Google Maps APIs for Business or Google Maps for Work or Google Maps 做為開頭。
  3. 按一下 [Continue] 以啟用 API。
  4. [Credentials] 頁面上,取得 API 金鑰 (並設定 API 金鑰限制)。

注意:如果您有現有的具有伺服器限制的金鑰,您可以使用該金鑰。

  1. 為防止配額竊盜,請依照這些最佳做法保護您的 API 金鑰。

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

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

使用金鑰

您必須隨著每個要求,將金鑰作為 key 參數的值傳遞。

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

缺少金鑰的要求會失敗。

限制 IP 位址

為防止其他應用程式使用您的金鑰並取用您的配額,您可以限制能使用您 API 金鑰來傳送要求的 IP 位址:

  1. 前往 Google API Console
  2. 選取在您註冊時為您建立的專案。
  3. API 金鑰 清單中,選取您正在使用的金鑰。
  4. [Restrictions] 區段中,選取 [IP addresses (web servers, cron jobs, etc.)]

  5. [Accept requests from these server IP addresses] 底下,輸入要被接受的金鑰來源 IP 位址(每行輸入一個)。 您也可以使用 CIDR notation (例如 192.168.0.0/22) 輸入子網路。