Places SDK for Android Usage and Billing

Error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

Click the info info icon to see the table of contents for this page.

Billing and pricing for the Places SDK for Android

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

Places SDK for Android product SKU details

About field masks

Use field masks, also called field lists, in your 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 (Basic) SKU and the (Advanced) SKU, you are billed based on the (Advanced) SKU.

Using a field mask 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. 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.

	Category	Essentials
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: Android: `Place.Field.DISPLAY_NAME` `Place.Field.ID` `Place.Field.PHOTO_METADATAS` `Place.Field.RESOURCE_NAME` Deprecated fields: The `Place.Field.NAME` field was deprecated in version 4.0 of the Places SDK for Android. Instead use `Place.Field.DISPLAY_NAME`. The `RESOURCE_NAME` field contains the place resource name in the form: `places/PLACE_ID`. Use `DISPLAY_NAME` 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.

	Category	Essentials
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following location fields: Android: `Place.Field.ADDRESS_COMPONENTS` `ADR_FORMAT_ADDRESS` `Place.Field.FORMATTED_ADDRESS` `Place.Field.LOCATION` `Place.Field.PLUS_CODE` `Place.Field.SHORT_FORMATTED_ADDRESS` `Place.Field.TYPES` `Place.Field.VIEWPORT` Deprecated fields:The `Place.Field.ADDRESS` and `Place.Field.LAT_LNG` fields were deprecated in version 4.0 of the Places SDK for Android. Instead, use `Place.Field.FORMATTED_ADDRESS` and `Place.Field.LOCATION`, respectively.
	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.

	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: Android: `Place.Field.ACCESSIBILITY_OPTIONS` `Place.Field.BUSINESS_STATUS` `Place.Field.GOOGLE_MAPS_URI` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_MASK_URL` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.SUB_DESTINATIONS` `Place.Field.UTC_OFFSET` Deprecated fields:The `Place.Field.ICON_URL` and `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` fields were deprecated in version 4.0 of the Places SDK for Android. Instead, use `Place.Field.ICON_MASK_URL` and `Place.Field.ACCESSIBILITY_OPTIONS`, respectively. `Place.Field.ACCESSIBILITY_OPTIONS` is only available for Place Details (New).
	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.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` Deprecated fields:The `Place.Field.PHONE_NUMBER` and `Place.Field.USER_RATINGS_TOTAL` fields were deprecated in version 4.0 of the Places SDK for Android. Instead, use `Place.Field.INTERNATIONAL_PHONE_NUMBER` and `Place.USER_RATING_COUNT`, respectively. If you terminate an Autocomplete session with a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred), then the call is billed at SKU: Place Details (Preferred). 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.

	Category	Enterprise
	Billable event	Request
	Triggers	This SKU is triggered when you request the following fields: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT` If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred), then the call is billed at SKU: Place Details (Preferred). 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.

	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: Android: `Place.Field.ADDRESS_COMPONENTS` `Place.Field.BUSINESS_STATUS` `Place.Field.ADDRESS` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_URL` `Place.Field.LAT_LNG` `Place.Field.PHOTO_METADATAS` `Place.Field.PLUS_CODE` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.ID` `Place.Field.NAME` `Place.Field.TYPES` `Place.Field.UTC_OFFSET` `Place.Field.VIEWPORT` `Place.Field.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: 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: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` Deprecated fields:The `Place.Field.PHONE_NUMBER` and `Place.Field.USER_RATINGS_TOTAL` fields were deprecated in version 4.0 of the Places SDK for Android. Instead, use `Place.Field.INTERNATIONAL_PHONE_NUMBER` and `Place.USER_RATING_COUNT`, respectively.
	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.

	Category	Enterprise
	Billable event	Request
	Triggers	This SKU is triggered when you request the following fields: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT`
	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.

	Category	Essentials
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request only the following fields: Android: `Place.Field.DISPLAY_NAME` `Place.Field.ID` `Place.Field.RESOURCE_NAME` Deprecated fields: The `Place.Field.NAME` field was deprecated in version 4.0 of the Places SDK for Android. Instead use `Place.Field.DISPLAY_NAME`. The `RESOURCE_NAME` field contains the place resource name in the form: `places/PLACE_ID`. Use `DISPLAY_NAME` 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.

	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: Android: `Place.Field.ACCESSIBILITY_OPTIONS` `Place.Field.ADDRESS_COMPONENTS` `Place.Field.ADR_FORMAT_ADDRESS` `Place.Field.BUSINESS_STATUS` `Place.Field.FORMATTED_ADDRESS` `Place.Field.GOOGLE_MAPS_URI` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_MASK_URL` `Place.Field.LOCATION` `Place.Field.PHOTO_METADATAS` `Place.Field.PLUS_CODE` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.SHORT_FORMATTED_ADDRESS` `Place.Field.SUB_DESTINATIONS` `Place.Field.TYPES` `Place.Field.UTC_OFFSET` `Place.Field.VIEWPORT` Deprecated fields:The `Place.Field.ADDRESS`, `Place.Field.ICON_URL`, `Place.Field.LAT_LNG`, and `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` fields were deprecated in version 4.0 of the Places SDK for Android. Instead, use `Place.Field.FORMATTED_ADDRESS`, `Place.Field.ICON_MASK_URL`, `Place.Field.LOCATION`, and `Place.ACCESSIBILITY_OPTIONS`, respectively. `Place.Field.ACCESSIBILITY_OPTIONS` is only available for Place Details (New).
	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.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	This SKU is triggered when you request the following fields: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` Deprecated fields:The `Place.Field.PHONE_NUMBER` and `Place.Field.USER_RATINGS_TOTAL` fields were deprecated in version 4.0 of the Places SDK for Android. Instead, use `Place.Field.INTERNATIONAL_PHONE_NUMBER` and `Place.USER_RATING_COUNT`, respectively.
	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.

	Category	Enterprise
	Billable event	Request
	Triggers	This SKU is triggered when you request the following fields: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT`
	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

Places SDK for Android legacy SKU details

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.

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: 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.

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.

	Category	Enterprise
	Billable event	Request with the specified field masks.
	Triggers	Billing is triggered when you request any of these fields: Android `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.
	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

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: 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: Find Current Place

This SKU bills for requests to 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.

	Category	Pro
	Billable event	Request
	Triggers	This SKU bills for requests to the following methods: `findCurrentPlace()` (Android) `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 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 `findCurrentPlace()` (Android) or `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) request and specify just the `ADDRESS` field. Your bill shows these SKUs: Find Current Place Basic Data You make a `findCurrentPlace()` (Android) or `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) request and specify the `PHONE_NUMBER` field. Your bill shows these SKUs: Find Current Place Contact Data You make a `findCurrentPlace()` (Android) or `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) request and specify fields from all three data-type buckets. Your bill shows these SKUs: Find Current Place 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

Terms of Use restrictions

For information on terms of use, see the License Restrictions section of the Google Maps Platform Terms of Service.