Places SDK (舊版) 總覽

您可以使用 Places SDK，透過文字字串或鄰近程度，搜尋及擷取各種地點類型的資訊。Places SDK 是舊版 Places SDK (新版)。

請參閱本指南，瞭解 Places SDK 版本之間的主要差異，並遷移至 Places SDK (新版)。

各版本提供的 SDK 功能

下表列出各項 SDK 功能所需的 SDK 和 API 版本：

功能 API 金鑰已啟用 Places API 初始化方法 最低 SDK 版本
自動完成 (新功能) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.5.0
地點詳細資料 (新版) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.3.0
搜尋附近地點 (新功能) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (新版) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.4.0
文字搜尋 (新功能) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete Places API initialize()
目前所在地點 Places API initialize()
Place Details Places API initialize()
Place Photos Places API initialize()

遷移至新版 API

如要遷移至新版 API，請參閱下列遷移指南：

Places SDK for Android (新版) 的強化功能

本節說明 Places SDK for Android (新版) 新增的主要功能。

在 Google Cloud 標準平台實作

Places SDK for Android (新版) 是在 Google Cloud 的服務基礎架構上實作，這項實作作業可打造更安全可靠的平台。 這項標準設計可讓各個 SDK 保持一致，進而提升使用 Places SDK for Android (新版) 開發的效率。

提高效能

Places SDK for Android (新版) 效能更佳，因此值得取代使用現有 SDK 的應用程式。

新功能

Places SDK for Android (新版) 包含所有 SDK 功能的最新版本：

全新 Text Search 服務

Text Search (新版) 可根據字串 (例如「台南魯肉飯」、「西門町附近的鞋店」或「中正路 123 號」)，傳回一組地點的相關資訊。這項服務會傳回與文字字串及位置自訂調整設定相符的地點清單。

Place Details (新版) 和 Place Photos (新版) 新增回應資料

  • Place Details (新版) 現在會在回應的 Place 物件中加入新的評論類別。「Place」類別包含新的 getReviews() 方法，可支援這個欄位。呼叫 getReviews() 即可傳回最多五則地點評論。

  • 地點相片 (新功能) 會將 AuthorAttributions 新增至 PhotoMetadata 類別。AuthorAttributions 包含 AuthorAttribution 物件的 List。

Place Photos (New) 新增 URI 回應

您現在可以使用「Place Photo」(新版) 傳回圖片點陣圖的 URI。先前只能傳回圖片點陣圖本身。

簡化計費模式

Places SDK for Android (新版) 簡化了定價方式，您只需為使用的資料付費。簡化計費模式是透過欄位清單 (也稱為欄位遮罩) 實作。

使用 Place Details 和 Text Search 時，您可以透過欄位清單，控管要在回應中傳回的欄位清單。系統只會收取要求資料的費用。使用欄位清單是良好的設計做法，可確保您不會要求不必要的資料，進而避免不必要的處理時間和帳單費用。

如需這兩個 SDK 的詳細定價資訊，請參閱「用量和帳單」一文。

擴展地點類型

新版 SDK 包含新的地點類型，這些類型會以 Place Details 和 Text Search 回應的形式傳回。您也可以在文字搜尋中使用這些新類型和現有類型。新類型已納入表 A。