Places API Usage and Billing

Billing and pricing for the Places API

For information about how Google calculates your billing and pricing, see Google Maps Platform pricing list or Google Maps Platform pricing list - India.

Places (New) product SKUs

Click the info info icon to see the table of contents for this page. The following sections outline the details for each SKU:

Category Whether the SKU falls into the Essentials, Pro, or Enterprise SKU category.
Billable event What event is billed for the SKU.
Triggers What code elements trigger billable events.
Pricing Links to the pricing table for that SKU's group.

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: Autocomplete Requests

This SKU bills for requests to the Autocomplete API that don't use a session. For information on using session to limit the number of requests that are billed during a single Autocomplete session, see Session tokens or SKU: Autocomplete Session Usage.

  Category Essentials
  Billable event Request
  Triggers

This SKU is triggered under the following conditions:

  • Your request does not include a session token.
  • Your request includes a session token, but you abandon the session.
  • Your request includes a session token, but you terminate the session under certain conditions. For information about Autocomplete Session Usage, see Session tokens or Autocomplete Session Usage.
  Pricing Main pricing table
India pricing table

SKU: Autocomplete Session Usage

This SKU bills for each request to the Autocomplete (New) API that includes a session token.

  Category Essentials
  Billable event Request
  Triggers

This SKU is triggered when you send a request to the Autocomplete (New) API that includes a session token.

This SKU acts as a wrapper for the Autocomplete (New) requests SKU that provides a way for you to limit the number of requests that are billed during a single Autocomplete session. For information about Autocomplete Session Usage, see Session tokens.

For more information, see Autocomplete (New) and session pricing.

  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Essentials (IDs Only)

This SKU bills for requests to Place Details that only return the Place ID.

  Category Essentials
  Billable event Request with the specified field masks.
  Triggers

This SKU is triggered when you request the following fields:

Fields for Web service

attributions
id
name*
photos

* The name field contains the place resource name in the form: places/PLACE_ID. Use displayName to access the text name of the place.
  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Essentials

This SKU bills for requests to the Place Details API that retrieve the fields in this SKU.
  Category Essentials
  Billable event Request with the specified field masks.
  Triggers

This SKU is triggered when you request the following location fields:

Fields for Web service

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Pro

This SKU bills for fields you specify in a Place Details Pro request.

  Category Pro
  Billable event Request with the specified field masks.
  Triggers This SKU is triggered when you only request the following fields or lower-rate fields:

Fields for Web service

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* The googleMapsLinks field is in the pre-GA Preview stage and there is no charge, meaning billing is $0, for usage during Preview.

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Enterprise

This SKU bills for a Places request that includes Enterprise fields.

  Category Enterprise
  Billable event Request with the specified field masks.
  Triggers This SKU is triggered when you request the following fields:

Fields for Web service

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

If you terminate an Autocomplete session with a Place Details call that requests any field from the SKU: Place Details Essentials, Pro, Enterprise, or Enterprise + Atmosphere, then the call is billed at SKU: Place Details Enterprise + Atmosphere. For more information, see SKU: Autocomplete Session Usage.
  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Enterprise + Atmosphere

This SKU bills for calls to the Place Details API that request the specified atmosphere fields.

  Category Enterprise
  Billable event Request
  Triggers

This SKU is triggered when you request the following fields:

Fields for Web service

allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeOptions
fuelOptions
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout

* Text Search and Nearby Search only

If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details Essentials, Pro, Enterprise, or Enterprise + Atmosphere, then the call is billed at SKU: Place Details Enterprise + Atmosphere. For more information, see SKU: Autocomplete Session Usage.
  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Nearby Search Pro

This SKU bills for fields you specify in a Nearby Search Pro request.

  Category Pro
  Billable event Request with the specified field masks.
  Triggers This SKU is triggered when you only request the following fields or lower-rate fields:

Fields for Web service

places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.attributions
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* The places.googleMapsLinks field is in the pre-GA Preview stage and there is no charge, meaning billing is $0, for usage during Preview.

** The places.name field contains the place resource name in the form: places/PLACE_ID. Use places.displayName to access the text name of the place.

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Nearby Search Enterprise

This SKU bills for Nearby Search requests that include any Enterprise fields.

  Category Enterprise
  Billable event Request with the specified field masks.
  Triggers

This SKU is triggered when you request the following fields:

Fields for Web service

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Nearby Search Enterprise + Atmosphere

This SKU bills for nearby search requests that include the specified atmostphere fields.

  Category Enterprise
  Billable event Request
  Triggers

This SKU is triggered when you request the following fields:

Fields for Web service

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeOptions
places.fuelOptions
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout

* Text Search and Nearby Search only
  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Text Search Essentials (IDs Only)

