Google Maps Platform SKU Details

This page provides details about Google Maps Platform SKUs, including SKUs for India. A stock keeping unit (SKU) is a distinct item from Google Maps Platform associated with a product, and a product can have more than one SKU associated with it. Each SKU has a set price that you can view in the pricing lists (Pricing, Pricing - India). When you use a service, it can trigger one or more SKUs, each appearing as a separate line item on your bill.

SKU names

This section lists all SKUs, divided into Essentials, Pro, and Enterprise.

  • SKUs in bold underline have an updated name.
  • Hold the pointer over to view the previous SKU name and press Esc to dismiss.

For an explanation of the pricing categories, see Essentials, Pro, and Enterprise categories in the Billing overview guide.

Essentials

Maps Routes Places Environment

Dynamic Maps

Embed1

Maps SDK2

Static Maps

Static Street View

Static Street View Metadata

Map Tiles API: 2D Map Tiles

Map Tiles API: Street View Tiles

Routes: Compute Routes Essentials

Routes: Compute Route Matrix Essentials

Autocomplete Requests

Autocomplete Session Usage

Geocoding

Geolocation

Places API Place Details Essentials (IDs Only)

Places API Place Details Essentials

Places API Text Search Essentials (IDs Only)

Time Zone

Air Quality Usage

Solar API Building Insights

1 Embed and Embed Advanced are now merged under one single SKU: Embed. There are no other changes to these services.

2 Mobile Native Static Maps and Mobile Native Dynamic Maps are now merged under one single SKU: Maps SDK. There are no other changes to these services.

Pro

Maps Routes Places Environment

Aerial View

Dynamic Street View

Elevation

Roads - Nearest Road

Roads - Route Traveled

Roads - Speed Limits

RouteOptimization - SingleVehicleRouting

Routes: Compute Routes Pro

Routes: Compute Route Matrix Pro

Address Validation Pro

Places API Nearby Search Pro

Places API Place Details Pro

Places API Text Search Pro

Pollen Usage

Enterprise

Maps Routes Places Environment

Map Tiles API: Photorealistic 3D Tiles

RouteOptimization - FleetRouting

Routes: Compute Routes Enterprise

Routes: Compute Route Matrix Enterprise

Navigation Request

Address Validation Enterprise

Places API Nearby Search Enterprise

Places API Nearby Search Enterprise + Atmosphere

Places API Place Details Enterprise

Places API Place Details Enterprise + Atmosphere

Places API Place Details Photos

Places API Text Search Enterprise

Places API Text Search Enterprise + Atmosphere

Solar API Data Layers

About the SKU tables

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.

Maps product SKUs

[ Essentials: Maps ]

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:

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

This SKU bills for requests to the Embed API.

  Category Essentials
  Billable event Request
  Triggers Billing is triggered for requests to the Embed API.
  Pricing Main pricing table
India pricing table

SKU: Maps SDK

This SKU bills for map loads of a Google map object, not loaded with a map ID, in an Android or iOS mobile application.

  Category Essentials
  Billable event Map load
  Triggers Each instantiation of a Google map object, not loaded with a map ID, in a Maps SDK for Android or Maps SDK for iOS mobile application:

User interactions with the map don't generate additional map loads, including panning, zooming, or switching map layers.

  Pricing Main pricing table
India pricing table

SKU: Static Maps

This SKU bills for requests to the Maps Static API.

  Category Essentials
  Billable event Map load
  Triggers This SKU is triggered when you make a request to the Maps Static API.
  Pricing Main pricing table
India pricing table

SKU: Static Street View

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

  Category Essentials
  Billable event Panorama
  Triggers

This SKU is triggered when you make a request to the Street View Static API that returns a static street view panorama.

  Pricing Main pricing table
India pricing table

SKU: Static Street View Metadata

This SKU bills for requests to the Street View Static API that return only metatadata on images.

  Category Essentials
  Billable event Request
  Triggers

This SKU is triggered when you make a request to the Street View Static API that returns only metadata on images. For more information, see Street View Image Metadata.

  Pricing Main pricing table
India pricing table

[ Pro: Maps ]

SKU: Aerial View

This SKU bills for Text Search requests to the Aerial View API that return an aerial video URL.

  Category Pro
  Billable event Successful lookupVideo request
  Triggers

