使用 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 的現有客戶，皆適用這項規定。請參閱這份指南，瞭解這兩個 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 會以含有特定服務端點 (例如 /place 或 /photo) 的標準網址接受要求。端點也接受要求中指定的格式類型，包括 JSON 或 XML。服務要求會使用與該特定端點相關的參數，藉此精進傳回的資料。以下範例會提出 Place Details 要求，以 JSON 格式傳回地點 ID 的地址元件：
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 | 文字搜尋 (新版) | Find Place 沒有新版本。已由 Text Search (新版) 取代。 |
| Nearby Search | Nearby Search (新版) | 所有使用現有 API 且包含文字查詢的要求，都應使用 Text Search (新版)，因為 Nearby Search (新版) 不支援文字輸入。 |
| 文字搜尋 | 文字搜尋 (新版) | |
| Place Details | Place Details (新版) | |
| Place Photo | Place Photo (新版) | |
| Place Autocomplete | 自動完成 (新功能) | |
| Query Autocomplete | 自動完成 (新功能) | 新增功能已加入 Autocomplete (新版) |
Places API 的使用方式
以下步驟涵蓋使用 Places API 服務的常見用途情境。在建構解決方案時，您可以使用其他端點，例如附近搜尋和地點相片。| 1 | 做好準備 | 請先設定 Google Cloud 專案，並完成後續的設定操作說明，然後瞭解如何使用 API 金鑰。對於 Places API (新版)，您也可以使用 OAuth 權杖。 |
| 2 | 嘗試基本文字搜尋 | 使用 Text Search (新版) 或 Text Search 發出文字搜尋要求。 |
| 3 | 使用地點 ID 取得更多詳細資料 | 許多 Google 地圖平台 API 會在回應中傳回地點 ID。使用地點 ID 取得地點詳細資料。請參閱「Place Details (新版)」和「Place Details」。 |
| 4 | 取得地點的相片 | 您可以透過「地點相片」服務，存取數百萬張儲存在地點介面集資料庫中的相片。使用 Place Photo (新版) 或 Place Details 存取地點的相片。 |