這項產品或功能為舊版。如要進一步瞭解舊版狀態,請參閱「
舊版產品和功能」。如要遷移至 iOS 版 Places API(新版),請參閱
遷移指南。
Places SDK (舊版) 總覽
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
您可以使用 Places SDK,透過文字字串或鄰近程度,搜尋及擷取各種地點類型的資訊。Places SDK 是舊版 Places SDK (新版)。
請參閱本指南,瞭解 Places SDK 版本之間的主要差異,並遷移至 Places SDK (新版)。
各版本提供的 SDK 功能
下表列出各項 SDK 功能所需的 SDK 和 API 版本:
遷移至新版 API
如要遷移至新版 API,請參閱下列遷移指南:
Places SDK for iOS (新版) 的強化功能
本節將介紹 Places SDK for iOS (新版) 新增的重要功能。
Places SDK for iOS (新版) 是在 Google Cloud 的服務基礎架構上實作,這項實作作業可打造更安全可靠的平台。
這項標準設計可讓各 SDK 保持一致,進而提升使用 Places SDK for iOS (新版) 開發時的效率。
Places SDK for iOS (新版) 效能更佳,因此值得替換使用現有 SDK 的應用程式。
新功能
Places SDK for iOS (新版) 包含所有 SDK 功能的最新版本:
簡化計費模式
Places SDK for iOS (新版) 簡化了定價方式,您只需支付所用資料的費用。簡化計費模式是透過欄位清單 (也稱為欄位遮罩) 實作。
使用 Places SDK for iOS 和「文字搜尋」時,您可以透過欄位清單,控管要在回應中傳回的欄位清單。系統只會收取要求資料的費用。使用欄位清單是良好的設計做法,可避免要求不必要的資料,進而節省不必要的處理時間和帳單費用。
如需這兩個 SDK 的詳細定價資訊,請參閱「用量和帳單」一文。
擴展地點類型
新版 SDK 包含新的地點類型,這些類型會以 Place Details 和 Text Search 回應的形式傳回。您也可以在文字搜尋中使用這些新類型和現有類型。新類型已納入表 A。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-31 (世界標準時間)。
[null,null,["上次更新時間:2025-08-31 (世界標準時間)。"],[],[],null,["The Places SDK lets you search for and retrieve information for a variety of\nplace types using a text string or by proximity. Places SDK is the legacy\nversion of Places SDK (New).\n\nUse this guide to understand the key differences between the Places SDK versions\nand migrate to Places SDK (New).\n\nSDK features available in each version\n\nThe following table shows which SDK and API versions are required for each SDK\nfeature:\n\n| Places SDK for iOS (New) | Minimum SDK Version | Places SDK for iOS | Minimum SDK Version |\n|-----------------------------------------------------------------------------|---------------------|-------------------------------------------------------------------|---------------------|\n| [Place Details (New)](/maps/documentation/places/ios-sdk/details-place) | 9.0.0 | [Place Details](/maps/documentation/places/ios-sdk/place-details) | 3.0.0 |\n| [Place Photo (New)](/maps/documentation/places/ios-sdk/place-photos) | 9.0.0 | [Place Photo](/maps/documentation/places/ios-sdk/photos) | 3.0.0 |\n| [Text Search (New)](/maps/documentation/places/ios-sdk/text-search) | 8.5.0 | | |\n| [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search) | 9.0.0 | | |\n| [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete) | 9.0.0 | [Autocomplete](/maps/documentation/places/ios-sdk/autocomplete) | 3.0.0 |\n| | | [Current Place](/maps/documentation/places/ios-sdk/current-place) | 3.0.0 |\n\nMigrate to the new APIs\n\nTo migrate to the new APIs, see the following migration guides:\n\n- [Migrate to Place Details (New)](/maps/documentation/places/ios-sdk/migrate-details)\n- [Migrate to Place Photo (New)](/maps/documentation/places/ios-sdk/migrate-photo)\n- [Migrate to Autocomplete (New)](/maps/documentation/places/ios-sdk/migrate-autocomplete)\n\nEnhancements in Places SDK for iOS (New)\n\nThis section covers key features added to Places SDK for iOS\n(New).\n\nImplemented on the Google Cloud standard platform\n\nPlaces SDK for iOS (New) is implemented on the [service\ninfrastructure](https://cloud.google.com/service-infrastructure/docs/overview)\non Google Cloud. This implementation brings a more secure and trusted platform.\nThis standard design brings a level of consistency across the SDKs that improve\nthe efficiency of development with Places SDK for iOS\n(New).\n\nImproved performance\n\nPlaces SDK for iOS (New) provides improved performance, making\nit worthwhile to replace apps that use the existing SDK.\n\nNew features\n\nThe Places SDK for iOS (New) includes the latest versions of\nall of the SDK features:\n\n- [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete)\n- [Place Details (New)](/maps/documentation/places/ios-sdk/details-place)\n- [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search)\n- [Place Photos (New)](/maps/documentation/places/ios-sdk/place-photos)\n- [Text Search (New)](/maps/documentation/places/ios-sdk/text-search)\n\nSimplified pricing\n\nPricing is simplified with Places SDK for iOS (New) so that\nyou only pay for the data you use. Simplified pricing is implemented using field\nlists, also called *field masks*.\n\nWith Places SDK for iOS and\nText Search you use field lists to control the list of\nfields to return in the response. You are then only billed for the data\nrequested. Using a field list is a good design practice so that you don't\nrequest unnecessary data, which helps to avoid unnecessary processing time and\nbilling charges.\n\nFor detailed pricing information for both SDKs, see [Usage and\nBilling](/maps/documentation/places/ios-sdk/usage-and-billing).\n\nExpanded place types\n\nThe new SDK includes new place types, which are returned as part of the\nPlace Details and Text Search\nresponse. You can also use these new types, and the existing types, in a search\nwith Text Search. The new types are included in [Table\nA](/maps/documentation/places/ios-sdk/place-types#table-a)."]]