Places API Usage and Billing

About field masks

For Place Details (New), Nearby Search (New), and Text Search (New), use the FieldMask header in API requests to specify the list of fields to return in the response. You are then billed at the highest SKU applicable to your request. That means if you select fields in both the Essentials and the Pro SKUs, you are billed based on the Pro SKU.

Using field masking is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.

About Autocomplete (New) sessions

An Autocomplete (New) session includes one or more Autocomplete (New) requests, and a Place Details (New) request or Address Validation request. The same session token is passed to the Autocomplete (New) request and to the subsequent Place Details (New) request or Address Validation request.

A session starts with the first Autocomplete (New) request. A Place Details (New) request or Address Validation request is then made when the user has selected one of the Autocomplete (New) suggestions. If a session is abandoned, meaning no Place Details (New) request or Address Validation request is made, Autocomplete (New) requests are charged as if no session token was provided.

After a user has selected a place (meaning a Place Details (New) request or Address Validation request is made), you must start a new session using a new session token.

A session token is good for one session and cannot be used for more than one session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token were provided.

SKU details and pricing for the Places API

The following table shows the SKU details and pricing for the Places API.

CategoryPlaces API (New) SKU detailsSKU Pricing
Essentials SKU: Autocomplete Requests Main pricing list
India pricing list
Essentials SKU: Autocomplete Session Usage Main pricing list
India pricing list
Essentials SKU: Place Details Essentials (IDs Only) Main pricing list
India pricing list
Essentials SKU: Place Details Essentials Main pricing list
India pricing list
Essentials SKU: Text Search Essentials (IDs Only) Main pricing list
India pricing list
Pro SKU: Nearby Search Pro Main pricing list
India pricing list
Pro SKU: Place Details Pro Main pricing list
India pricing list
Pro SKU: Text Search Pro Main pricing list
India pricing list
Enterprise SKU: Nearby Search Enterprise Main pricing list
India pricing list
Enterprise SKU: Nearby Search Enterprise Plus Main pricing list
India pricing list
Enterprise SKU: Place Details Enterprise Main pricing list
India pricing list
Enterprise SKU: Place Details Enterprise + Atmosphere Main pricing list
India pricing list
Enterprise SKU: Text Search Enterprise Main pricing list
India pricing list
Enterprise SKU: Text Search Enterprise + Atmosphere Main pricing list
India pricing list
Enterprise SKU: Place Details Photos Main pricing list
India pricing list
CategoryPlaces API (Legacy) SKU detailsSKU Pricing
Essentials SKU: Autocomplete - Per Request Main pricing list
India pricing list
Essentials SKU: Autocomplete (included with Place Details) - Per Session Main pricing list
India pricing list
Essentials SKU: Basic Data Main pricing list
India pricing list
Essentials SKU: Find Place - ID only Main pricing list
India pricing list
Essentials SKU: Place Details Essentials- ID Refresh Main pricing list
India pricing list
Essentials SKU: Query Autocomplete - Per Request Main pricing list
India pricing list
Pro SKU: Autocomplete without Place Details - Per Session Main pricing list
India pricing list
Pro SKU: Find Place Main pricing list
India pricing list
Pro SKU: Places - Nearby Search Main pricing list
India pricing list
Pro SKU: Places - Text Search Main pricing list
India pricing list
Pro SKU: Place Details Pro Main pricing list
India pricing list
Enterprise SKU: Atmosphere Data Main pricing list
India pricing list
Enterprise SKU: Contact Data Main pricing list
India pricing list
Enterprise SKU: Place Photos Main pricing list
India pricing list

Other usage limits

To review and manage your quotas and usage limits, see Quotas and quota alerts.

  • Places API (New): The rate limit per minute is per API method per project. Meaning each API method has a separate quota.

  • Places API: The rate limit per minute is calculated as the sum of client-side and server-side requests for all applications using the credentials of the same project.

Terms of Use restrictions

For information on terms of use, see policies for the Places API, and the License Restrictions section of the Google Maps Platform Terms of Service.