This SKU is billed for requests to the Text Search API that only return IDs.
  Category Essentials
  Billable event Request with the specified field masks.
  Triggers

This SKU is triggered when you request only the following fields:

Fields for Web service

places.attributions
places.id
places.name*
nextPageToken

* The places.name field contains the place resource name in the form: places/PLACE_ID. Use places.displayName to access the text name of the place.
  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Text Search Pro

This SKU is a Data SKU that bills for fields you specify in a Text Search Pro request.
  Category Pro
  Billable event Request with the specified field masks.
  Triggers This SKU is triggered when you only request the following fields or lower-rate fields:

Fields for Web service

places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* The places.googleMapsLinks field is in the pre-GA Preview stage and there is no charge, meaning billing is $0, for usage during Preview.

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Text Search Enterprise

This SKU bills for Text Search requests that include any Enterprise fields.

  Category Enterprise
  Billable event Request with the specified field masks.
  Triggers This SKU is triggered when you request the following fields:

Fields for Web service

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Places API Text Search Enterprise + Atmosphere

This SKU bills for Text Search requests that include any atmosphere fields.

  Category Enterprise
  Billable event Request
  Triggers This SKU is triggered when you request the following fields:

Fields for Web service

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeOptions
places.fuelOptions
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout

* Text Search and Nearby Search only

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Place Details Photos

This SKU bills for Place Details Photos requests.

  Category Enterprise
  Billable event Request
  Triggers Billing is triggered when you request a photo from the Place Details API.
  Pricing Main pricing table
India pricing table

Legacy Places product SKUs

About Autocomplete sessions

An Autocomplete session includes some Autocomplete requests (to retrieve suggestions on a place as the user types), and at most one Places Details request (to retrieve details about the place selected by the user). The same session token is passed to the Autocomplete and the subsequent Place Detail request. A session starts with the first Autocomplete request (which typically happens when the user starts typing). A Places Details call is made when the user has selected one of the Autocomplete suggestions. If a user does not select a suggestion, no Places Details call is made.

After a user has selected a place (that is, after a Places Details call is made), you must start a new session using a new session token.

Autocomplete sessions can be generated from the following APIs:

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

The Autocomplete requests and the Places Details requests using sessions are billed on different SKUs.

About Places Data SKUs

The three Places Data SKUs are: Basic Data, Contact Data, and Atmosphere Data.

One or more Data SKUs are triggered for:

  • Android: each request to fetchPlace() or findCurrentPlace()
  • iOS: each call to fetchPlaceFromPlaceID: or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Web service: each Places request depending on the fields specified in the request

Data SKUs are always charged in addition to the base SKU for the request triggering them. For example, a Place Details request including Basic Data fields will be charged both under the Basic Data SKU and the Place Details SKU.

For the web service, these Places APIs requests allow you to specify the data fields to return:

For the web service, these Places APIs calls DO NOT support specifying the returned fields. These calls always return all the Places data, charging the three Places Data SKUs in addition to the charge for each API request:

SKU: Basic Data

This SKU is a Data SKU that bills for Basic Data fields in a Place Details or Find Place request. This SKU is charged in addition to the base SKU for the request that triggered it.

Fields in the Basic category are included in the base cost of the Places request and don't result in any additional charge.

  Category Essentials
  Billable event Request with the specified field masks.
  Triggers The Basic Data SKU is triggered when you request any of these fields:

Fields for Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
   * Use instead of Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (deprecated)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Use instead of Place.Field.NAME (deprecated)
Place.Field.FORMATTED_ADDRESS*
   * Use instead of Place.Field.ADDRESS (deprecated)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Use instead of Place.Field.ICON_URL (deprecated)
Place.Field.ID
Place.Field.LOCATION*
   * Use instead of Place.Field.LAT_LNG (deprecated)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Fields for iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Fields for Web service

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Contact Data

This SKU is a Data SKU that bills for Contact Data fields in a Place Details or Find Place request. This SKU is charged in addition to the base SKU for the request that triggered it.

Using the fields parameter in your Place Details or Find Place request for web services, or an array of Place.Fields for Android or iOS, you can limit the response to only those fields specified. Fields in the Contact category result in an additional charge.

  Category Enterprise
  Billable event Request with the specified field masks.
  Triggers The Contact Data SKU is triggered when any of these fields are requested:

Fields for Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Use instead of Place.Field.PHONE_NUMBER (deprecated).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Fields for iOS SDK

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Fields for Web service

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Field mask billing

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Atmosphere Data

This SKU bills for requests to the Atmosphere Data API that specify the fields in this SKU.

  Category Enterprise
  Billable event Request with the specified field masks.
  Triggers Billing is triggered when you request any of these fields:
  Field mask billing examples

