使用 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 的客戶使用 這份指南 計算差異
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 要求,傳回
地點 ID (JSON 格式):
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 (新版) | 沒有新版「尋找地點」。 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。使用 用來取得地點的詳細資料。 詳情請參閱 Place Details (新版) 和 Place Details。 |
4 | 取得地點相片 | 您可以透過「地點相片」服務,存取數百萬張儲存在「地點」中的相片 資料庫使用 Place Photo (新版) 或 Place Details 取得特定地點的相片。 |