Places API Usage and Billing  |  Google for Developers (2024)

• Home
• Products
• Google Maps Platform
• Documentation
• Places API
• Guides

The Places API (New) and Places API uses apay-as-you-go pricing model.Places API (New) and Places API requests generate calls to anyof multiple SKUs.Along with the overall Google Terms of Use, there areusage limits specific to the Places API.Manage your costs and usage with tools available in theGoogle Cloud Console.

How the Places API is billed

The Places API (New) and Places API uses a pay-as-you-go pricing model.The Google Maps Platform APIsand SDKs are billed by SKU. Usage is tracked for each SKU, and any API or SDK may have more than oneproduct SKU. Cost is calculated by:

SKU usage × Price per use

Use our Pricingand Usage calculator to estimate your usage cost per API or SDK. For qualifyingGoogle Maps Platform SKUs, a $200 USD Google Maps Platform credit is available each monthfor each billing account. This credit is automaticallyapplied¹ to the qualifying SKUs.

Pricing for the Places API (New)

About field masks

For Place Details (New),Nearby Search (New), andText Search (New), use the FieldMask header inAPI requests to specify the list of fields to return in the response. You arethen billed at the highest SKU applicable to your request. That means if youselect fields in both the (Basic) SKU and the (Advanced) SKU, you are billedbased on the (Advanced) SKU.

Using field masking is a good design practice to ensure that you don't requestunnecessary data, which helps to avoid unnecessary processing time and billingcharges.

SKU: Place Details (IDs Only)

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

SKU: Place Details (Basic)

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

Web service: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, location, primaryType, primaryTypeDisplayName, plusCode, shortFormattedAddress, subDestinations, types, utcOffsetMinutes, viewport

SKU: Place Details (Advanced)

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

Web service: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

SKU: Place Details (Preferred)

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

SKU: Nearby Search (Basic)

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

SKU: Nearby Search (Advanced)

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

Web service: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

SKU: Nearby Search (Preferred)

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

SKU: Text Search (ID Only)

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

SKU: Text Search (Basic)

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

Web service: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

SKU: Text Search (Advanced)

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

Web service: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

SKU: Text Search (Preferred)

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

SKU: Place Photo

A Place Photo SKU is charged for each request to the API.

Pricing for the Places API

About Autocomplete sessions

An Autocomplete session includes some Autocomplete requests (to retrieve suggestions on aplace as the user types), and at most one Places Details request (to retrieve details aboutthe place selected by the user). The same session token is passed to the Autocomplete and thesubsequent Place Detail request. A session starts with the first Autocomplete request (whichtypically happens when the user starts typing). A Places Details call is made when the userhas 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 newsession 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’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 usersession. If you reuse a session token, the session is considered invalid and the requestsare charged as if no session token was provided.

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

About Places Data SKUs

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

One or more Data SKUs are triggered for:

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

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

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

• Places Details
• Find Place