Your request is billed based on the fields provided in the field mask. For example:

  • If your field mask only includes fields from this SKU: The request is billed at the rate for this SKU.
  • If your field mask includes fields from other SKUs: The request is billed at the highest SKU rate for the fields requested. For example, if you include fields from both an Essentials SKU and an Enterprise SKU, then the request is billed at the Enterprise SKU rate.
  Pricing Main pricing table
India pricing table

SKU: Autocomplete – Per Request

This SKU bill for requests that don't include a session token

If you make a request from an invalid Autocomplete session (for example, a session that reuses a session token), you are also charged an Autocomplete – Per Request SKU.

Autocomplete requests from the Maps JavaScript API Place Autocomplete Widget may be charged an Autocomplete – Per Request SKU when you make requests from an invalid Autocomplete session. This situation may happen when a user is typing or copy/pasting multiple different addresses into the widget and doesn't always select an autocomplete prediction.

  Category Essentials
  Billable event Request
  Triggers Billing is triggered for :
  Pricing Main pricing table
India pricing table

SKU: Autocomplete without Place Details – Per Session

This SKU bills when for an Autocomplete session that does not include a Place Details request (within a few minutes of the beginning of the session).

  Category Pro
  Billable event Session
  Triggers Billing is triggered if your application issues these two requests in a single session:

When viewing your bill by SKU, you see this SKU listed:

  • Autocomplete without Place Details – Per Session
  Pricing Main pricing table
India pricing table

SKU: Autocomplete (included with Place Details) – Per Session

Requests for autocomplete are available at no charge. This SKU bills when you request subsequent Place Details based on regular Place Details pricing.

  Category Essentials
  Billable event Session
  Triggers The Autocomplete (included with Place Details) – Per Session SKU is charged for an Autocomplete session that requests place details. Specifically:
  • Android: a call to fetchPlace()
  • iOS: a call to fetchPlaceFromPlaceID:
  • Web service: a Place Details request

Fields in the request:

Be sure to specify the fields you need in the request to avoid unnecessary charges. Depending what fields you specify, a Place Details request also generates these Data SKUs:

If you don't specify fields in the Place Details request, all Data SKUs are triggered.

If you request only a refresh of the Place Details ID (your request only specifies the place_id field) during an autocomplete session, the session is billed as SKU: Autocomplete without Place Details – Per Session.
  Examples

This example illustrates a series of requests, by platform, that would results in the following SKUs in your bill, when you view your bill by SKU:

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Basic Data

Example request by platform:

Android requests

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (with a FetchPlaceRequest including the Place ID, and the ADDRESS field)

iOS requests

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (including the Place ID, and the GMSPlaceFieldFormattedAddress field)

Web service requests

Places Autocomplete Request (input="par", session_token: XYZ)
Places Autocomplete Request (input="paris", session_token: XYZ)
Places Details (place_id, session_token: XYZ, fields:formatted_address)

  Pricing Main pricing table
India pricing table

SKU: Query Autocomplete – Per Request

This legacy SKU bills for Query Autocomplete requests.

  Category Essentials
  Billable event Request
  Triggers

This SKU is triggered when you make a Query Autocomplete request using the following services:

Pricing by Autocomplete session is not supported using Query Autocomplete. Subsequent Place Details requests get charged based on the Place Details Pro SKU.

  Pricing Main pricing table
India pricing table

SKU: Place Details Pro

This SKU bills for legacy Place Details requests.

  Category Pro
  Billable event Request
  Triggers Billing is triggered for requests from the following APIs:

With the web API and services, the Place Details SKU is charged whether you provide a session token or not.

