Maps JavaScript API Usage and Billing

The Maps JavaScript API uses apay-as-you-go pricing model. Maps JavaScript API requests generate calls to two different SKUs depending on the type of request: map loadsorpanoramas. Calls to thePlaces Library, Maps JavaScript APIand other JavaScript servicesare priced separately from JavaScript native SKUs. Along with the overall Google Terms of Use, there areusage limits specific to the Maps JavaScript API. Manage your costs and usagewith tools available in the Google Cloud Console.

How the Maps JavaScript API is billed

The Maps JavaScript API uses a pay-as-you-go pricing model. The Google Maps Platform APIs and SDKs are billed by SKU. Usage is tracked for each SKU, and any API or SDK may have more than one product SKU.Cost is calculated by

Use ourPricing and Usage calculatorto estimate your usage cost per API or SDK. For qualifying Google Maps Platform SKUs, a $200 USD Google Maps Platform credit is available each month for each billing account. This credit is automatically applied to the qualifying SKUs.

Pricing for the Maps JavaScript API

SKU: Dynamic Maps

An application that displays either a map loaded with or without amap ID usingMaps JavaScript API,or a map loaded with amap IDand using either theMaps SDK for Androidor Maps SDK for iOS.

User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads.

SKU: Dynamic Street View

Street View panoramas and map loads are now charged separately. A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, Maps SDK for iOSapplication.

An instantiation of a panorama object occurs:

• InJavaScript,with the google.maps.StreetViewPanorama()class or Map.getStreetView()method. Neither the built-in Street View experience based on the Street View Pegman control nor usage of the StreetViewService()class is charged.
• OnAndroid,with one of StreetViewPanoramaFragment,SupportStreetViewPanoramaFragment, orStreetViewPanoramaViewclasses. A panorama is counted each time the relatedonCreate()method is called.
• OniOS,with the GMSPanoramaViewobject.

Pricing for Places Library, Maps JavaScript API

SKU: Autocomplete Requests

AnAutocomplete RequestsSKU is charged for each request to the Autocomplete (New) API that does not include a session token.

It is also charged if you use session tokens and either:

• Terminate the sessions by a single request to Place Details (New) that requests any fields defined by theSKU: Place Details (Location Only).
  • Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests.
  • Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage.
• Abandon the session or end the session by making a call to the SKU: Place Details (IDs Only).All Autocomplete (New) requests are then billed using theSKU: Autocomplete Requests.

SKU: Autocomplete Session Usage

AnAutocomplete Session UsageSKU is charged for each request to the Autocomplete (New) API that includes a session token.

This SKU is charged in these scenarios:

• Autocomplete session terminated by a call toSKU: Place Details (Location Only):

  • Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests.
  • Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage.

• Autocomplete session terminated with a call toSKU: Place Details (Basic, Advanced, or Preferred).

  A Place Details call that requestsany fieldfrom the SKU: Place Details (Basic, Advanced, or Preferred)is billed at the SKU: Place Details (Preferred).

• Autocomplete session terminated with a call toSKU: Address Validation Preferred.

SKU: Place Details (IDs Only)

Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonly request the following fields:

Places Library, Maps JavaScript API: id, photos

SKU: Place Details (Location Only)

Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, types, viewport

SKU: Place Details (Basic)

Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, primaryTypeDisplayName, svgIconMaskURI, types, utcOffsetMinutes

SKU: Place Details (Advanced)

Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

SKU: Place Details (Preferred)

Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: allowsDogs, editorialSummary, evChargeOptions, fuelOptions, hasCurbsidePickup, hasDelivery, hasDineIn, hasLiveMusic, hasMenuForChildren, hasOutdoorSeating, hasRestroom, hasTakeout, hasWifi, isGoodForChildren, isGoodForGroups, isGoodForWatchingSports, isReservable, parkingOptions, paymentOptions, priceLevel, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine

SKU: Nearby Search (Basic)

Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, id, location, photos, plusCode, svgIconMaskURI, types, utcOffsetMinutes, viewport

SKU: Nearby Search (Advanced)

Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

SKU: Nearby Search (Preferred)

Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: allowsDogs, editorialSummary, evChargeOptions, fuelOptions, hasCurbsidePickup, hasDelivery, hasDineIn, hasLiveMusic, hasMenuForChildren, hasOutdoorSeating, hasRestroom, hasTakeout, hasWifi, isGoodForChildren, isGoodForGroups, isGoodForWatchingSports, isReservable, parkingOptions, paymentOptions, priceLevel, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine

SKU: Text Search (ID Only)

Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: id

SKU: Text Search (Basic)

Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, location, photos, plusCode, svgIconMaskURI, types, utcOffsetMinutes, viewport

SKU: Text Search (Advanced)

Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

