Places SDK 可讓您使用文字字串或依據鄰近性，搜尋及擷取各種地點類型的資訊。Places SDK 是舊版 Places SDK (新版)。
請參閱本指南，瞭解 Places SDK 版本之間的主要差異，並遷移至 Places SDK (新版)。
各個版本提供的 SDK 功能
下表列出各 SDK 功能所需的 SDK 和 API 版本：
| 功能 | 在 API 金鑰中啟用 Places API | 初始化方法 | 最低 SDK 版本 |
|---|---|---|---|
| 自動完成 (新版) | Places API (新推出) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Details (新版) | Places API (新推出) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (新版) | 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 (新版) 可根據字串 (例如「台南魯肉飯」、「西門町附近的鞋店」或「中正路 123 號」)，傳回一組地點的相關資訊。這項服務會傳回與文字字串和任何位置自訂調整設定相符的地點清單。
新增回應資料至 Place Details (新版) 和 Place Photos (新版)
Place Details (新版) 現在會在回應
Place物件中加入新的 Review 類別。Place 類別包含新的getReviews()方法，可支援這個欄位。呼叫getReviews()即可傳回最多五則地點評論。Place Photo (新功能) 會將
AuthorAttributions新增至PhotoMetadata類別。AuthorAttributions包含AuthorAttribution物件的List。
新增 URI 回應至 Place Photos (新版)
您現在可以使用 Place Photo (新功能) 傳回圖片點陣圖的 URI。先前，您只能傳回圖片位圖本身。
簡化計費模式
使用 Places SDK for Android (新版) 可簡化定價，讓您只需為所用資料付費。簡化計費模式是使用欄位清單 (也稱為「欄位遮罩」) 實作。
使用 Place Details 和 Text Search 時，您可以使用欄位清單控制回應中傳回的欄位清單。系統只會根據您要求的資料收費。使用欄位清單是良好的設計做法，可確保您不會要求不必要的資料，進而避免不必要的處理時間和帳單費用。
如需這兩種 SDK 的詳細定價資訊，請參閱「用量和帳單費用」。
擴充的地點類型
新的 SDK 包含新的地點類型，會在 Place Details 和 Text Search 回應中傳回。您也可以在使用文字搜尋功能進行搜尋時，使用這些新類型和現有類型。表格 A 包含這些新類型。