This SKU also triggers billing for Data SKUs: If you include data fields in your request, it can trigger additional billing for Data SKUs: Basic, Contact, and Atmosphere. Specify only the data fields that you want to avoid unnecessary costs. You are billed for this SKU as well as for the data you request.
  Examples
  1. Make one of these calls or requests:
    • Mobile: call fetchPlace() on Android or fetchPlaceFromPlaceID: on iOS, and specify just the ADDRESS field
    • Web API or service: make a Place Details request and specify just the address field: getPlaceDetails(fields: formatted_address)
    On your bill, you will see these SKUs listed (when viewing your bill by SKU):
    • Place Details
    • Basic Data
  2. Make one of these calls or requests:
    • Mobile: call fetchPlace() on Android or fetchPlaceFromPlaceID: on iOS, and specify just the PHONE_NUMBER field
    • Web API or service: make a Place Details request and specify the phone number field: getPlaceDetails(fields: formatted_phone_number)
    On your bill, you will see these SKUs listed (when viewing your bill by SKU):
    • Place Details
    • Contact Data
  3. Make one of these calls or requests:
    • Mobile: call fetchPlace() on Android or fetchPlaceFromPlaceID: on iOS, and specify all the fields
    • Web API or service: make a Place Details request and specify all the fields (this type of request is the default if you don't specify any fields): getPlaceDetails().
    On your bill, you will see these SKUs listed (when viewing your bill by SKU):
    • Place Details
    • Basic Data
    • Contact Data
    • Atmosphere Data
  Pricing Main pricing table
India pricing table

SKU: Place Details – ID Refresh

This SKU bills for requests to the Place Details API that refresh stale place IDs.

  Category Essentials
  Billable event Request
  Triggers Billing is triggered when you make a Place Details request specifying just the Place ID field:getPlaceDetails(fields: place_id).
  Pricing Main pricing table
India pricing table

SKU: Find Place

This SKU bills for requests to Find Place that return more fields than just the Place ID.

This SKU also triggers billing for Data SKUs: If you include data fields in your request, it can trigger additional billing for Data SKUs: Basic, Contact, and Atmosphere. Specify only the data fields that you want to avoid unnecessary costs. You are billed for this SKU as well as for the data you request.

  Category Pro
  Billable event Request
  Triggers This SKU bills for requests to the following methods:
  • Find Current Place

This SKU also triggers billing for Data SKUs: If you include data fields in your request, it can trigger additional billing for Data SKUs: Basic, Contact, and Atmosphere. Specify only the data fields that you want to avoid unnecessary costs. You are billed for this SKU as well as for the data you request.
  Examples

The following examples show what SKUs you are billed for when making a Find Current Place request and specifying fields from the Basic, Contact, and Atmosphere data SKUs. To see the SKUs on your bill, view your bill by SKU as described in Analyze the usage and cost per SKU.

You make a Find Place request with just the ADDRESS field:

Your bill shows these SKUs:

  • Find Current Place
  • Basic Data

You make a Find Place request with just the PHONE_NUMBER field:

Your bill shows these SKUs:

  • Find Current Place
  • Contact Data

You make a Find Place request with all three data-type fields:

Your bill shows these SKUs:

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Pricing Main pricing table
India pricing table

SKU: Find Place – ID only

This SKU bills for requests to Find Place that only return the Place ID. By default, if you don't specify any fields in the Find Place request, only the place ID is returned.

  Category Essentials
  Billable event Request
  Triggers You make a Find Place request without any fields specified, or you only specify the place_id field: FindPlace(fields: place_id).
  Pricing Main pricing table
India pricing table

SKU: Places – Nearby Search

This SKU bills for legacy Nearby Search requests.

  Category Pro
  Billable event Request
  Triggers This SKU is triggered when you make a Nearby Search request using one of the following APIs:

This request doesn't support specifying which fields to return. The response returns a list of places and a subset of the supported data fields.

This SKU also triggers billing for Data SKUs: If you include data fields in your request, it can trigger additional billing for Data SKUs: Basic, Contact, and Atmosphere. Specify only the data fields that you want to avoid unnecessary costs. You are billed for this SKU as well as for the data you request.
  Examples

You make a Nearby Search request, such as NearbySearch (San Francisco, 100 meters). Your bill shows these SKUs when viewing your bill by SKU:

  • Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Pricing Main pricing table
India pricing table

SKU: Places – Text Search

This SKU bills for requests to the legacy Places Text Search service.

  Category Pro
  Billable event Request
  Triggers Billing is triggered for requests to the following services:

Text Search requests return a list of places, but don't support specifying which fields are returned. Text Search requests return a subset of the supported data fields. You are charged for the Text Search request as well as all of the data-type SKUs: Basic Data, Contact Data, and Atmosphere Data.

The Place – Text Search SKU is also triggered by the Maps JavaScript API Place SearchBox widget: getPlaces() method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:

Places Details Search Box Widget Query Selection
In the results of the search box widget, after typing "pizza" in the search box, notice that pizza delivery has a magnifier icon next to it, indicating that it is a place query (and not a result).
  Example

If you make a Text Search request, such as TextSearch(123 Main Street), your bill shows these SKUs when viewing your bill by SKU:

  • Place - Text Search
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Photos

This SKU bills for the legacy Places Photo service.

  Category Enterprise
  Billable event Request
  Triggers Billing is triggered for :
  Pricing Main pricing table
India pricing table

Other usage limits

While there is no maximum number of requests per day, the following usage limits still apply:

  • Places API (New): Rate limit is 600 QPM (requests per minute) per API method per project. Meaning each API method has a separate quota.

  • Places API: Rate limit is 6,000 QPM (requests per minute). It 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.