Places API Usage and Billing

Reminder: To use the Places API, you must enable billing on each of your projects and include an API key or OAuth token with all API or SDK requests.

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.

Note: Session tokens can overlap across projects, but they must be unique per project. For example, an app using Project A and an app using Project B can use the same session token, while multiple apps using Project A cannot use the same 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. Note: If you don't use sessions with Autocomplete (New), you are billed per-request to Autocomplete using the SKU: Autocomplete Requests. 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Essentials
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Essentials
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following location fields: Web service: addressComponents adrFormatAddress formattedAddress location plusCode shortFormattedAddress types viewport
	Field mask billing examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per 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: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Enterprise
	Billable event	Request
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per 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: 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.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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Enterprise
	Billable event	Request
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Essentials
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request only the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per 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: 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.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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

	Category	Enterprise
	Billable event	Request
	Triggers	This SKU is triggered when you request the following fields: 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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:

• The Places API Place Autocomplete service or the Maps JavaScript API Places Autocomplete service. You need to design your application to provide session tokens (you may need to change your existing code).
• The Maps JavaScript API Autocomplete widget. Session-based billing is automatically enabled on those widgets, without any code change required.

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:

• Places Details Pro
• Find Place

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:

• Places – Nearby Search
• Places – Text Search

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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

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: Android: Place.Field.ACCESSIBILITY_OPTIONS Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME Place.Field.FORMATTED_ADDRESS Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL Place.Field.ID Place.Field.LOCATION Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.TYPES Place.Field.VIEWPORT Place.Field.UTC_OFFSET. Deprecated fields:The following fields were deprecated in version 4.0 of the Places SDK for Android: Place.Field.ADDRESS, Place.Field.ICON_URL, Place.Field.LAT_LNG, Place.Field.NAME, and Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE fields Instead, use Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_MASK_URL, Place.Field.LOCATION, Place.Field.DISPLAY_NAME and Place.ACCESSIBILITY_OPTIONS, respectively. Place.Field.ACCESSIBILITY_OPTIONS is only available for Place Details (New). iOS: GMSPlaceFieldFormattedAddress GMSPlaceFieldBusinessStatus GMSPlaceFieldID GMSPlaceFieldCoordinate GMSPlaceFieldName GMSPlaceFieldPhotos GMSPlaceFieldPlusCode GMSPlaceFieldTypes GMSPlaceFieldViewport 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 examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

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: Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, or Place.Field.WEBSITE_URI Deprecated fields:The Place.Field.PHONE_NUMBER field was deprecated in version 4.0 of the Places SDK for Android. Instead, use Place.Field.INTERNATIONAL_PHONE_NUMBER. iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber, or GMSPlaceFieldWebsite Web service: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours, or website
	Field mask billing examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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.

Note: This API bills different SKUs for different fields. Specify the fields you want in your request using a field mask, field list, or for Android or iOS, a field array. If you include any fields from a higher-priced SKU, then your request is billed at the higher rate. You are only charged for one SKU per request.

