總覽

選取平台： Android iOS JavaScript 網路服務
Places API 是一項服務，可透過多種方法接受位置資料的 HTTP 要求。會傳回包含地點、地理位置或重要搜尋點的格式化位置資料和圖像。

使用 Places API 的好處

建立位置辨識功能，輕鬆為使用者提供詳細的位置資料。透過 Places API 提供的資料，是根據世界上最準確、最新的 完整地點模型所建構。以下是應用程式使用範例：

  • 顯示在主要都會區的公寓，租以城市為根據的搜尋結果。
  • 請在取貨或外送狀態更新中加入地點詳細資料。
  • 顯示區域內的公園清單，以及使用者提交的相片和評論。
  • 為消費者規劃沿途行程、聯絡資訊、價格和價位。

Places API 的用途

使用 Places API 即可在應用程式中納入下列功能：

  • 提供不同類型使用者查詢的地點搜尋結果，例如文字輸入、鄰近位置，以及模稜兩可或類別的使用者查詢。
  • 針對不同的搜尋類型 (例如特定文字查詢或類別查詢) 啟用自動完成功能。
  • 修正所傳回地點的詳細資料類型，例如營業時間、摘要、使用者評論和相片。
  • 在應用程式提供的服務中新增高畫質相片。

Places API 的運作方式

Places API 接受以特定服務端點做為要求的網址，例如 /place 或 /photo。端點也會接受要求中指定的格式類型，例如 JSON 或 XML。最後，服務要求會使用與該特定端點相關的參數來修正傳回的資料。舉例來說，假設地址元件的 Place Details 要求如下 (假設以 JSON 格式傳回)：

https://maps.googleapis.com/maps/api/place/details/json
  ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0
  &fields=address_components
  &key=YOUR_API_KEY

在此範例中，服務會使用提供的地點 ID 尋找要求的地點，並以 JSON 格式傳回地址元件。

資源

下表概述 Places API 提供的資源及其傳回資料。

資料資源 傳回的資料 傳回格式
地點搜尋 根據裝置位置或搜尋字串傳回地點清單。

詳情請參閱 Place Search 回應、鄰近搜尋回應和文字搜尋回應等詳細資料。

  • JSON
  • XML
地點詳細資訊 傳回特定地點的詳細資訊，包括使用者評論。

詳情請參閱 Place Details 回應。
  • JSON
  • XML
地點相片 提供數百萬個地點相關相片，儲存在 Google 的 Place 資料庫中。

詳情請參閱「地點相片回應」一文。

  • JSON
  • XML
Place Autocomplete 在使用者輸入內容時自動填入地點的名稱和/或地址。

詳情請參閱 Place Autocomplete 回應詳細資料。
  • JSON
  • XML
查詢自動完成 提供文字型地理區域搜尋的查詢預測服務，在使用者輸入內容時傳回建議的查詢。

詳情請參閱「查詢自動完成回應」一文。
  • JSON
  • XML

如何使用 Places API

下列步驟說明在 Places API 服務中使用三個端點時的典型用途。建構解決方案時，您可以使用其他端點，例如 Nearby Search、Place Photos 和 Query Autocomplete。
1 做好準備 請先從設定 Google Cloud 專案開始，並按照後續設定說明操作，並瞭解如何使用 API 金鑰。
2 嘗試基本文字搜尋 取得 API 金鑰後，請按照「文字搜尋」指南中的「基本文字搜尋範例」中所述，執行簡單的文字搜尋。
3 使用 Find Place 要求 Find Place 要求會傳回地點 ID，以及您要求的資料欄位 (例如營業時間、地址和相片)。請參閱尋找地點範例 ，並嘗試更高的用途。
4 瞭解 Find Place 回應基本須知 探索「尋找地點」回應中傳回的資料。詳情請參閱「尋找地點回應」一文。
5 使用地點 ID 瞭解詳情 Find Place 回應不提供特定地點的所有資料。您可以使用 Find Place 回應中傳回的地點 ID，取得特定地點的詳細資料。請參閱「Place Details」。

可用的用戶端程式庫

透過下列任一用戶端程式庫，以您選擇的語言呼叫這個 API：

Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端都是社群支援的用戶端程式庫，並依據阿帕契 2.0 授權的條款提供開放原始碼。 您可以從 GitHub 下載，也可以在這裡找到安裝操作說明和程式碼範例。

後續步驟