總覽

選取平台： Android iOS JavaScript 網頁服務
Places API 是一項服務，可透過各種方法接受位置資料的 HTTP 要求。這個 API 會傳回經過格式設定的資料和圖像，這些資料和圖像是關於建築物、地理位置或重要搜尋點。

使用 Places API 的好處

建立位置感知功能，為使用者提供詳細的位置資料。透過 Places API 提供的資料，是建立在現實世界最準確、最新且最全面的位置模型之一。以下是應用程式的範例用途：

  • 顯示主要都會區內的公寓出租資訊，並將結果指定為特定城市。
  • 在接送或送達狀態更新中加入地點詳細資料。
  • 顯示某個區域內的公園清單，以及使用者提交的相片和評論。
  • 為規劃行程的使用者提供沿途商家的聯絡資訊、評論和價格等資訊。

Places API 的用途

您可以使用 Places API，在應用程式中加入下列功能：

  • 根據不同類型的使用者查詢 (例如文字輸入、附近地點，以及模糊或分類的使用者查詢)，提供地點搜尋結果。
  • 為不同搜尋類型啟用自動完成功能，包括特定文字查詢或分類查詢。
  • 精細設定地點傳回的詳細資料類型，例如營業時間、摘要、使用者評論和相片。
  • 為應用程式提供服務的地點新增高畫質相片。

許多 Google 地圖平台 API 都支援地點 ID，地點 ID 可用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。取得地點 ID 的方式有很多種，除了 Places API 外，還可以使用Geocoding API、Routes API 和 Address Validation API。

取得地點 ID 後，您可以使用 Places API 要求特定建築物或搜尋點的更多詳細資料，例如完整地址、電話號碼、使用者評分和評論。

Places API (新版) 的運作方式

Places API (新版) 會以含有特定服務端點 (例如 /places 或 places:searchText) 的標準網址接受要求，並傳回 JSON 回應。Places API (新版) 支援使用 API 金鑰和 OAuth 權杖進行授權。以下範例會提出 Place Details (New) 要求，使用 API 金鑰傳回地點 ID 的地址元件：

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

如何使用 Places API

以下步驟涵蓋使用 Places API 服務的常見用途情境。在建構解決方案時，您可以使用其他端點，例如 Nearby Search (新版) 和 Place Photo (新版)。
1 做好準備 請先設定 Google Cloud 專案，並完成後續的設定操作說明，然後瞭解如何使用 API 金鑰。
2 嘗試基本文字搜尋 使用 Text Search (新版) 發出文字搜尋要求。
3 使用地點 ID 取得更多詳細資料 許多 Google 地圖平台 API 會在回應中傳回地點 ID。使用地點 ID 取得 Place Details (新版)。
4 取得地點的相片 您可以透過「地點相片 (新版)」服務，存取數百萬張儲存在地點資料庫中的相片。使用 Place Photo (新版) 存取地點相片。