Note: This SKU is a Data SKU, so you are charged for these fieldsin addition to the base SKU for the request that triggered it.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	Billing is triggered when you request any of these fields: AndroidiOSJavaScript Place.Field.CURBSIDE_PICKUP Place.Field.DELIVERY Place.Field.EDITORIAL_SUMMARY Place.Field.DINE_IN Place.Field.PRICE_LEVEL Place.Field.RATING Place.Field.RESERVABLE Place.Field.SERVES_BEER Place.Field.SERVES_BREAKFAST Place.Field.SERVES_BRUNCH Place.Field.SERVES_DINNER Place.Field.SERVES_LUNCH Place.Field.SERVES_VEGETARIAN_FOOD Place.Field.SERVES_WINE Place.Field.TAKEOUT Place.Field.USER_RATING_COUNT Deprecated fields: The Place.Field.USER_RATINGS_TOTAL field was deprecated in version 4.0 of the Places SDK for Android. Use Place.Field.USER_RATING_COUNT instead. GMSPlaceFieldPriceLevel GMSPlaceFieldRating GMSPlaceFieldUserRatingsTotal GMSPlaceFieldTakeout GMSPlaceFieldDelivery GMSPlaceFieldDineIn GMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable GMSPlaceFieldServesBreakfast GMSPlaceFieldServesLunch GMSPlaceFieldServesDinner GMSPlaceFieldServesBeer GMSPlaceFieldServesWine GMSPlaceFieldServesBrunch GMSPlaceFieldServesVegetarianFood. See Fields (Place details) curbside_pickup delivery dine_in, editorial_summary price_level rating reservable reviews serves_beer serves_breakfast serves_brunch serves_dinner serves_lunch, serves_vegetarian_food serves_wine takeout user_ratings_total.
	Field mask billing examples	These are examples of how the request is billed based on the fields you select in the field mask. If your request field mask only includes fields from this SKU: The request is billed at this SKU rate. For example, you can request one or more fields from this SKU, and are billed at this SKU rate. If your request 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 several SKUs, such as 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 : Android: findAutocompletePredictions() iOS: findAutocompletePredictionsFromQuery: JavaScript: The Maps JavaScript API's Place Autocomplete service Web service: The Places API Place Autocomplete service
	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: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... Web service Place Autocomplete Request (input="par", session_token: XYZ) Place Autocomplete Request (input="paris", session_token: XYZ) 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

Note: You can see this SKU in billing reports, but not on the Billing > Pricing page in the Google Cloud console.

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 includes any of the following requests: Android: a call to fetchPlace() iOS: a call to fetchPlaceFromPlaceID: Web service: a Place Details request A Place Details request generates Data SKUs (Basic, Contact, and/or Atmosphere) – depending on the fields that you specify in the request. If you don't ask for specific fields in the Place Details request, all Data SKUs are triggered (Essentials, Pro, Enterprise, and Enterprise + Atmosphere). Specify only the fields you need to avoid unnecessary charges. 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	If your application issues the following three calls in a single session: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (with a FetchPlaceRequest including the Place ID, and the ADDRESS field) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (including the Place ID, and the GMSPlaceFieldFormattedAddress field) Web service Web service 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) On your bill, you will see these SKUs listed (when viewing your bill by SKU): Autocomplete (included with Place Details) – Per Session Place Details Basic Data
	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: JavaScript: the Maps JavaScript API Places Autocomplete Service (getQueryPredictions()) and the use of the Maps JavaScript API SearchBox widget (Query Autocomplete requests are generated as the user types). Web service: the Places API Query Autocomplete service 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: Android: Places SDK for Android (fetchPlace()) iOS: Places SDK for iOS (fetchPlaceFromPlaceID:) JavaScript: Maps JavaScript API Place Details service (getDetails) JavaScript: Maps JavaScript API Place Autocomplete widget (getPlace) JavaScript: Maps JavaScript API Place SearchBox widget: getPlaces() method after the user selects a place result (icon: pin), *not* a query (icon: magnifier), as illustrated here: In the results of the search box widget, after typing "pizza" in the search box, notice that Pizza Autentico has a pin icon next to it, indicating that it is a place result (and not a query). Web service: Places API Place Details service 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	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 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 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 and specify just the address field: FindPlace(fields: formatted_address). Your bill shows these SKUs: Find Place Basic Data You make a Find Place request and specify the phone number field: FindPlace(fields: formatted_phone_number). Your bill shows these SKUs: Find Place Contact Data You make a Find Place request and specify fields from all three data-type buckets: FindPlace(fields: formatted_address, opening_hours, price_level). Your bill shows these SKUs: Find 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 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: Maps JavaScript API Place Nearby Search service (nearbySearch()) Places API Nearby Search service 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 Places Text Search service.

	Category	Pro
	Billable event	Request
	Triggers	Billing is triggered for requests to the following services: Maps JavaScript API Place Text Search service (textSearch()). Places API Text Search service 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: 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 : Android: calls to fetchPhoto() iOS: calls to loadPlacePhoto: JavaScript: to Places Library, Maps JavaScript API's Place Photos service when requesting data from the URLs returned by PlacePhoto.getUrl() to load image pixel data. It doesn't trigger billing until the URL is actually used to obtain pixel data. Web service: requests to the Places API Place Photos service
	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.

---