The Places SDK lets you search for and retrieve information for a variety of place types using a text string or by proximity. Places SDK is the legacy version of Places SDK (New).
Use this guide to understand the key differences between the Places SDK versions and migrate to Places SDK (New).
SDK features available in each version
The following table shows which SDK and API versions are required for each SDK feature:
| Places SDK for iOS (New) | Minimum SDK Version | Places SDK for iOS | Minimum SDK Version |
|---|---|---|---|
| Place Details (New) | 9.0.0 | Place Details | 3.0.0 |
| Place Photo (New) | 9.0.0 | Place Photo | 3.0.0 |
| Text Search (New) | 8.5.0 | ||
| Nearby Search (New) | 9.0.0 | ||
| Autocomplete (New) | 9.0.0 | Autocomplete | 3.0.0 |
| Current Place | 3.0.0 |
Migrate to the new APIs
To migrate to the new APIs, see the following migration guides:
Enhancements in Places SDK for iOS (New)
This section covers key features added to Places SDK for iOS (New).
Implemented on the Google Cloud standard platform
Places SDK for iOS (New) is implemented on the service infrastructure on Google Cloud. This implementation brings a more secure and trusted platform. This standard design brings a level of consistency across the SDKs that improve the efficiency of development with Places SDK for iOS (New).
Improved performance
Places SDK for iOS (New) provides improved performance, making it worthwhile to replace apps that use the existing SDK.
New features
The Places SDK for iOS (New) includes the latest versions of all of the SDK features:
Simplified pricing
Pricing is simplified with Places SDK for iOS (New) so that you only pay for the data you use. Simplified pricing is implemented using field lists, also called field masks.
With Places SDK for iOS and Text Search you use field lists to control the list of fields to return in the response. You are then only billed for the data requested. Using a field list is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.
For detailed pricing information for both SDKs, see Usage and Billing.
Expanded place types
The new SDK includes new place types, which are returned as part of the Place Details and Text Search response. You can also use these new types, and the existing types, in a search with Text Search. The new types are included in Table A.