Successful requests to lookupVideo that return URLs are billed.

  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:

  Pricing Main pricing table
India pricing table

SKU: Elevation

This SKU bills for requests to the Maps JavaScript API Elevation service or to the Elevation API.

  Category Pro
  Billable event Request
  Triggers Billing is triggered for requests to the following services:
  Pricing Main pricing table
India pricing table

Maps - 2D and Street Tiles

[ Essentials: Maps Tiles ]

SKU: Map Tiles API: 2D Map Tiles

This SKU bills for requests to the Map Tiles API for 2D map tiles.

  Category Essentials
  Billable event Request
  Triggers This SKU is triggered when you make a request to the Map Tiles API that retrieves one of the following 2D map tiles:
  Pricing Main pricing table
India pricing table

SKU: Map Tiles API: Street View Tiles

This SKU bills for requests to Map Tiles API retrieving Street View tiles.

  Category Essentials
  Billable event Request
  Triggers This SKU is triggered when you make a request to that retrieves one or more of the following Street View tiles:
  • Street View Tiles
  • Street View Thumbnails
  • Street View PanoIDs
  Pricing Main pricing table
India pricing table

Maps - 3D Tiles

[ Enterprise: Maps Tiles ]

SKU: Map Tiles API: Photorealistic 3D Tiles

This SKU bills for requests to Map Tiles API that retrieve 3D Tiles.

  Category Enterprise
  Billable event Request
  Triggers This SKU is triggered when you make a request to Map Tiles API that retrieves 3D Tiles.
  Pricing Main pricing table
India pricing table

Routes product SKUs

[ Essentials: Routes ]

SKU: Routes: Compute Routes Essentials

This SKU bills for requests to Compute Routes.

  Category Essentials
  Billable event Request
  Triggers This SKU is triggered when you make a request to the to Compute Routes that doesn't use any Pro or Enterprise features.
  Pricing Main pricing table
India pricing table

SKU: Routes: Compute Route Matrix Essentials

This SKU bills for requests to the Compute Route Matrix that use Essentials features.

  Category Essentials
  Billable event Element
  Triggers This SKU is triggered for each element returned when you make a request to Compute Route Matrix that does not use any Pro or Enterprise features.
  Pricing Main pricing table
India pricing table

[ Pro: Roads and Routes ]

SKU: Roads – Nearest Road

This SKU bills for requests to the Roads API Nearest Roads service.

  Category Pro
  Billable event Request
  Triggers This SKU is triggered when you make a request to the Roads API Nearest Roads service.
  Pricing Main pricing table
India pricing table

SKU: Roads – Route Traveled

This SKU bills for requests to the Roads API Snap to Roads service.

  Category Pro
  Billable event Request
  Triggers This SKU is triggered when you make a request to the Roads API Snap to Roads service.
  Pricing Main pricing table
India pricing table

SKU: Roads – Speed Limits

This limited access SKU bills for requests to the Roads API Speed Limits service.

  Category Pro1
  Billable event Elements returned in the API response.
  Triggers

This SKU is triggered for each element returned in the API response when you make a request to the Speed Limits service. The number of elements returned in the API response is always equal to or less than the number of points you pass in the original request.

  Pricing Main pricing table
India pricing table
1 This SKU has limited access.

SKU: Route Optimization: Single Vehicle Routing

This SKU bills for shipments returned from a request to the Route Optimization API that specifies exactly one vehicle.

  Category Pro
  Billable event Shipment
  Triggers

This SKU is triggered for each shipment returned when you make a request to the Route Optimization API that specifies exactly one vehicle.

You won't be charged for the following shipments:

  • Shipments in requests that fail due to validation errors, such as syntax or data validation errors, or any internal service error.
  • Shipments in requests in VALIDATE_ONLY solve mode (that only do validation).
  • Shipments that are either determined as infeasible shipments at validation, or ones that are explicitly ignored, excluded from optimization, or constrained from being optimized by InjectedSolutionConstraint.
  Example

If you have a Route Optimization request that has:

  • 1 vehicle
  • 10 unique shipments (with 10 unique shipment locations or loads)

Billing is triggered for the 10 shipments in on the Single Vehicle Routing SKU. The same request with 5 vehicles triggers billing on the Route Optimization: Fleet Routing SKU instead.

  Pricing Main pricing table
