使用 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 (新版) 存取地點相片。 |