**European Economic Area (EEA) developers**

> [!NOTE]
> If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](https://developers.google.com/maps/comms/eea/faq.md.txt).

<br />

> [!NOTE]
> This feature requires that you enable Places API (New), the next generation of the Places API. For more information, see [Enable APIs](https://developers.google.com/maps/documentation/places/android-sdk/legacy/cloud-setup#enabling-apis).

<br />

Places SDK for Android (Legacy) supports [Place Details (Legacy)](https://developers.google.com/maps/documentation/places/android-sdk/details-places).
If you are familiar with Place Details (Legacy), [Place Details (New)](https://developers.google.com/maps/documentation/places/android-sdk/details-places)
makes the following changes:

- Uses a new pricing model. For pricing information for all APIs, see [Usage and billing](https://developers.google.com/maps/documentation/places/android-sdk/usage-and-billing.md.txt).

- You must initialize your app by calling the
  [`Places.initializeWithNewPlacesApiEnabled()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places.md.txt#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String))
  method. For more information on selecting the Places API service, see
  [Set up your Google Cloud project](https://developers.google.com/maps/documentation/places/android-sdk/legacy/cloud-setup).

- Field masking is required. You must specify which fields you want returned
  in the response. There is no default list of returned fields. If you omit
  this list, the methods return an error.

The following sections describe additional changes.

## Access new place types

Each place can have one or more *type* values associated with it. The
Places SDK for Android version 3.3.0 and later adds many new type
values. For the complete list, see [Expanded place
types](https://developers.google.com/maps/documentation/places/android-sdk/legacy/choose-sdk#expanded_place_types).

The
[`Place.getPlaceTypes()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt#getPlaceTypes())
method returns the type values as a list of string values. The values returned
depend on your version of the Places SDK for Android:

- **Places SDK for Android (New)** : Returns the strings defined by
  Table A and Table B shown on [Place Types (New)](https://developers.google.com/maps/documentation/places/android-sdk/legacy/place-types), including all
  the added place types added in version 3.3.0.

- **Places SDK for Android (Legacy)** : Returns the enums defined by
  `Place.Types`, which does not include the new types added in version 3.3.0
  and later.

## Access place reviews

The Places SDK for Android (New) adds the
[`Review`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Review.md.txt)
class, which contains a review of a place. The `Place` object can contain up to
five reviews.

The `Review` class can also contain an attribution and an author attribution. If
you display the review in your app, then you must also display any attribution
or author attribution. For more information, see [Display a
review](https://developers.google.com/maps/documentation/places/android-sdk/legacy/policies#reviews).

For more information, see the documentation on
[attributions](https://developers.google.com/maps/documentation/places/ios-sdk/policies.md.txt#other_attribution_requirements).

## Access place name language code

In the Places SDK for Android (Legacy),
[`Place.getName()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt#public-abstract-string-getname)
method returns a text string containing the name of a place. To populate the
`Place` object with the place name, you must include the
`Place.Field.DISPLAY_NAME` in the field list of the place details request.

The `Place` object now contains the language code for the name string. To
populate the `Place` object with language code, you must:

1. Include the `Place.Field.DISPLAY_NAME` in the field list of the request.
   This value configures response to include both the place name and language
   code in the `Place` object.

2. Call
   [`PlacesClient.fetchPlace()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/net/PlacesClient.md.txt#fetchPlace(com.google.android.libraries.places.api.net.FetchPlaceRequest)).
   `PlacesClient.findCurrentPlace()` does not support the language code field.

3. Use the [`Place.getNameLanguageCode()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt#public-abstract-string-getnamelanguagecode)
   method to access the language code field in the `Place` object.

## Set region code

Places SDK for Android (New) adds the region code request parameter to
Place Details. The region code is used to format the response, specified as a
[two-character CLDR code](https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html)
value. This parameter can also have a bias effect on the search results. There
is no default value. You must enable the new SDK to set the region code.

If the country name of the address field in the response matches the region
code, the country code is omitted from address.

Most CLDR codes are identical to ISO 3166-1 codes, with some notable exceptions.
For example, the United Kingdom's ccTLD is "uk" (.co.uk) while its ISO 3166-1
code is "gb" (technically for the entity of "The United Kingdom of Great Britain
and Northern Ireland"). The parameter can affect results based on applicable
law.

## Example request

For a complete example, see [Place Details (Legacy)](https://developers.google.com/maps/documentation/places/android-sdk/details-place.md.txt).