India pricing table

SKU: Routes: Compute Routes Pro

This SKU bills for requests to Compute Routes that use pro features.

  Category Pro
  Billable event Request
  Triggers

This SKU is triggered when you make a request to the Compute Routes that uses one or more of the following Pro features:

  • Between 11 and 25 intermediate waypoints
  • Waypoint optimization: Triggered by setting "optimizeWaypointOrder": "true".
  • Traffic aware or traffic aware optimal routing. These routing options correspond to setting the routingPreference property in the request to TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL.
  • Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
  Pricing Main pricing table
India pricing table

SKU: Routes: Compute Route Matrix Pro

This SKU bills for requests to the Compute Route Matrix that use Pro features.

  Category Pro
  Billable event Element
  Triggers

This SKU is triggered for each element returned when you make a request that uses one or more of the following Pro features:

  Pricing Main pricing table
India pricing table

[ Enterprise: Route Optimization, Routes ]

SKU: Route Optimization: Fleet Routing

This SKU bills for shipments returned from a request to the Route Optimization API that specifies more than one vehicle.

  Category Enterprise
  Billable event Shipment
  Triggers This SKU is triggered for each shipment returned from a request to the Route Optimization API that specifies more than one vehicle.

You won't be charged for the following shipments:

  • Shipments in requests that fail due to validation errors, such as syntax or data validation errors, or any internal service error.
  • Shipments in requests in VALIDATE_ONLY solve mode (that only do validation).
  • Shipments that are either determined as infeasible shipments at validation, or ones that are explicitly ignored, excluded from optimization, or constrained from being optimized by InjectedSolutionConstraint.
  Example

If you have a Route Optimization request that has:

  • 5 vehicles
  • 10 unique shipments (with 10 unique shipment locations or loads)

Billing is triggered for the 10 shipments in on the Fleet Routing SKU. The same request with one vehicle triggers billing on the Route Optimization: Single Vehicle SKU instead.

  Pricing Main pricing table
India pricing table

SKU: Routes: Compute Routes Enterprise

This SKU bills for requests to Compute Routes that use Enterprise features.

  Category Enterprise
  Billable event Request
  Triggers

This SKU is triggered when you make a request to the Compute Routes that uses one or more of the following Enterprise features:

  Pricing Main pricing table
India pricing table

SKU: Routes: Compute Route Matrix Enterprise

This SKU bills for requests to the Compute Route Matrix that use Enterprise features.

  Category Enterprise
  Billable event Element
  Triggers This SKU is triggered for each element returned when you make a request that uses one or more of the following Enterprise features:
  Pricing Main pricing table
India pricing table

[ Enterprise: Navigation ]

Navigation SDKs include: Navigation SDK for Android and Navigation SDK for iOS.

This SKU bills for destinations requested using the Navigation SDK. Keep in mind that a single method call can contain up to 25 destinations.

  Category Enterprise
  Billable event Destination
  Triggers

This SKU is triggered for each destination requested using these Navigation SDK methods:

Android SDK

iOS SDK
  Examples

The cost for each call is calculated by multiplying the number of destinations by the price per SKU.

Keep in mind that a single method call can contain up to 25 destinations.

  Pricing Main pricing table
India pricing table

Places (New) product SKUs

[ Essentials: Places, Geocoding, Geolocation ]

SKU: Autocomplete Requests

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

  Category Essentials
  Billable event Request
  Triggers

This SKU is triggered under the following conditions:

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

SKU: Autocomplete Session Usage

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

  Category Essentials
  Billable event Request
  Triggers

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

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

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

  Pricing Main pricing table
India pricing table

SKU: Geocoding

This SKU bills for requests to the Maps JavaScript API Geocoding service or Geocoding API.

  Category Essentials
  Billable event Request
  Triggers This SKU is triggered when Geocoding is requested in the following ways:
  Pricing Main pricing table
India pricing table

SKU: Geolocation

This SKU bills for requests to the Geolocation API.

  Category Essentials
  Billable event Request
  Triggers This SKU is triggered when Geolocation is requested from the Geolocation API.
  Pricing Main pricing table
India pricing table

SKU: Places API Place Details Essentials (IDs Only)

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

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

This SKU is triggered when you request the following fields:

Fields for Android SDK

