總覽

簡介

Places SDK for Android 可讓您建構可辨識位置的應用程式,讓應用程式根據當地商家和使用者裝置附近的其他地點回應。換句話說,您可以根據使用者所重視的地點建構豐富的應用程式,以搭配 Android 定位服務提供的簡易地理型服務。

概念

下列介面提供了 Places SDK for Android 的主要進入點:

  • Places 能讓您透過程式輔助方式存取 Google 的當地地點、商家資訊資料庫,以及裝置目前的位置。
  • Autocomplete 提供預先建立的小工具,可傳回地點預測結果,回應使用者的搜尋查詢。

「地點」是指具有名稱的實體空間,另一個思考地點的方式,是在地圖上找到的所有資訊。例如當地商家、搜尋點和地理位置。在 API 中,地點會以 Place 介面表示。包括地點名稱、地址、地理位置、地點 ID、電話號碼、地點類型、網站網址等等。

選擇 SDK 版本

Places SDK for Android 3.3.0 版支援兩種 SDK 版本:現有 Places SDK for AndroidPlaces SDK for Android (New) 新版 SDK。

首先,您必須決定要使用哪一個 SDK。如果您是新客戶或現有客戶在使用 SDK 時,都是如此。如要瞭解兩個 SDK 版本之間的主要差異,請參閱「選擇 SDK 版本」。

每個 SDK 版本的價格

系統會根據您選擇的 SDK 版本,控管 Place Details、Text Search 和 Place Photos 的定價。Places SDK for Android (新版) 支援簡化的定價模式,因此您只需要為實際使用的資料付費。如需這兩個 SDK 的詳細定價資訊,請參閱「用量與計費」一文。

API 總覽

協助客戶瞭解他們的位置及周遭環境:

  • Place Autocomplete 能在使用者輸入地點時,自動填入地點的名稱和/或地址。
  • Current Place 會傳回使用者裝置最後已知位置的地點清單,並指出每個地點的相對可能性。
  • Place Details 會傳回及顯示地點的詳細資訊。
  • 「Text Search」可根據搜尋文字字串傳回地點。Text Search 是 Places SDK for Android (新版) 的一部分。
  • Place Photos 可傳回地點的高畫質圖片。
  • 地點 ID 會儲存一或多個地點的專屬 ID,以便視需求擷取地點資訊。

條款與政策

凡是使用 Places SDK for Android 的應用程式,都必須遵循《Google 地圖平台服務條款》、《用量與計費方式》以及「顯示作者資訊」中的規定。