總覽

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

使用 Places API 的好處

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

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

Places API 的用途

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

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

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

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

Places API (新版) 的運作方式

Places API (新版) 會以含有特定服務端點 (例如 /placesplaces: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 (新版) 存取地點相片。