For the web service, these Places APIs calls DO NOT support specifying the returnedfields. These calls always return all the Places data, charging the three Places Data SKUs inaddition 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 theresponse to only those fields specified. Fields in the Basic category are included inthe base cost of the Places requestand do not result in any additional charge. The Basic Data SKU is triggered whenany 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, GMSPlaceFieldBusinesssStatus, 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, oran array of Place.Fields for Android or iOS, you canlimit the response to only those fields specified. Fields in the Contactcategory result in an additional charge. The Contact Data SKU is triggeredwhen 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, or GMSPlaceFieldWebsite
• 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 canlimit the response to only those fields specified. Fields in the Atmospherecategory result in an additional charge. The Atmosphere Data SKU istriggered 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, or Place.Field.USER_RATINGS_TOTAL
• iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating,GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup,GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer,GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch or GMSPlaceFieldServesVegetarianFood.
• JavaScript: See Fields (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, or user_ratings_total.

SKU: Autocomplete – Per Request

The Autocomplete – Per Request SKU is charged for any of these calls orrequests that do not include a session token:

• Android:findAutocompletePredictions()
• iOS:findAutocompletePredictionsFromQuery:
• JavaScript: the Maps JavaScript API’s Place Autocomplete service
• Web service: thePlaces 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 theMaps JavaScript API’sPlace Autocomplete Widget may be charged an Autocomplete – Per Request SKU in case calls are madefrom an invalid Autocomplete session. This may happen when a user is typing multiple different addressesor copy/pasting different addresses into the widget and not always selects an autocomplete prediction.

SKU: Autocomplete without Place Details – Per Session

The Autocomplete without Place Details – Per Session SKU is charged for anAutocomplete session thatdoes not include a Place Details request (within a few minutes of the beginningof 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 (whenviewing 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

The Autocomplete (included with Place Details) – Per SessionSKU is charged for an Autocomplete sessionthat includes any of:

• Android: a call to fetchPlace()
• iOS: a call to fetchPlaceFromPlaceID:
• Web service: a Place Details request

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

A Place Details request generates Data SKUs (Basic,Contact, and/or Atmosphere)– 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 the place_id field)during an autocomplete session are billed as SKU: Autocompletewithout 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 a FetchPlaceRequestincluding the Place ID, and the ADDRESS field)

iOS

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

Web service

• 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 (whenviewing 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

A Query Autocomplete – Per Request SKU is charged for each request to:

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

Pricing by Autocomplete session is not supported using Query Autocomplete. SubsequentPlaces Details calls get charged based on regularPlaces Details pricing.

SKU: Place Details

Place Details calls are charged as follows:

The Place Details SKU 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 a place 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 isprovided or not.

A Place Details call or request also generates Data SKUs (Basic,Contact, and/or Atmosphere), dependingon the fields that are specified in the call or request. If NO fields are specifiedin the Place Details call or request, ALL Data SKUs are triggered, andyou 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: 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 (price starting at 0.017 USD per session)
   • Basic Data (billed at 0.00 USD)
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 (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: 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 do not specify any fields): getPlaceDetails().
   On your bill, you will see these SKUs listed (when viewing 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 (whenviewing your bill by SKU):

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

SKU: Find Place

Find Place is charged for a Find Place request.

Find Place requests also generate Data SKUs (Basic,Contact, and/or Atmosphere), depending onthe fields that are specified in the request. Like Place Detailsrequests, you can use the fields parameter in your Find Place request to limit the responseto only those fields specified. You are billed for the Find Place request as well as the datarequested. By default, if NO fields 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 only is charged for Find Place requests that onlyspecify the Place ID to be returned. By default, if no fields are specified in the Find Placerequest, only the place id is returned.

Example

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

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

SKU: Place – Nearby Search

Place – Nearby Search is charged for requests to theMaps JavaScript API’s Place Nearby Search service(nearbySearch()), or to thePlaces API Nearby Search service

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

Example

You make a Nearby Search request, such as NearbySearch (San Francisco, 100 meters).On your bill, you will see these SKUs listed (whenviewing 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 Search is charged for requests to theMaps JavaScript API’s Place Text Search service(textSearch()), or to thePlaces API Text Search service.

Text Search requests return a list of places, but do not supportspecifying which fields are returned. Text Search requests return asubset 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 thedata-type SKUs (Basic Data, Contact Data,and Atmosphere Data).

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

Example

You make a Text Search request, such as TextSearch(123 Main Street). On your bill,you will see these SKUs listed (whenviewing 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

A Place Photo SKU is charged for:

• Android: calls to fetchPhoto()
• iOS: calls to loadPlacePhoto:
• JavaScript: to Places Library, Maps JavaScript API’s Place Photos service when requesting data from the URLs returned by PlacePhoto.getUrl() to load image pixel data
• Web service: requests to the Places API Place Photos service

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

Other usage limits

While there is no maximum number of requests per day, the followingusage limits still apply:

• Places API (New): Rate limit is 600 QPM(requests per minute) per API method per project. Meaning each API methodhas a separate quota.

• Places API: Rate limit is 6,000 QPM (requests perminute). It is calculated as the sum of client-side and server-side requestsfor all applications using the credentials of the same project.

Terms of Use restrictions

For information on terms of use, seepolicies for the Places API, and theLicense Restrictions sectionof the Google Maps Platform Terms of Service.

Manage your cost of use

To manage your cost of use of the Places API or to meet the demands of your productiontraffic, set daily quota limits on all requests to any API. Daily quotas are reset atmidnight Pacific time.

To view or change quota limits for the Places API:

1. In the Cloud Console, open the Google Maps Platform Quotas page.
2. Click the APIs drop-down and select the Places API.
3. To view the quota limits, scroll down to the Requests card.
   A table lists the quota names and limits.
4. To change a quota limit, click the Edit icon for that limit.
   In the dialog that appears, in the Quota Limit field, enter the preferred billable daily quota limit (up to the quota limit, if any, specified by Google) and select Save.

If your API usage reaches your billable quota limit on any given day, your application will notbe 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