總覽

簡介

您可以透過 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 (新版),後者是新一代的 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 地圖平台服務條款》、《用量與計費》和顯示出處的規定。