使用 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 支援兩個 API 版本： Places API 現有的 API 和 Places API (新版) 是新一代的 API。
Places API (新版) 推出後，您的第一項工作是決定 以及要使用的 API如果您是新客戶或現有客戶，則發生此情況 目前已經在使用 API 的客戶使用 這份指南 計算差異
Places API 的運作方式
Places API (新推出)
Places API (新版) 接受為標準網址發出的要求，
服務端點，例如 /places 或 places:searchText
並傳回 JSON 回應Places API (新版) 支援
API 金鑰和 OAuth 權杖。
以下範例提出 Place Details 要求，傳回
使用 API 金鑰的地點 ID：
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API 接受帶有特定
服務端點，例如 /place 或 /photo端點
接受要求中指定的格式類型：JSON 或 XML。「服務」
要求使用與該端點相關的參數來調整傳回的資料。
以下範例提出 Place Details 要求，傳回
地點 ID (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。
| Places API | Places API (新推出) | 注意事項 |
|---|---|---|
| Find Place | Text Search (新版) | 沒有新版「尋找地點」。 Text Search (新版) 已取代。 |
| 搜尋附近 | Nearby Search (新版) | 凡是使用現有 API (包含文字查詢) 的要求，都應使用 Text Search (新版) 因為 Nearby Search (新版) 不支援文字輸入。 |
| 搜尋文字 | Text Search (新版) | |
| Place Details | Place Details (新功能) | |
| Place Photo | 地點相片 (新) | |
| Place Autocomplete | 自動完成 (新版) | |
| 查詢自動完成 | 自動完成 (新版) | 自動完成功能加入的功能 (新功能) |
如何使用 Places API
下列步驟涵蓋使用 Places API 服務的一般用途。建構過程中 您的解決方案可以使用 Nearby Search 和 Place Photos 等其他端點。| 1 | 做好準備 | 首先，請設定您的 Google Cloud 專案，然後按照指示操作 瞭解如何使用 API 金鑰。 如果是 Places API (新版)，您也可以使用 OAuth 權杖。 |
| 2 | 嘗試基本文字搜尋 | 使用 Text Search (新版) 或 Text Search (文字搜尋)。 |
| 3 | 使用地點 ID 瞭解詳情 | 許多 Google 地圖平台 API 會在回應中傳回地點 ID。使用 用來取得地點的詳細資料。 詳情請參閱 Place Details (新版) 和 Place Details。 |
| 4 | 取得地點相片 | 您可以透過「地點相片」服務，存取數百萬張儲存在「地點」中的相片 資料庫使用 Place Photo (新版) 或 Place Details 取得特定地點的相片。 |