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