使用 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 存取地點的相片。 |