**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).

## Introduction

The response format for
[Place Details (New)](https://developers.google.com/maps/documentation/places/web-service/place-details.md.txt),
[Nearby Search (New)](https://developers.google.com/maps/documentation/places/web-service/nearby-search.md.txt),
and
[Text Search (New)](https://developers.google.com/maps/documentation/places/web-service/text-search.md.txt)
APIs has changed from the format of the legacy APIs. The main difference is in
the format of the `Place` object returned by each method, as described in
[Changes to the response Place object](https://developers.google.com/maps/documentation/places/web-service/legacy/migrate-response.md.txt#place-object).

In addition, the top level fields of the response object have also
changed for each API. See:

- [Text Search response changes](https://developers.google.com/maps/documentation/places/web-service/legacy/migrate-response.md.txt#text-response)
- [Nearby Search response changes](https://developers.google.com/maps/documentation/places/web-service/legacy/migrate-response.md.txt#nearby-response)
- [Place Details response changes](https://developers.google.com/maps/documentation/places/web-service/legacy/migrate-response.md.txt#details-response)

## Changes to the response Place object

This table shows the changes to the **new**
[`Place` object](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt)
in the response for Place Details (New),
Nearby Search (New), and
Text Search (New) in comparison to the **legacy**
[`Place` object](https://developers.google.com/maps/documentation/places/web-service/details#Place).

The new response object uses camel-casing for field names, contains new fields,
and renames some of the legacy fields.

| Field | Places API (Legacy) object | Places API (New) object | Notes |
|---|---|---|---|
| Address component | `address_components` | `addressComponents` |   |
| Place microformat address | `adr_address` | `adrFormatAddress` |   |
| Business status | `business_status` | `businessStatus` |   |
| Opening hours for next week | `current_opening_hours` | `currentOpeningHours` |   |
| Editorial summary | `editorial_summary` | `editorialSummary` |   |
| Formatted address | `formatted_address` | `formattedAddress` |   |
| National phone number | `formatted_phone_number` | `nationalPhoneNumber` |   |
| Location | `geometry.location` | `location` |   |
| Viewport | `geometry.viewport` | `viewport` |   |
| Place attributions | `html_attributions` | `attributions` | Top-level field of the response in the legacy APIs |
| Icon URL | `icon` |   | Removed. Use `iconMaskBaseUri` and `iconBackgroundColor`. See [Place icons](https://developers.google.com/maps/documentation/places/web-service/icons.md.txt) for more information. |
| Icon background color | `icon_background_color` | `iconBackgroundColor` |   |
| Icon mask URL | `icon_mask_base_uri` | `iconMaskBaseUri` |   |
| International phone number | `international_phone_number` | `internationalPhoneNumber` |   |
| Text place name | `name` | `displayName` | Text place name is now accessible as `displayName.text` and `language` as `displayName.languageCode` |
| Opening hours | `opening_hours` | `regularOpeningHours` |   |
| Photos | `photos` | `photos` | The format of `photos` has changed in the new `Place` object. For more information, see [Change to photo references](https://developers.google.com/maps/documentation/places/web-service/migrate-photo#photo-ref). |
| Place ID | `place_id` | `id` |   |
| Plus code | `plus_code` | `plusCode` |   |
| Price level | `price_level` | `priceLevel` |   |
| Rating | `rating` | `rating` |   |
| Reviews | `reviews` | `reviews` |   |
| Secondary opening hours for next week from today, with exceptions and all other data | `secondary_opening_hours` | `currentSecondaryOpeningHours` |   |
| Place types | `types` | `types` |   |
| Google Maps URL of the place | `url` | `googleMapsUri` |   |
| Number of user ratings | `user_ratings_total` | `userRatingCount` |   |
| UTC offset | `utc_offset` | `utcOffsetMinutes` |   |
| Short form of the address including the street name and town | `vicinity` | `shortFormattedAddress` |   |
| Place website | `website` | `websiteUri` |   |
| Wheelchair-accessibility information | `wheelchair_accessible_entrance` | `accessibilityOptions` | `wheelchair_accessible_entrance` is now at `accessibilityOptions.wheelchairAccessibleEntrance` |
| Places attributes | `takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food` | `takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood` |   |
| Resource name |   | `name` field in the form `places/PLACE_ID` | In the legacy API, the `name` field contained the place name as a text string. In the new API, that information is in `displayName`. |
| Place primary type |   | `primaryTypeName` | New |
| Place primary type as a text string |   | `primaryTypeDisplayName` | New |
| Regular weekly secondary opening hours, with exceptions and all other data |   | `regularSecondaryOpeningHours` | New |
| Payment options the place accepts |   | `paymentOptions` | New |
| Place parking options |   | `parkingOptions` | New |
| List of sub-destinations related to the place |   | `subDestinations` | New |
| Most recent information about fuel options in a gas station |   | `fuelOptions` | New |
| EV charging Information for a place |   | `evChargeOptions` | New |
| Places attributes |   | `outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports` | New |

## Text Search response changes

The following table shows the changes to the top-level fields of the
[response object](https://developers.google.com/maps/documentation/places/web-service/search-text#PlacesTextSearchResponse)
for Text Search (Legacy) and the
[response object](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/searchText.md.txt#response-body)
for Text Search (New). For the new API, the only top-level field in the
response is the `places` array.

| Field | Text Search (Legacy) | Text Search (New) | Notes |
|---|---|---|---|
| Place attributions | `html_attributions` |   | Moved into the new [Place](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt) object for each place as `place.attributions` |
| Array of places | `results` array of the legacy [Place](https://developers.google.com/maps/documentation/places/web-service/search-text#Place) object | `places` array of the new [Place](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt) object |   |
| Status of the request | `status` |   | Moved to the standard HTTP response (HTTP response code and message) |
| Any error messages | `error_message` |   | Moved to the standard HTTP response (HTTP response code and message) |
| Any info messages | `info_messages` |   | Removed |
| Page token | `next_page_token` |   | Removed |

## Nearby Search response changes

The following table shows the changes to the top-level fields of the [response
object](https://developers.google.com/maps/documentation/places/web-service/search-nearby#PlacesNearbySearchResponse)
for the Nearby Search (Legacy) and the [response
object](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/searchNearby#response-body)
for Nearby Search (New). For the new API, the only top-level field in the
response is the `places` array.

| Field | Nearby Search (Legacy) | Nearby Search (New) | Notes |
|---|---|---|---|
| Place attributions | `html_attributions` |   | Moved into the new [Place](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt) object for each place as `place.attributions` |
| Array of places | `results` array of the legacy [Place](https://developers.google.com/maps/documentation/places/web-service/search-text#Place) object | `places` array of the new [Place](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt) object |   |
| Status of the request | `status` |   | Moved to the standard HTTP response (HTTP response code and message) |
| Any error messages | `error_message` |   | Moved to the standard HTTP response (HTTP response code and message) |
| Any info messages | `info_messages` |   | Removed |
| Page token | `next_page_token` |   | Removed |

## Place Details (New) response changes

The following table shows the changes to the top-level fields of the [response
object](https://developers.google.com/maps/documentation/places/web-service/details#PlacesDetailsResponse)
for Place Details (Legacy) and the [response
object](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/get#response-body)
for Place Details (New). For the new API, the only top-level field in the
response is the `places` array.

| Field | Place Details (Legacy) | Place Details (New) | Notes |
|---|---|---|---|
| Place attributions | `html_attributions` |   | Moved into the new [Place](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt) object as `attributions` |
| Place Details (New) | `result` containing the legacy [Place](https://developers.google.com/maps/documentation/places/web-service/details#Place) object | The new [Place](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt) object |   |
| Status of the request | `status` |   | Moved to the standard HTTP response (HTTP response code and message) |
| Any info messages | `info_messages` |   | Moved to the standard HTTP response (HTTP response code and message) |