總覽

簡介

Places SDK for Android 可讓您建構位置辨識應用程式,根據當地商家和使用者裝置附近的其他位置做出回應。也就是說,您可以根據對使用者的意義來建構內容豐富的應用程式,藉此補足 Android 定位服務提供的以地理位置為基礎的服務。

概念

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

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

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

選擇 SDK 版本

應用程式提供的 Places SDK for Android 功能取決於以下組合:您在應用程式設定中指定的 SDK 版本號碼 (例如 3.5.0),以及應用程式初始化方式。如要進一步瞭解 Places SDK for Android 和 Places SDK for Android (新版) 之間的差異,請參閱「選擇 SDK 版本」。

首先,您必須決定要使用哪個 SDK。如果您是新客戶或已使用 SDK 的現有客戶,就屬於這種情況。如要瞭解兩個 SDK 版本之間的主要差異,請參閱「選擇 SDK 版本」。

各 SDK 版本的定價

啟用的 SDK 版本會決定 SDK 用量的定價。Places SDK for Android (新版) 支援簡化的定價模式,因此您只需為實際使用的資料付費。如需 Places SDK for Android 和 Places SDK for Android (新版) 的詳細定價資訊,請參閱「用量與計費」一文。

API 總覽

協助消費者探索商家所在地點和周遭環境:

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

條款與政策

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