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 by their name, divided into Essentials, Pro, and Enterprise. This is the name that appears on your billing statement.
- SKUs in bold underline have an updated name.
- Hold the pointer over to view the previous SKU name and press Escto dismiss.
For an explanation of the pricing categories, see Essentials, Pro, and Enterprise categories in the Billing overview guide.
Essentials
Maps | Routes | Places | Environment |
---|---|---|---|
Places API Place Details Essentials (IDs Only) Places API Place Details Essentials Places API Text Search Essentials (IDs Only) |
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 |
---|---|---|---|
Enterprise
About the SKU tables
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
- 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 .
SKU: Embed
Category | Essentials | |
---|---|---|
APIs | Embed API | |
Billable event | Successful request | |
Triggers | Requests to the Embed API . | |
Pricing | Main pricing table
India pricing table |
SKU: Maps SDK
- Android:
onCreate()
method forMapFragment
,SupportMapFragment
, orMapView
class not loaded with a map ID. - iOS::
GMSMapView
object not loaded with a map ID.
User interactions with the map don't generate additional map loads, including panning, zooming, or switching map layers.
SKU: Static Maps
Category | Essentials | |
---|---|---|
APIs | Maps Static API | |
Billable event | Map load | |
Triggers | Successful map load request to 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 | |
---|---|---|
APIs | Street View Static API | |
Billable event | Panorama load | |
Triggers | Successful static street view panorama request to Street View Static API . |
|
Notes | ||
Pricing | Main pricing table
India pricing table |
SKU: Static Street View Metadata
Category | Essentials | |
---|---|---|
APIs | Street View Static API | |
Billable event | Successful request for metadata only | |
Triggers | Successful metadata-only request to the Street View Static API . For details, see Street View Image Metadata . | |
Pricing | Main pricing table
India pricing table |
[ Pro: Maps ]
SKU: Aerial View
Category | Pro | |
---|---|---|
APIs | Aerial View API | |
Billable event | Successful request for Pro data | |
Triggers | |
|
Pricing | Main pricing table
India pricing table |
SKU: Dynamic Street View
- JavaScript:
google.maps.StreetViewPanorama()
class
Map.getStreetView()
method. - Android:
onCreate()
method for
StreetViewPanoramaFragment
,SupportStreetViewPanoramaFragment
, orStreetViewPanoramaView
classes. - iOS:
GMSPanoramaView
object.
SKU: Elevation
- Maps JavaScript API Elevation service
- Elevation API
Map Tiles - 2D and Street Tiles
[ Essentials: Map Tiles ]
SKU: Map Tiles API: 2D Map Tiles
SKU: Map Tiles API: Street View Tiles
- Street View Tiles
- Street View Thumbnails
- Street View PanoIDs
Map Tiles - 3D Tiles
[ Enterprise: Map Tiles ]
SKU: Map Tiles API: Photorealistic 3D Tiles
Category | Enterprise | |
---|---|---|
APIs | Map Tiles API | |
Billable event | Request that returns a 3D tile | |
Triggers | 3D Tiles . | |
Pricing | Main pricing table
India pricing table |
Routes product SKUs
[ Essentials: Routes ]
SKU: Routes: Compute Routes Essentials
Category | Essentials | |
---|---|---|
APIs | Compute Routes | |
Billable event | Successful request with no Pro or Enterprise features | |
Triggers | Requests to Compute Routes that don't use Pro or Enterprise features. | |
Pricing | Main pricing table
India pricing table |
SKU: Routes: Compute Route Matrix Essentials
Category | Essentials | |
---|---|---|
APIs | Compute Route Matrix | |
Billable event | Each element returned with no Pro or Enterprise features | |
Triggers | Requests to Compute Route Matrix that don't use Pro or Enterprise features. | |
Pricing | Main pricing table
India pricing table |
[ Pro: Roads and Routes ]
SKU: Roads – Nearest Road
Category | Pro | |
---|---|---|
APIs | Roads API Nearest Roads service | |
Billable event | Successful request | |
Triggers | Request to the Roads API Nearest Roads service . | |
Pricing | Main pricing table
India pricing table |
SKU: Roads – Route Traveled
Category | Pro | |
---|---|---|
APIs | Roads API | |
Billable event | Successful request | |
Triggers | Snap to Roads service . | |
Pricing | Main pricing table
India pricing table |
SKU: Roads – Speed Limits
Category | Pro | |
---|---|---|
APIs | Roads API | |
Billable event | Elements returned in the API response. | |
Triggers | Speed Limits service - Limited access | |
Pricing | Main pricing table
India pricing table |
SKU: Route Optimization: Single Vehicle Routing
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.
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
.
SKU: Routes: Compute Routes Pro
- Use between 11 and 25 intermediate waypoints
- Set
"optimizeWaypointOrder": "true"
. - Set
routingPreference
toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Set one of the following Location modifiers:
Side of the road
Heading
Vehicle stopover
SKU: Routes: Compute Route Matrix Pro
-
routingPreference
property set toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Set one of the following Location modifiers:
Side of the road
Heading
Vehicle stopover
[ Enterprise: Route Optimization, Routes ]
SKU: Route Optimization: Fleet Routing
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
.
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.
SKU: Routes: Compute Routes Enterprise
SKU: Routes: Compute Route Matrix Enterprise
- Two-wheeled vehicle routing elements
- Toll calculation elements
Navigation SKU
[ Enterprise: Navigation ]
Navigation SDKs include: Navigation SDK for Android and Navigation SDK for iOS .
SKU: Navigation Request
Android SDK
- setDestination (Waypoint destination)
- setDestination (Waypoint destination, RoutingOptions options)
- setDestination (Waypoint destination, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (List<Waypoint> destinations, RoutingOptions options)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [Deprecated] setDestinations (List<Waypoint> destinations, String routeToken)
iOS SDK
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.
Places (New) product SKUs
[ Essentials: Places, Geocoding, Geolocation ]
SKU: Autocomplete Requests
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 .
SKU: Autocomplete Session Usage
Category | Essentials | |
---|---|---|
APIs | Place Autocomplete Android
, Place Autocomplete iOS , Maps JavaScript API Place Autocomplete Widget , Place Autocomplete Web |
|
Billable event | Request with a session token | |
Triggers | For more information, see Autocomplete (New) and session pricing . |
|
Examples | 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 . |
|
Pricing | Main pricing table
India pricing table |
SKU: Geocoding
- JavaScript:
Geocoder.geocode()
method. - Geocoding API .
SKU: Geolocation
Category | Essentials | |
---|---|---|
APIs | Geolocation API | |
Billable event | Successful request | |
Triggers | Request to Geolocation API . | |
Pricing | Main pricing table
India pricing table |
SKU: Places API Place Details Essentials (IDs Only)
Fields for Android SDK
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
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
. To get the text name of the place, request the displayName
field in the Pro SKU.
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 ratefor 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.
SKU: Places API Place Details Essentials
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
addressDescriptor
*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
*
Address descriptors are generally available for customers in India and are experimental elsewhere.
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 ratefor 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.
SKU: Places API Text Search Essentials (IDs Only)
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.
iOS
GMSPlacePropertyPlaceID
Places Library, Maps JavaScript API
id
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
in the Pro SKU
to access the text name of the place.
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 ratefor 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.
SKU: Places UI Kit - per Request
Android
iOS
JavaScript
SKU: Places UI Kit - Autocomplete per Session
Category | Essentials | |
---|---|---|
APIs | Places UI Kit Android
, Places UI Kit iOS , Places UI Kit JavaScript |
|
Billable event | Session | |
Triggers | This SKU is triggered by Places UI Kit Basic Autocomplete requests: Android iOS JavaScript |
|
Pricing | Main pricing table
India pricing table |
SKU: Time Zone
Category | Essentials | |
---|---|---|
APIs | Time Zone API | |
Billable event | Successful request | |
Triggers | Successful request to the Time Zone API . | |
Pricing | Main pricing table
India pricing table |
[ Pro: Address Validation, Places ]
SKU: Address Validation Pro
- ValidateAddress (REST) method.
- ValidateAddress (gRPC) method.
SKU: Places API Nearby Search Pro
Android SDK
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ADDRESS
Place.Field.DISPLAY_NAME
>*
* Use instead of Place.Field.NAME
, which is deprecated.
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
*
* Use instead of Place.Field.ICON_URL
, which is deprecated.
Place.Field.ID
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.RESOURCE_NAME
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
iOS SDK
GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyName
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyPhotos
GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance
Places Library, Maps JavaScript API
accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport
Web service
places.accessibilityOptions
places.addressComponents
places.addressDescriptor
*
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
*
Address descriptors are generally available for customers in India and are experimental elsewhere.
**
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.
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 ratefor 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.
SKU: Places API Place Details Pro
Fields for Android SDK
Place.Field.ACCESSIBILITY_OPTIONS
*
* Use instead of Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
(deprecated).
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME
*
* Use instead of Place.Field.NAME
, which is 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.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
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 ratefor 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.
SKU: Places API Text Search Pro
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
iOS
GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyPhotos
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance
Places Library, Maps JavaScript API
accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport
Web service
places.accessibilityOptions
places.addressComponents
places.addressDescriptor
*
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
*
Address descriptors are generally available for customers in India and are experimental elsewhere.
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 ratefor 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.
SKU: Places Aggregate Pro
[ Enterprise: Address Validation, Places ]
SKU: Address Validation Enterprise
- Autocomplete (New) session that terminates in a ValidateAddress (REST) method.
- Autocomplete (New) session that terminates in a ValidateAddress (gRPC) method.
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
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
iOS
GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite
Places Library, Maps JavaScript API
internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri
Web service
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri
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 ratefor 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.
SKU: Places API Nearby Search Enterprise + Atmosphere
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
iOS SDK
GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout
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
Web service
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
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
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 ratefor 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.
SKU: Places API Place Details Enterprise
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
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 ratefor 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.
SKU: Places API Place Details Enterprise + Atmosphere
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
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries
*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
*
Text Search and Nearby Search only
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 ratefor 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.
SKU: Place Details Photo
Category | Enterprise | |
---|---|---|
APIs | Places API Place Details Photo | |
Billable event | Successful request for a photo | |
Triggers | Request a photo. | |
Pricing | Main pricing table
India pricing table |
SKU: Places API Text Search Enterprise
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
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 ratefor 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.
SKU: Places API Text Search Enterprise + Atmosphere
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
iOS SDK
GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout
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
Web service
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
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
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 ratefor 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.
Environment product SKUs
[ Essentials: Environment ]
SKU: Air Quality Usage
- currentConditions method
- history (per page) method
- heatmapTiles method
- forecast (per page) method
SKU: Solar API Building Insights
Category | Essentials | |
---|---|---|
APIs | Solar API | |
Billable event | Successful request | |
Triggers | Requests to the Solar API buildingInsights
resource. This SKU is triggered when you make a request to the Solar API buildingInsights resource. |
|
Examples | ||
Pricing | Main pricing table
India pricing table |
SKU: Weather Usage
This SKU bills for requests to the Weather API .
Billing is triggered for requests to the following endpoints/methods:
[ Pro: Environment ]
SKU: Pollen Usage
[ Enterprise: Environment ]
SKU: Solar API Data Layers
Category | Enterprise | |
---|---|---|
APIs | Solar API | |
Billable event | Successful request | |
Triggers | Requests to the Solar API dataLayers resource. | |
Notes | 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()
orfindCurrentPlace()
- iOS:each call to
fetchPlaceFromPlaceID:
orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- 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 (Legacy)
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript:
The Maps JavaScript API's Place Autocomplete service - Web service:
The Places API Place Autocomplete service
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.
SKU: Autocomplete (included with Place Details) – Per Session (Legacy)
- 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 fieldsin the Place Details request, allData 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
.
Requests for autocomplete are available at no charge. This legacy SKU bills when you request subsequent Place Details based on regular Place Details pricing .
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)
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.
SKU: Basic Data
This legacy SKU is a Data SKU that bills for Basic Datafields 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 Basiccategory are included in the base cost of the Places request and don't result in any additional charge.
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
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 ratefor 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.
SKU: Find Place – ID only (Legacy)
Category | Essentials | |
---|---|---|
APIs | Places Web Service Find Place | |
Billable event | Successful request for only the place_id
|
|
Triggers | Find Place
request with no fields specified, or only the place_id
field: FindPlace(fields: place_id)
. |
|
Pricing | Main pricing table
India pricing table |
SKU: Place Details – ID Refresh (Legacy)
Category | Essentials | |
---|---|---|
APIs | Place Details (Legacy) | |
Billable event | Successful request for only ID fields | |
Triggers | Request with only the Place ID field: getPlaceDetails(fields: place_id)
. |
|
Pricing | Main pricing table
India pricing table |
SKU: Query Autocomplete – Per Request (Legacy)
- JavaScript: 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: 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 .
[ Pro: Places Legacy ]
SKU: Autocomplete without Place Details – Per Session (Legacy)
- Android
findAutocompletePredictions()
(.setQuery("par"), .setSessionToken(XYZ))
ANDfindAutocompletePredictions()
(.setQuery("paris"), .setSessionToken(XYZ))
NOT followed by a Place Details request. - iOS
placesClient?.findAutocompletePredictions(fromQuery: "par" ...
AND
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
NOT followed by a Place Details request. - Web service
Place Autocomplete Request(input="par", session_token: XYZ)
AND
Place Autocomplete Request(input="paris", session_token: XYZ)
NOT followed by a Place Details request.
SKU: Find Current Place (Legacy)
-
findCurrentPlace()
method (Android) -
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
method (iOS)
This SKU also triggers billing for Data SKUs: If you include data fields in your request, it can trigger additional billing for Data SKUs: Basic Data , Contact Data , and Atmosphere Data . 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.
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
SKU: Find Place (Legacy)
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 Data , Contact Data , and Atmosphere Data . 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.
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
SKU: Places – Nearby Search (Legacy)
- 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 Data , Contact Data , and Atmosphere Data . 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.
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
SKU: Places – Text Search (Legacy)
- 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), nota result (icon: pin), as illustrated here:

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
SKU: Places Details
- 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: Place Details (Legacy) 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 Data , Contact Data , and Atmosphere Data . 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.
- Make one of these calls or requests:
- Mobile:call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just theADDRESS
field - Web API or service:make a Place Details (Legacy) request and specify just the
address field:
getPlaceDetails(fields: formatted_address)
- Places Details
- Basic Data
- Mobile:call
- Make one of these calls or requests:
- Mobile:call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just thePHONE_NUMBER
field - Web API or service:make a Place Details (Legacy) request and specify the
phone number field:
getPlaceDetails(fields: formatted_phone_number)
- Places Details
- Contact Data
- Mobile:call
- Make one of these calls or requests:
- Mobile:call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify all the fields - Web API or service:make a Place Details (Legacy) request and specify all the
fields (this type of request is the default if you don't specify any fields):
getPlaceDetails()
.
- Places Details
- Basic Data
- Contact Data
- Atmosphere Data
- Mobile:call
[ Enterprise: Places Legacy ]
SKU: Atmosphere Data (Legacy)
A Data SKU that bills for Atmosphere Datafields 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 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
.
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 ratefor 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.
SKU: Contact Data (Legacy)
A Data SKU that bills for Contact Datafields 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 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
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 ratefor 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.
SKU: Places Photo (Legacy)
- Android:Requests to
fetchPhoto()
- iOS:Requests to
loadPlacePhoto:
- JavaScript:Requests to
PlacePhoto.getUrl()
to load image pixel data. - Web service:Requests to the Places API Place Photos service .
Legacy Routes API SKUs
[ Essentials: Routes Legacy ]
SKU: Directions (Legacy)
Category | Essentials | |
---|---|---|
APIs | Maps JavaScript API's Directions Service
, Directions API (Legacy) |
|
Billable event | Successful request with no Pro or Enterprise features | |
Triggers | Queries that don't trigger a higher-rated SKU. | |
Pricing | Main pricing table
India pricing table |
SKU: Distance Matrix (Legacy)
Category | Essentials | |
---|---|---|
APIs | Distance Matrix API (Legacy)
, Maps JavaScript API Distance Matrix Service |
|
Billable event | Each element that doesn't doesn't contain Pro or Enterprise features | |
Triggers | Requests for elements that don't trigger higher-priced SKUs. | |
Pricing | Main pricing table
India pricing table |
[ Pro: Routes Legacy ]
SKU: Directions Advanced (Legacy)
-
duration_in_traffic
. - Between 11 and 25 waypoints .
- Set
waypoints=optimize:true
. - Set one of the following location modifiers
:
-
side_of_road
-
heading
-
SKU: Distance Matrix Advanced (Legacy)
-
duration_in_traffic
field. - Set one of the following location modifiers
:
-
side_of_road
-
heading
-