Place.Field.DISPLAY_NAME*
    * Use instead of Place.Field.NAME (deprecated in version 4.0).
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME*
    * Contains the place resource name in the form: places/PLACE_ID.
     Use DISPLAY_NAME to access the text name of the place.

Fields for iOS

GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

Fields for Places Library, Maps JavaScript API

id
photos

Fields for Web service

attributions
id
name*
photos

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

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

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

SKU: Places API Place Details Essentials

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

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

Fields for Android SDK

Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
    * Use instead of Place.Field.ADDRESS (deprecated).
Place.Field.LOCATION*
    * Use instead of Place.Field.LAT_LNG (deprecated).
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

Fields for iOS

GMSPlacePropertyAddressComponents
GMSPlacePropertyFormattedAddress
GMSPlacePropertyCoordinate
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyViewport

Fields for Places Library, Maps JavaScript API

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
types
viewport

Fields for Web service

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  Field mask billing

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

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

SKU: Places API Text Search Essentials (IDs Only)

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

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

Fields for Android SDK

Place.Field.DISPLAY_NAME*
    * Use instead of Place.Field.NAME (deprecated in version 4.0).
Place.Field.ID
Place.Field.RESOURCE_NAME*
    * Contains the place resource name in the form: places/PLACE_ID.
     Use DISPLAY_NAME to access the text name of the place.

Fields for iOS

GMSPlacePropertyPlaceID
GMSPlacePropertyName

Fields for Places Library, Maps JavaScript API

id

Fields for Web service

places.attributions
places.id
places.name*
nextPageToken

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

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

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

SKU: Time Zone

This SKU bills for requests to the Time Zone API.

  Category Essentials
  Billable event Request
  Triggers This SKU is triggered when you make a request to the Time Zone API.
  Pricing Main pricing table
India pricing table

[ Pro: Address Validation, Places ]

SKU: Address Validation Pro

This SKU bills for a request for address validation from the Address Validation API.

  Category Pro
  Billable event Request
  Triggers This SKU is triggered by a request to one of the following methods of the Address Validation API:
  Pricing Main pricing table
India pricing table

SKU: Places API Nearby Search Pro

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

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

Fields for Android SDK

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

Fields for iOS SDK

GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyName
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyPhotos
GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

Fields for Places Library, Maps JavaScript API

accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

Fields for Web service

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

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

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

  Field mask billing

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

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

SKU: Places API Place Details Pro

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

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

Fields for Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
    * Use instead of Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (deprecated).
Place.Field.BUSINESS_STATUS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
    * Use instead of Place.Field.ICON_URL (deprecated).
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

Fields for iOS

GMSPlacePropertyBusinessStatus
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance

Fields for Places Library, Maps JavaScript API

accessibilityOptions
businessStatus
displayName
googleMapsUri
iconBackgroundColor
primaryTypeDisplayName
svgIconMaskURI
types
utcOffsetMinutes

Fields for Web service

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

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

  Field mask billing

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

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

SKU: Places API Text Search Pro

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

Fields for Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
    Use instead of Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (deprecated).
Place.Field.ADDRESS_COMPONENTS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.BUSINESS_STATUS
Place.Field.FORMATTED_ADDRESS*
    Use instead of Place.Field.ADDRESS (deprecated).
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL *
    Use instead of Place.Field.ICON_URL (deprecated).
Place.Field.LOCATION*
    Use instead of Place.Field.LAT_LNG (deprecated).
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

Fields for iOS

GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyFormattedAddress
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyCoordinate
GMSPlacePropertyPhotos
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

Fields for Places Library, Maps JavaScript API

accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

Fields for Web service

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

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

  Field mask billing

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

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

[ Enterprise: Address Validation, Places ]

SKU: Address Validation Enterprise

This SKU bills for an address validation request at the end of an Autocomplete (New) session.

  Category Enterprise
  Billable event Request
  Triggers Sessions that use Autocomplete (New) and terminate in a request to one of these Address Validation API methods:
  Pricing Main pricing table
India pricing table

For details about both pricing and using Autocomplete (New) sessions with Places API, see the following guides in the Places API documentation:

SKU: Places API Nearby Search Enterprise

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

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

This SKU is triggered when you request the following fields:

Fields for Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
    * Use instead of Place.Field.PHONE_NUMBER, which is deprecated.
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*
    * Use instead of Place.Field.USER_RATINGS_TOTAL, which is deprecated.
