> [!NOTE]
> This product is in [Legacy status](https://developers.google.com/maps/legacy.md.txt). As of October 2026, Places API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, [migrate
> to Places API (New)](https://developers.google.com/maps/documentation/places/ios-sdk/legacy/migrate-overview).

Use this guide to understand the key differences between the Places SDK for iOS
versions and migrate to Places SDK for iOS (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 (Legacy) | Minimum SDK Version |
|---|---|---|---|
| [Place Details (New)](https://developers.google.com/maps/documentation/places/ios-sdk/details-place.md.txt) | 9.0.0 | [Place Details (Legacy)](https://developers.google.com/maps/documentation/places/ios-sdk/place-details) | 3.0.0 |
| [Place Photos (New)](https://developers.google.com/maps/documentation/places/ios-sdk/place-photos.md.txt) | 9.0.0 | [Place Photos (Legacy)](https://developers.google.com/maps/documentation/places/ios-sdk/photos) | 3.0.0 |
| [Text Search (New)](https://developers.google.com/maps/documentation/places/ios-sdk/text-search.md.txt) | 8.5.0 | No equivalent | Not applicable |
| [Nearby Search (New)](https://developers.google.com/maps/documentation/places/ios-sdk/nearby-search.md.txt) | 9.0.0 | No equivalent | Not applicable |
| [Autocomplete (New)](https://developers.google.com/maps/documentation/places/ios-sdk/place-autocomplete.md.txt) | 9.0.0 | [Place Autocomplete (Legacy)](https://developers.google.com/maps/documentation/places/ios-sdk/autocomplete) | 3.0.0 |
| No equivalent | Not applicable | [Current Place (Legacy)](https://developers.google.com/maps/documentation/places/ios-sdk/current-place) | 3.0.0 |

## Migrate to the new APIs

To migrate to the new APIs, see the following migration guides:

- [Migrate to Place Details (New)](https://developers.google.com/maps/documentation/places/ios-sdk/migrate-details)
- [Migrate to Place Photos (New)](https://developers.google.com/maps/documentation/places/ios-sdk/migrate-photo)
- [Migrate to Autocomplete (New)](https://developers.google.com/maps/documentation/places/ios-sdk/migrate-autocomplete)

## 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](https://cloud.google.com/service-infrastructure/docs/overview) 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:

- [Autocomplete (New)](https://developers.google.com/maps/documentation/places/ios-sdk/place-autocomplete.md.txt)
- [Place Details (New)](https://developers.google.com/maps/documentation/places/ios-sdk/details-place.md.txt)
- [Nearby Search (New)](https://developers.google.com/maps/documentation/places/ios-sdk/nearby-search.md.txt)
- [Place Photos (New)](https://developers.google.com/maps/documentation/places/ios-sdk/place-photos.md.txt)
- [Text Search (New)](https://developers.google.com/maps/documentation/places/ios-sdk/text-search.md.txt)

### 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 Place Details (New) and Text Search (New) 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 so that you don't request unnecessary data, which helps to avoid
unnecessary processing time and billing charges.

For more pricing information for both SDKs, see [Usage and
billing](https://developers.google.com/maps/documentation/places/ios-sdk/usage-and-billing).

### Expanded place types

The Places SDK for iOS (New) includes new place types, which are returned as
part of the
Place Details (New) and Text Search (New)
response. You can also use these new types, and the existing types, in a search
with Text Search (New). The new types are included in [Table
A](https://developers.google.com/maps/documentation/places/ios-sdk/place-types#table-a).