簡介
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 Photos (新版)。| 1 | 做好準備 | 請先設定 Google Cloud 專案，並完成後續的設定說明，然後瞭解如何使用 API 金鑰。 |
| 2 | 嘗試基本文字搜尋 | 使用 Text Search (新版) 執行文字搜尋。 |
| 3 | 使用地點 ID 取得更多詳細資料 | 許多 Google 地圖平台 API 會在回應中傳回地點 ID。使用地點 ID 取得 Place Details (新版)。 |
| 4 | 取得地點的相片 | 您可以透過「地點相片 (新版)」存取儲存在 Places 資料庫中的數百萬張相片。使用 Place Photos (新版) 存取地點相片。 |