使用 Places API 的好處
建立位置感知功能，方便使用者取得詳細的位置資料。Places API 提供的資料，是根據真實世界中最準確、最新且最完整的地點模型建構而成。以下是應用程式的用途範例：
- 在主要都會區中顯示租屋出租，並提供以城市為指定目標的結果。
- 在取貨或外送狀態更新中加入地點詳細資料。
- 顯示特定區域的公園清單，以及使用者提交的相片和評論。
- 提供旅客的聯絡資訊、評論和住宿價位，以便他們規劃行程。
Places API 的用途
您可以使用 Places API 在應用程式中加入下列功能：
- 提供不同類型的使用者查詢的地點搜尋結果，例如文字輸入內容、鄰近地點，以及模糊或類別的使用者查詢。
- 針對不同的搜尋類型 (特定文字查詢或類別查詢) 啟用自動完成功能。
- 修正系統傳回的地點詳細資料類型，例如營業時間、摘要、使用者評論和相片。
- 將高畫質相片新增到應用程式提供的地點。
許多 Google 地圖平台 API 支援地點 ID，因為地點 ID 可用來識別 Google 地點介面集資料庫和 Google 地圖上的地點。取得地點 ID 的方法有很多種，包括從 Places API 取得地點 ID，也可以從 Geocoding API、Routes API 和 Address Validation API 取得。
取得地點 ID 後，您就能使用 Places API 要求特定建築物或搜尋點的詳細資料，例如完整地址、電話號碼、使用者評分和評論。
選擇 Places API 版本
Places API 支援兩種 API 版本：Places API 是現有的 API，Places API (New) 是新一代的 API。
推出 Places API (新版) 後，第一項工作是決定要使用的 API 組合。如果您是新客戶或現有客戶，在使用 API 時就是如此。請參閱這份指南，瞭解這兩種 API 的主要差異。
Places 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
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 (新) 已取代它。 |
| 搜尋附近 | 搜尋附近 (新推出) | 使用現有 API 且包含文字查詢的所有要求，都應使用 Text Search (New)，因為 Nearby Search (新) 不支援文字輸入。 |
| 搜尋文字 | 文字搜尋 (新推出) | |
| Place Details | Place Details (新推出) | |
| 地點相片 | 地點相片 (新品) | |
| Place Autocomplete | 無 Places API (新版) 版本 | |
| 查詢自動完成 | 無 Places API (新版) 版本 |
如何使用 Places API
以下步驟涵蓋使用 Places API 服務的常見用途。建構解決方案時，您可以使用其他端點，例如 Nearby Search 和 Place Photos。| 1 | 做好準備 | 開始進行「設定 Google Cloud 專案」，然後按照隨後提供的設定指示操作，接著查看如何使用 API 金鑰。如果是 Places API (新版)，您也可以使用 OAuth 權杖。 |
| 2 | 嘗試使用基本的文字搜尋 | 使用文字搜尋 (新推出) 或文字搜尋進行簡易文字搜尋。 |
| 3 | 使用地點 ID 即可瞭解詳情 | 許多 Google 地圖平台 API 會在回應中傳回地點 ID。使用地點 ID 即可取得地點的詳細資料。請參閱 Place Details (新版) 和 Place Details。 |
| 4 | 取得地點相片 | 您可以透過地點相片服務，存取數百萬張儲存在地點介面集資料庫的相片。使用 Place Photo (新) 或 Place Details 存取地點的相片。 |