Place.Field.WEBSITE_URI

Fields for iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Fields for Places Library, Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

Fields for Web service

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

  Field mask billing

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

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

SKU: Places API Nearby Search Enterprise + Atmosphere

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

  Category Enterprise
  Billable event Request
  Triggers

This SKU is triggered when you request the following fields:

Fields for Android SDK

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

Fields for iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Fields for 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

Fields for Web service

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

* Text Search and Nearby Search only
  Field mask billing

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

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

SKU: Places API Place Details Enterprise

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

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

Fields for Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
    * Use instead of Place.Field.PHONE_NUMBER, which is deprecated.
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*
    * Use instead of Place.Field.USER_RATINGS_TOTAL, which is deprecated.
Place.Field.WEBSITE_URI

Fields for Places Library, Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

Fields for iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Fields for Web service

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

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

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

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

SKU: Places API Place Details Enterprise + Atmosphere

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

  Category Enterprise
  Billable event Request
  Triggers

This SKU is triggered when you request the following fields:

Fields for Android SDK

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

Fields for iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Fields for 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

Fields for Web service

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

* Text Search and Nearby Search only

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

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

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

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

SKU: Places API Text Search Enterprise

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

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

Fields for Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
    * Use instead of Place.Field.PHONE_NUMBER, which is deprecated.
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*
    * Use instead of Place.Field.USER_RATINGS_TOTAL, which is deprecated.
Place.Field.WEBSITE_URI

Fields for iOS SDK

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Fields for Places Library, Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

Fields for Web service

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

  Field mask billing

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

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

SKU: Places API Text Search Enterprise + Atmosphere

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

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

Fields for Android SDK

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

Fields for iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Fields for 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

Fields for Web service

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

* Text Search and Nearby Search only

  Field mask billing

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

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

Environment product SKUs

[ Essentials: Environment ]

SKU: Air Quality Usage

This SKU bills for requests to the Air Quality API.

  Category Essentials
  Billable event Request
  Triggers

Billing is triggered for the following endpoints and methods:
  Pricing Main pricing table
India pricing table

SKU: Solar API Building Insights

This SKU bills for requests to the Solar API buildingInsights resource.

  Category Essentials
  Billable event Request
  Triggers

This SKU is triggered when you make a request to the Solar API buildingInsights resource.

  Pricing Main pricing table
India pricing table

[ Pro: Environment ]

SKU: Pollen Usage

This bills for requests for pollen data from the Pollen API.

  Category Pro
  Billable event Request
  Triggers Billing is triggered for requests to the following endpoints/methods:
  Field mask billing examples

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

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

[ Enterprise: Environment ]

SKU: Solar API Data Layers

This SKU bills for requests to Solar API dataLayers resource.

  Category Enterprise
  Billable event Request
  Triggers

This SKU is triggered when you make a request to the Solar API dataLayers resource.

Accessing multiple imagery URLs from the same request doesn't trigger additional charges.

  Pricing Main pricing table
India pricing table

Legacy Places product SKUs

See Places product SKUs for the latest versions.

About Places Data SKUs

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

One or more Data SKUs are triggered for:

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

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

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

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

[ Essentials: Places Legacy ]

SKU: Autocomplete – Per Request

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

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

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

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

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

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

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

Fields in the request:

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

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

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

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

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

Example request by platform:

Android requests

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

iOS requests

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

Web service requests

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

  Pricing Main pricing table
India pricing table

About Autocomplete sessions

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

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

Autocomplete sessions can be generated from the following APIs:

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

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

SKU: Basic Data

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

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

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

Fields for Android SDK

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

Fields for iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Fields for Web service

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

  Field mask billing

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

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

SKU: 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: 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: Query Autocomplete – Per Request

This legacy SKU bills for Query Autocomplete requests.

  Category Essentials
  Billable event Request
  Triggers

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

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

  Pricing Main pricing table
India pricing table

[ Pro: Places Legacy ]

SKU: Autocomplete without Place Details – Per Session

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

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

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

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

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

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 Current Place request with just the ADDRESS field:

Your bill shows these SKUs:

  • Find Current Place
  • Basic Data

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

Your bill shows these SKUs:

  • Find Current Place
  • Contact Data

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

Your bill shows these SKUs:

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