SKU: Text Search (Preferred)

Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when youonlyrequest the following fields:

Places Library, Maps JavaScript API: allowsDogs, editorialSummary, evChargeOptions, fuelOptions, hasCurbsidePickup, hasDelivery, hasDineIn, hasLiveMusic, hasMenuForChildren, hasOutdoorSeating, hasRestroom, hasTakeout, hasWifi, isGoodForChildren, isGoodForGroups, isGoodForWatchingSports, isReservable, parkingOptions, paymentOptions, priceLevel, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine

SKU: Place Photo

APlace PhotoSKU is charged for each request to the API.

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 (ie, 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 serviceor the Maps JavaScript API’s 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’s 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 should not be used for more than one user session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.

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

About Places Data SKUs

One or more Data SKUs are triggered for:

• Android:each request tofetchPlace()orfindCurrentPlace()
• iOS:each call tofetchPlaceFromPlaceID:orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
• Web service:each Places request depending on the fields specified in the request

Data SKUs are always chargedin addition tothe 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 SKUandthe Place Details SKU.

For the web service, these Places APIs calls support specifying the data fields to return:

• Places Details
• Find Place

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

• Places – Nearby Search
• Places – Text Search

SKU: Basic Data

Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in theBasiccategory are included in the base cost of the Places request and do not result in any additional charge. TheBasic DataSKU is triggered when any of these fields are requested:

• Android:Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL,Place.Field.ID, Place.Field.LAT_LNG,Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE,Place.Field.TYPES, Place.Field.VIEWPORT,Place.Field.UTC_OFFSET,or Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
• iOS:GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus,GMSPlaceFieldID, GMSPlaceFieldCoordinate,GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes,or GMSPlaceFieldViewport
• Web service:address_component, adr_address,business_status, formatted_address,geometry,icon, name,permanently_closed,photo, place_id,plus_code,type, url,utc_offset,vicinity,or wheelchair_accessible_entrance

SKU: Contact Data

Using the fields parameter in your Place Details or Find Place request for web services, or an array ofPlace.Fields for Android or iOS, you can limit the response to only those fields specified. Fields in theContact category result in an additional charge. TheContact DataSKU is triggered when any of these fields are requested:

• Android:Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER,Place.Field.SECONDARY_OPENING_HOURS,or Place.Field.WEBSITE_URI
• iOS:GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber,orGMSPlaceFieldWebsite
• Web service:formatted_phone_number, international_phone_number,opening_hours, current_opening_hours,secondary_opening_hours,or website

SKU: Atmosphere Data

Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in theAtmosphere category result in an additional charge. TheAtmosphere DataSKU is triggered when any of these fields are requested:

• Android:Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, Place.Field.DINE_IN,Place.Field.PRICE_LEVEL,Place.Field.RATING, Place.Field.RESERVABLE,Place.Field.SERVES_BEER,Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH,Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH,Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE,Place.Field.TAKEOUT,orPlace.Field.USER_RATINGS_TOTAL
• iOS:GMSPlaceFieldPriceLevel,GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal,GMSPlaceFieldTakeout,GMSPlaceFieldDelivery,GMSPlaceFieldDineIn,GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast,GMSPlaceFieldServesLunch,GMSPlaceFieldServesDinner,GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine,GMSPlaceFieldServesBrunchorGMSPlaceFieldServesVegetarianFood.
• JavaScript:SeeFields (Place details)
• Web service: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,oruser_ratings_total.

SKU: Autocomplete – Per Request

TheAutocomplete – Per RequestSKU is charged for any of these calls or requests that do not include a session token:

• Android: findAutocompletePredictions()
• iOS: findAutocompletePredictionsFromQuery:
• JavaScript:the Maps JavaScript API’s Place Autocomplete service
• Web service:the Places API Place Autocomplete service

Calls made from an invalid Autocomplete session (for example, a session that reuses a session token) are also charged an Autocomplete – Per Request SKU.

Autocomplete requests from the Maps JavaScript API’s Place Autocomplete Widgetmay be charged an Autocomplete – Per Request SKU in case calls are made from an invalid Autocomplete session. This may happen when a user is typing multiple different addresses or copy/pasting different addresses into the widget and not always selects an autocomplete prediction.

SKU: Autocomplete without Place Details – Per Session

TheAutocomplete without Place Details – Per SessionSKU is charged for an Autocomplete sessionthat does not includea Place Details request (within a few minutes of the beginning of the session).

Example

If your application issues these two calls in a single session:

Android

• findAutocompletePredictions()(.setQuery(” par” ),.setSessionToken(XYZ))
• findAutocompletePredictions()(.setQuery(” paris” ),.setSessionToken(XYZ))

iOS

• placesClient?.findAutocompletePredictions(fromQuery: "par"...
• placesClient?.findAutocompletePredictions(fromQuery: "paris"...

Web service

• Place Autocomplete Request(input=” par”, session_token: XYZ)
• Place Autocomplete Request(input=” paris”, session_token: XYZ)

On your bill, you will see this SKU listed (when viewing your bill by SKU):

• Autocomplete without Place Details – Per Session (price starting at 0.017 USD per session)

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

TheAutocomplete (included with Place Details) – Per Session SKU is charged for anAutocomplete session that includes any of:

• Android:a call tofetchPlace()
• iOS:a call tofetchPlaceFromPlaceID:
• Web service:a Place Details request

The autocomplete request is available at no charge, and the subsequent Place Details call gets charged based on regular Place Details pricing.

A Place Details request generates Data SKUs (Basic, Contact,and/orAtmosphere) – depending on the fields that are specified in the request.

If you do not specify fields in the Place Details request, all Data SKUs are triggered (Basic, Contact, and Atmosphere).

Place Details ID refresh requests (requests that specify only theplace_idfield) during an autocomplete session are billed asSKU: Autocomplete without Place Details – Per Session.

Example

If your application issues the following three calls in a single session:

Android

• findAutocompletePredictions()(.setQuery(” par” ),.setSessionToken(XYZ))
• findAutocompletePredictions()(.setQuery(” paris” ),.setSessionToken(XYZ))
• fetchPlace()(with aFetchPlaceRequest including the Place ID, and the ADDRESS field)

iOS

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

Web service

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

On your bill, you will see these SKUs listed (when viewing your bill by SKU):

• Autocomplete (included with Place Details) – Per Session (billed at 0.00 USD)
• Place Details (price starting at 0.017 USD per session)
• Basic Data (billed at 0.00 USD)

SKU: Query Autocomplete – Per Request

AQuery Autocomplete – Per RequestSKU is charged for each request to:

• JavaScript:the Maps JavaScript API’s Places Autocomplete Service(getQueryPredictions()) and the use of the Maps JavaScript API’s SearchBox widget(Query Autocomplete requests are generated as the user types).
• Web service:the Places API Query Autocomplete service

Pricing by Autocomplete session is not supported using Query Autocomplete. Subsequent Places Details calls get charged based on regular Places Details pricing.

SKU: Place Details

Place Details calls are charged as follows:

ThePlace DetailsSKU is generated from these APIs:

• Android:Places SDK for Android (fetchPlace())
• iOS:Places SDK for iOS (fetchPlaceFromPlaceID:)
• JavaScript: Maps JavaScript API’s Place Details service(getDetails)
• JavaScript: Maps JavaScript API’s Place Autocomplete widget(getPlace)
• JavaScript: Maps JavaScript API’s Place SearchBox widget:getPlaces() method after the user selects aplace result(icon: pin), *not* a query (icon: magnifier), as illustrated here:

  

• Web service: Places API Place Details service

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

A Place Details call or request also generates Data SKUs (Basic, Contact,and/orAtmosphere), depending on the fields that are specified in the call or request. IfNOfields are specified in the Place Details call or request,ALLData SKUs are triggered, and you are charged for the Places Details call or request plus the cost of all the data.

Examples

1. Make one of these calls or requests:
   • Mobile:callfetchPlace()on Android orfetchPlaceFromPlaceID: on iOS, and specify just theADDRESSfield
   • 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 (whenviewing your bill by SKU):
   • Place Details (price starting at 0.017 USD per session)
   • Basic Data (billed at 0.00 USD)
2. Make one of these calls or requests:
   • Mobile:callfetchPlace()on Android orfetchPlaceFromPlaceID: on iOS, and specify just thePHONE_NUMBERfield
   • 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 (whenviewing your bill by SKU):
   • Place Details (price starting at 0.017 USD per session)
   • Contact Data (price starting at 0.003 USD per request)
3. Make one of these calls or requests:
   • Mobile:callfetchPlace()on Android orfetchPlaceFromPlaceID: 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 do not specify any fields):getPlaceDetails().
   On your bill, you will see these SKUs listed (whenviewing your bill by SKU):
   • Place Details (price starting at 0.017 USD per session)
   • Basic Data (billed at 0.00 USD)
   • Contact Data (price starting at 0.003 USD per request)
   • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Place Details – ID Refresh

Use the Place Details request to refresh stale place IDs.These types of requests are available at no charge.

Example

Make a Place Details request specifying just the place id field: getPlaceDetails(fields: place_id). On your bill, you will see this SKU listed (when viewing your bill by SKU):

• Place Details – ID Refresh (billed at 0.00 USD)

SKU: Find Place

Find Placeis charged for a Find Place request.

Find Place requests also generateData SKUs(Basic, Contact,and/orAtmosphere), depending on the fields that are specified in the request. Like Place Details requests, you can use the fields parameter in your Find Place request to limit the response to only those fields specified. You are billed for the Find Place request as well as the data requested. By default, ifNOfields are requested, only the place id is returned, so no additional data charges are incurred.

Examples

1. You make a Find Place request and specify just the address field: FindPlace(fields: formatted_address).On your bill, you will see these SKUs listed (when viewing your bill by SKU):
   • Find Place (price starting at 0.017 USD per call)
   • Basic Data (billed at 0.00 USD)
2. You make a Find Place request and specify the phone number field: FindPlace(fields: formatted_phone_number).On your bill, you will see these SKUs listed (when viewing your bill by SKU):
   • Find Place (price starting at 0.017 USD per call)
   • Contact Data (price starting at 0.003 USD per request)
3. You make a Find Place request and specify fields from all three data-type buckets: FindPlace(fields: formatted_address, opening_hours, price_level).On your bill, you will see these SKUs listed (when viewing your bill by SKU):
   • Find Place (price starting at 0.017 USD per call)
   • Basic Data (billed at 0.00 USD)
   • Contact Data (price starting at 0.003 USD per request)
   • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Find Place – ID only

Find Place – ID onlyis charged for Find Place requests that only specify the Place ID to be returned. By default, if no fields are specified in the Find Place request, only the place id is returned.

Example

You make a Find Place request and only specify theplace_idfield:FindPlace(fields: place_id). On your bill, you will see this SKU listed (when viewing your bill by SKU):

• Find Place – ID only (billed at 0.00 USD)

SKU: Place – Nearby Search

Place – Nearby Searchis charged for requests to the Maps JavaScript API’s Place Nearby Search service (nearbySearch()), or to the Places API Nearby Search service

Nearby Search requests return a list of places, but do not support specifying which fields are returned. Nearby Search requests return a subset of the supported data fields.You are charged for the Nearby Search request starting at 0.032 USD per each, as well as all of the data-type SKUs (Basic Data, Contact Data,andAtmosphere Data).

Example

You make a Nearby Search request, such asNearbySearch (San Francisco, 100 meters). On your bill, you will see these SKUs listed (when viewing your bill by SKU):

• Place - Nearby Search (price starting at 0.032 USD per call)
• Basic Data (billed at 0.00 USD)
• Contact Data (price starting at 0.003 USD per request)
• Atmosphere Data (price starting at 0.005 USD per request)

SKU: Place – Text Search

Place – Text Searchis charged for requests to the Maps JavaScript API’s Place Text Search service (textSearch()), or to the Places API Text Search service.

Text Search requests return a list of places, but do not 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 starting at 0.032 USD per each, as well as all of the data-type SKUs (Basic Data,Contact Data, andAtmosphere Data).

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

Example

You make a Text Search request, such asTextSearch(123 Main Street).On your bill, you will see these SKUs listed (when viewing your bill by SKU):

• Place - Text Search (price starting at 0.032 USD per call)
• Basic Data (billed at 0.00 USD)
• Contact Data (price starting at 0.003 USD per request)
• Atmosphere Data (price starting at 0.005 USD per request)

SKU: Place Photo

APlace PhotoSKU is charged for:

• Android:calls tofetchPhoto()
• iOS:calls toloadPlacePhoto:
• JavaScript:toPlaces Library, Maps JavaScript API’s Place Photos servicewhen requesting data from the URLs returned byPlacePhoto.getUrl() to load image pixel data
• Web service:requests to the Places API Place Photos service

For the JavaScript service, invoking thePlacePhoto.getUrl()method does not cause billing until the URL is actually used to obtain pixel data.

Pricing for JavaScript services

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

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

Other usage limits

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

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

Photorealistic 3D Maps in Maps JavaScript usage limits

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

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

Terms of Use restrictions

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

Manage your cost of use

To manage your cost of use of the Maps JavaScript API or to meet the demands of your production traffic, set daily quota limits on all requests to any API. Daily quotas are reset at midnight Pacific time.

To view or change quota limits for the Maps JavaScript API:

1. In the Cloud Console, open theGoogle Maps Platform Quotaspage.
2. Click the APIs drop-down and select theMaps JavaScript API.
3. To view the quota limits, scroll down to theRequests card.
   A table lists the quota names and limits.
4. To change a quota limit, click theEditicon for that limit.
   In the dialog that appears, in theQuota Limitfield, enter the preferred billable daily quota limit (up to the quota limit, if any, specified by Google) and selectSave.

If your API usage reaches your billable quota limit on any given day, your application will not be able to access the API for the remainder of that day.

Related cost management resources

• Google Maps Platform Billing & Pricing
• Google Maps Platform Reporting & Monitoring