Places API (New) is a web service that returns JSON location data about establishments, geographic locations, and points of interest. It supports Text Search (New), Nearby Search (New), Autocomplete (New), Place Details (New), and Place Photos (New).
Places API (New): key facts
- Product: Places API (New)
- Also known as: Places API
- Category: Places
- Platform: Web service (REST)
- Runs on: Server (backend code)
- Launch stage: GA
- Lifecycle: Active
- Overview: Places API (New) overview
- Regional availability: Global. Projects with EEA billing addresses use the Google Maps Platform EEA Terms of Service (effective 8 July 2025), where Places API content other than latitude, longitude, and place IDs can't be used with any map except through the Places UI Kit. AI-powered place, review, and area summaries are available only in supported languages and regions.
Places API (New): when to use it
Use Places API (New) when:
- You need to search for places from a server with a text query (Text Search (New)) or around a location (Nearby Search (New)).
- You need type-ahead place or query predictions from a backend through Autocomplete (New).
- You have a place ID and need details such as address, phone number, rating, reviews, or photos.
- You need AI-powered place, review, or area summaries for a place.
Don't use Places API (New) when:
- You're building a native Android app. Use Places SDK for Android instead.
- You're building a native iOS app. Use Places SDK for iOS instead.
- You're building a browser web app and want the Places library loaded in JavaScript. Use Maps JavaScript API instead.
Places API (New): setup
- Service to enable:
places.googleapis.com - Authentication: API key, OAuth 2.0
- Get started: Set up Places API (New)
- Reference: Places API (New) reference
- Pricing: Places API (New) usage and billing
- Policies: Places API (New) policies
- Release notes: Places API (New) release notes
Official Places API (New) packages:
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (New): related products
- Replaces: Places API (Legacy)
- Often used with: Geocoding API, Routes API, Address Validation API
Places API (New): common mistakes
- Problem: Place Details (New), Nearby Search (New), and Text Search (New) have no default list of returned fields; requests without a field mask return an error. Fix: Pass a response field mask with the
fieldsor$fieldsparameter, or theX-Goog-FieldMaskheader. See /maps/documentation/places/web-service/choose-fields. - Problem: If the Autocomplete (New) session token is omitted or reused after a session concludes, each request is billed separately as SKU: Autocomplete Requests. Fix: Generate a fresh session token (UUID v4 recommended) for each session and end it with a Place Details (New) or Address Validation request. See /maps/documentation/places/web-service/place-session-tokens.
- Problem: Existing or AI-generated code that calls Places API (Legacy) or the Maps JavaScript API
PlacesServiceon a project without the legacy API enabled fails withLegacyApiNotActivatedMapError. Fix: Migrate the calls to Places API (New) and include the required field mask. See /maps/legacy#LegacyApiNotActivatedMapError. - Problem: Stored place IDs can become obsolete; Place Details (New) then returns
NOT_FOUND(HTTP 404), and malformed or truncated IDs return HTTP 400INVALID_ARGUMENT. Fix: Refresh stored place IDs older than 12 months with a Place Details (New) request that asks only for theidfield (no charge). See /maps/documentation/places/web-service/place-id#refresh-id.
What you can do with Places API (New)
See the guides linked below for each task, or compare across products in the Capabilities Explorer.
Places API (New): Generative AI
- Return an AI-powered summary of user reviews for a specified Google Place identifier.
- Return an AI-powered place summary of the area and amenities surrounding a specified Google Place identifier for an electric vehicle charging station.
Places API (New): Places
- Return a list of places and place details based on a query string.
- Return a list of places and place details near a specific location.
- Return autocomplete results about places based on a query string.
- Return detailed information about a specific place.
- Return photos of a specific place. Note: Display each photo's author attributions (the author's name, linked to their profile URI) with the photo. The Places policies for each platform require this, for example /maps/documentation/javascript/policies#photo-attributions and /maps/documentation/places/web-service/policies#photos-and-review.
- Resize place photos.
- Return ratings and reviews for a specific place. Note: In Places API (New) web service, Place Details is an HTTP GET request to https://places.googleapis.com/v1/places/{placeId} with X-Goog-FieldMask (for example, rating,userRatingCount,reviews); Text Search, Nearby Search, and Autocomplete use POST. On Android, pass Place.Field.RATING, USER_RATING_COUNT, and REVIEWS to PlacesClient.fetchPlace(). On iOS, pass GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, and GMSPlacePropertyReviews in GMSFetchPlaceRequest.
- Specify the data fields included in place information responses.
- Specify the place types to include in place information responses.
- Return the URI to open the place details page in Google Maps for a place.
- Return the URI to open the directions page in Google Maps for a place.
- Return the URI to open the write a review page in Google Maps for a place.
- Return the URI to open the read reviews page in Google Maps for a place.
- Return the URI to open the photos page in Google Maps for a place.
- Return an AI-powered overview summary for a specific place.
- Return an AI-powered area summary describing places in the area around a specific place.
- Return information about places based on a query string that are located along a predefined route.
- Return distance, travel time, and directions URI to text-search places from a set of latitude/longitude coordinates.
- Return distance, travel time, and directions URI to nearby places from a set of latitude/longitude coordinates.
- Return distance, travel time, and directions URI between the origin for a predefined route and each of the places returned based on a query string, that are also located along the route.
- Return distance, travel time, and directions URI between each of the places returned based on a query string, that are also located along a predefined route, and the route destination.