SKU: Find Place

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

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

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

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

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

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

Your bill shows these SKUs:

  • Find Current Place
  • Basic Data

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

Your bill shows these SKUs:

  • Find Current Place
  • Contact Data

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

Your bill shows these SKUs:

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

SKU: Places – Nearby Search

This SKU bills for legacy Nearby Search requests.

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

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

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

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

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

SKU: Places – Text Search

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

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

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

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

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

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

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

SKU: Place Details Pro

This SKU bills for legacy Place Details requests.

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

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

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

[ Enterprise: Places Legacy ]

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:

Fields for Android SDK

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*
*Use INSTEAD OF Place.Field.USER_RATINGS_TOTAL, which is deprecated

Fields for iOS SDK

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.

Fields for Places Library, Maps JavaScript API

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

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

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

SKU: Contact Data

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

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

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

Fields for Android SDK

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

Fields for iOS SDK

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Fields for Web service

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Field mask billing

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

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

SKU: Places API Place Details Photos

This SKU bills for the legacy Places Photo service.

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

Legacy Routes API SKUs

[ Essentials: Routes Legacy ]

SKU: Directions

This SKU bills for a request to the Directions API unless the request triggers the Directions Advanced billing SKU, in which case it is billed under that SKU.

  Category Essentials
  Billable event Query
  Triggers This SKU bills for a request to the following services, unless the request triggers a higher-rated SKU:
  Pricing Main pricing table
India pricing table

SKU: Distance Matrix

This SKU bills for the elements returned by a request to the Distance Matrix API (Legacy) or the Maps JavaScript API Distance Matrix Service, excluding requests triggering the Distance Matrix Advanced billing SKU.

  Category Essentials
  Billable event Element
  Triggers This SKU is triggered for each element returned by a request to the Distance Matrix API. Each query sent to the Distance Matrix API generates elements, where the number of origins times the number of destinations equals the number of elements.
  Pricing Main pricing table
India pricing table

[ Pro: Routes Legacy ]

SKU: Directions Advanced

This SKU bills for a request to the Maps JavaScript API's Directions Service or the Directions API (Legacy) that uses traffic information, more than 10 waypoints, waypoint optimization, or location modifiers.

  Category Pro
  Billable event Query
  Triggers

This SKU bills for a Maps JavaScript API's Directions Service or a Directions API (Legacy) request that returns one or more of the following information:

  • Traffic information.: When you use all of the following request options so that the response returns the duration_in_traffic field:
    • Travel mode is driving: Set travel mode to driving. Driving is the default travel mode.
    • Departure time is set: Specify a valid departure_time. You can set departure_time to the current time or some time in the future. It cannot be in the past.
    • No stopover waypoints: Don't include stopover waypoints. If the request includes waypoints, prefix each waypoint with via: to influence the route but avoid stopovers. For example, 
      &waypoints=via:San Francisco|via:Mountain View|...
  • More than 10 waypoints: When you include between 11 and 25 waypoints.
  • Waypoints optimization.: The request sets the optimize parameter to true for waypoints. For example, 
    &waypoints=optimize:true|San Francisco|Mountain View|...
  • Location modifiers: When you use the following location modifiers to indicate how drivers should approach a particular location:
    • side_of_road
    • heading
  Pricing Main pricing table
India pricing table

SKU: Distance Matrix Advanced

This SKU bills for the elements returned by a request to the Distance Matrix API (Legacy) or the Maps JavaScript API Distance Matrix Service that uses traffic information and/or location modifiers.

  Category Pro
  Billable event Element
  Triggers

This SKU is triggered for each element returned by a request to the Distance Matrix API. Each query sent to the Distance Matrix API generates elements, where the number of origins times the number of destinations equals the number of elements.

A Distance Matrix Advanced SKU is charged for a Distance Matrix API (Legacy) or a Maps JavaScript API Distance Matrix Service that uses one or more of the following:

  • Traffic information. When you use all of the following request options so that the response returns the duration_in_traffic field in the Distance Matrix response:
    • Travel mode is driving: Set travel mode todriving. Driving is the default travel mode.
    • Departure time is set: Specify a valid departure_time. You can set departure_time to the current time or some time in the future. It cannot be in the past.
  • Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
    • side_of_road
    • heading
  Pricing Main pricing table
India pricing table