使用 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 API (新版) 會以含有特定服務端點 (例如 /places 或 places:searchText) 的標準網址形式接受要求，並傳回 JSON 回應。Places API (新版) 支援使用 API 金鑰和 OAuth 權杖的授權。下例會使用 API 金鑰，發出 Place Details 要求，傳回地點 ID 的地址元件：
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
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 | Text Search (新版) | Find Place 未提供新版。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。您可以使用地點 ID 取得地點的詳細資料。 詳情請參閱 Place Details (新版) 和 Place Details。 |
| 4 | 取得地點相片 | 您可以透過「地點相片」服務，存取數百萬張儲存在地點介面集資料庫中的相片。使用 Place Photo (新版) 或 Place Details 存取地點的相片。 |