Places SDK (Legacy) overview

The Places SDK lets you search for and retrieve information for a variety ofplace types using a text string or by proximity. Places SDK is the legacyversion of Places SDK (New).

Use this guide to understand the key differences between the Places SDK versionsand migrate to Places SDK (New).

SDK features available in each version

The following table shows which SDK and API versions are required for each SDKfeature:

Places SDK for iOS (New)Minimum SDK VersionPlaces SDK for iOSMinimum SDK Version
Place Details (New)9.0.0Place Details3.0.0
Place Photo (New)9.0.0Place Photo3.0.0
Text Search (New)8.5.0
Nearby Search (New)9.0.0
Autocomplete (New)9.0.0Autocomplete3.0.0
Current Place3.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 theserviceinfrastructure on Google Cloud. This implementation brings a more secure and trusted platform.This standard design brings a level of consistency across the SDKs that improvethe efficiency of development with Places SDK for iOS(New).

Improved performance

Places SDK for iOS (New) provides improved performance, makingit worthwhile to replace apps that use the existing SDK.

New features

The Places SDK for iOS (New) includes the latest versions ofall of the SDK features:

Simplified pricing

Pricing is simplified with Places SDK for iOS (New) so thatyou only pay for the data you use. Simplified pricing is implemented using fieldlists, also calledfield masks.

With Places SDK for iOS andText Search you use field lists to control the list offields to return in the response. You are then only billed for the datarequested. Using a field list is a good design practice so that you don'trequest unnecessary data, which helps to avoid unnecessary processing time andbilling charges.

For detailed pricing information for both SDKs, seeUsage andBilling.

Expanded place types

The new SDK includes new place types, which are returned as part of thePlace Details and Text Searchresponse. You can also use these new types, and the existing types, in a searchwith Text Search. The new types are included inTableA.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.