Maps JavaScript API Usage and Billing

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

Maps JavaScript API requests generate calls to two different SKUs depending on the type of request: map loads or panoramas. Calls to the Places Library, Maps JavaScript API and other JavaScript services are priced separately from JavaScript native SKUs. Click the info info icon to see the table of contents for this page.

Billing and pricing for the Maps JavaScript API

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

SKU: Dynamic Maps

This SKU bills for map loads when an application displays a map.

	Category	Essentials
	Billable event	Map load
	Triggers	This SKU bills for map loads when an application displays a map loaded in one of the following ways: With or without a map ID using Maps JavaScript API With a map ID using either the Maps SDK for Android or Maps SDK for iOS. User interactions with the map, such as panning, zooming, or switching map layers, don't generate additional map loads.
	Pricing	Main pricing table India pricing table

SKU: Dynamic Street View

This SKU bills for requests to the Street View Static API that return a dynamic street view panorama.

	Category	Pro
	Billable event	Panorama
	Triggers	This SKU is triggered when you instantiate a panorama object using one of the following classes or methods: JavaScript: Use the google.maps.StreetViewPanorama() class or Map.getStreetView() method. Neither the built-in Street View experience based on the Street View Pegman control nor usage of the StreetViewService() class is charged. Android: Use one of StreetViewPanoramaFragment, SupportStreetViewPanoramaFragment, or StreetViewPanoramaView classes. A panorama is counted each time the related onCreate() method is called. iOS: Use the GMSPanoramaView object. Street View panoramas and map loads are now charged separately. A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, Maps SDK for iOS application.
	Pricing	Main pricing table India pricing table

Pricing for Places Library, Maps JavaScript API

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.
	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: Places Library, Maps JavaScript API: id photos
	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: Places Library, Maps JavaScript API: addressComponents adrFormatAddress formattedAddress location plusCode 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: Places Library, Maps JavaScript API: accessibilityOptions businessStatus displayName googleMapsUri iconBackgroundColor primaryTypeDisplayName svgIconMaskURI types utcOffsetMinutes
	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: Places Library, Maps JavaScript API: internationalPhoneNumber nationalPhoneNumber priceLevel rating regularOpeningHours 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: Places Library, Maps JavaScript API: allowsDogs editorialSummary evChargeOptions fuelOptions hasCurbsidePickup hasDelivery hasDineIn hasLiveMusic hasMenuForChildren hasOutdoorSeating hasRestroom hasTakeout hasWifi isGoodForChildren isGoodForGroups isGoodForWatchingSports isReservable parkingOptions paymentOptions priceLevel reviews servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine 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: Places Library, Maps JavaScript API: accessibilityOptions addressComponents adrFormatAddress businessStatus displayName formattedAddress googleMapsUri iconBackgroundColor id location photos plusCode svgIconMaskURI types utcOffsetMinutes 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 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: Places Library, Maps JavaScript API: internationalPhoneNumber nationalPhoneNumber priceLevel rating regularOpeningHours userRatingCount 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: Places Library, Maps JavaScript API: allowsDogs editorialSummary evChargeOptions fuelOptions hasCurbsidePickup hasDelivery hasDineIn hasLiveMusic hasMenuForChildren hasOutdoorSeating hasRestroom hasTakeout hasWifi isGoodForChildren isGoodForGroups isGoodForWatchingSports isReservable parkingOptions paymentOptions priceLevel reviews servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine
	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: Places Library, Maps JavaScript API: id
	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: Places Library, Maps JavaScript API: accessibilityOptions addressComponents adrFormatAddress businessStatus displayName formattedAddress googleMapsUri iconBackgroundColor location photos plusCode svgIconMaskURI types utcOffsetMinutes 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 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: Places Library, Maps JavaScript API: internationalPhoneNumber nationalPhoneNumber priceLevel rating regularOpeningHours userRatingCount 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: Places Library, Maps JavaScript API: allowsDogs editorialSummary evChargeOptions fuelOptions hasCurbsidePickup hasDelivery hasDineIn hasLiveMusic hasMenuForChildren hasOutdoorSeating hasRestroom hasTakeout hasWifi isGoodForChildren isGoodForGroups isGoodForWatchingSports isReservable parkingOptions paymentOptions priceLevel reviews servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine
	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

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

Pricing for JavaScript services

JavaScript services are priced separately. See the service's usage and billing page for more information:

• Directions Service -- Directions API usage and billing
• Distance Matrix Service -- Distance Matrix API usage and billing
• Elevation Service -- Elevation API usage and billing
• Geocoding Service -- Geocoding API usage and billing
• Street View Service -- Street View API usage and billing

Other usage limits

While there is no maximum number of requests per day, the following usage limits are in place for the Maps JavaScript API API:

• 30,000 QPM (requests per minute).
• 300 QPM (requests per minute) per IP address. In the Google Cloud console, this quota is referred to as Map loads per minute per user.

Key point: Older projects may have a legacy quota of 60 QPM per IP address. If you would like to increase this to 300 QPM, contact our support team and request a quota increase.

Photorealistic 3D Maps in Maps JavaScript usage limits

Note: During the Experimental stage, your usage of Photorealistic 3D Maps in Maps JavaScript will be: (i) at no charge, and (ii) require you to enable billing on each of your projects using Photorealistic 3D maps in Maps JavaScript. We have no obligation to notify you when your trial ends, and we reserve the right to modify or terminate the trial at any time, without notice and in our sole discretion.

The following usage limits are in place for the Photorealistic 3D Maps in Maps JavaScript

• 100 QPM (requests per minute) .
• 10 QPM (requests per minute) per IP address .

Terms of Use restrictions

For complete details on allowed usage, consult the License Restrictions section in the Google Maps Platform Terms of Service.

---