簡介
Places API 是一項服務，可透過各種方法接受位置資料的 HTTP 要求。並傳回建築物、地理位置或重要搜尋點的格式化位置資料和圖像。為什麼要使用 Places API (新版)
建立位置資訊感知功能，為使用者提供詳細的位置資料。Places API (新版) 提供的資料，是以最準確、最新且最全面的真實世界地點模型為基礎。以下是應用程式的範例用途：
- 在主要都會區顯示公寓出租資訊，並根據城市顯示搜尋結果。
- 在取貨或送貨狀態更新中加入地點詳細資料。
- 顯示某個區域的公園清單，以及使用者提交的相片和評論。
- 為規劃行程的使用者提供沿途商家聯絡資訊、評論和價格等級。
Places API (新版) 的用途
您可以使用 Places API (新版)，在應用程式中加入下列功能：
- 根據不同類型的使用者查詢提供地點搜尋結果，例如文字輸入、附近地點，以及含糊不清或類別式的使用者查詢。
- 針對不同搜尋類型啟用自動完成功能，包括特定文字查詢或類別查詢。
- 縮小傳回地點詳細資料的範圍，例如營業時間、摘要、使用者評論和相片。
- 為應用程式服務的地點新增高畫質相片。
許多 Google Maps Platform API 都支援地點 ID，地點 ID 可用來辨識 Google Places 資料庫和 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 Photos (新版)。| 1 | 做好準備 | 設定帳單、啟用 Places API (新版)，並發出第一筆要求。 |
| 2 | 嘗試基本文字搜尋 | 使用 Text Search (新版) 發出文字搜尋要求。 |
| 3 | 使用地點 ID 取得更多詳細資料 | 許多 Google Maps Platform API 都會在回應中傳回地點 ID。使用地點 ID 取得地點詳細資料 (新版)。 |
| 4 | 取得地點相片 | 您可以透過 Place Photos (新版) 存取儲存在地點資料庫中的數百萬張相片。使用地點相片 (新推出) 存取地點相片。 |