Google recommends that you use sessions with Autocomplete (New). Sessions help simplify pricing and provide a consistent pricing model for use with Autocomplete (New).
A session starts with the first Autocomplete (New) request that includes a session token, continues through each subsequent Autocomplete (New) request, and is then terminated by a request to Place Details (New) or Address Validation that uses the session token.
After the session terminates, any call to Autocomplete (New), Place Details (New), or Address Validation that uses the expired session token is billed as if there was no session token.
Incomplete sessions, meaning sessions that are not terminated by a request to Place Details (New) or Address Validation, are billed only for the Autocomplete (New) requests using the SKU: Autocomplete Requests.
Session billing
Sessions terminating in a Place Details (New) Essentials request
For Autocomplete (New) sessions that terminate in a request using fields from SKU: Places API Place Details Essentials:
- First 12 Autocomplete (New) requests: You are billed for each Autocomplete (New) request, up to a maximum of 12 requests, using the SKU: Autocomplete Requests.
- For Autocomplete (New) requests 13 and higher in the same session: You are billed at the SKU: Autocomplete Session Usage, meaning there is no charge for those requests.
- Place Details (New) Essentials: You are also billed for the terminating request at SKU: Places API Place Details Essentials.
Sessions terminating in Address Validation or Place Details (New) (non-Essentials) requests
For Autocomplete (New) sessions that terminate in an Address Validation request or a Place Details (New) request using fields from Place Details Pro, Enterprise, or Enterprise + Atmosphere:
- Autocomplete (New) requests: All Autocomplete (New) requests are billed at the SKU: Autocomplete Session Usage, meaning there is no charge for those requests.
-
Place Details (New) or Address Validation request: You are also billed for the
terminating request at the appropriate SKU:
- Place Details (New) terminating requests are billed at SKU: Place Details Enterprise + Atmosphere, regardless of the fields requested.
- Address Validation terminating requests are billed at SKU: Address Validation Enterprise.
Session pricing scenarios
The three most common session pricing scenarios are:
- Autocomplete for location data
- Autocomplete for place discovery
- Autocomplete for checkout and delivery
The following sections describe the individual billing charges for each scenario.
Autocomplete for location data
In the Autocomplete for location data scenario, you are interested in using Autocomplete (New) and Place Details (New) to obtain location information about a place. For example, you select a suggestion from Autocomplete (New), then use Place Details (New) to get the place's latitude and longitude coordinates to show that place on a map.
Location information can include the following:
- Address
- Location as latitude and longitude coordinates
- Plus Code
- Types
- Viewport
This session is terminated by a single request to Place Details (New) that requests fields defined by the SKU: Place Details Essentials.
You are then billed as follows:
- The first 12 Autocomplete (New) requests are billed at the SKU: Autocomplete Requests.
- Any remaining Autocomplete (New) requests are billed at the SKU: Autocomplete Session Usage, meaning there is no charge for those requests.
- The terminating Place Details (New) request is charged at the SKU: Places API Place Details Essentials.
Autocomplete for place discovery
In the Autocomplete for place discovery scenario, you are interested in obtaining more than just location data about a place. For example, you might request any of the following:
- Accessibility options
- Current opening hours
- Parking options
- Reviews
- Ratings
For this scenario, your session is terminated by a single request to Place Details (New) that requests any fields included in the Place Details (New) Pro, Enterprise, or Enterprise + Atmosphere SKUs.
You are then billed as follows:
- All Autocomplete (New) requests are billed at the SKU: Autocomplete Session Usage, meaning there is no charge for those requests.
- The terminating Place Details (New) request is billed at SKU: Places API Place Details Enterprise + Atmosphere.
Autocomplete for checkout and delivery
The Address Validation API is a service that accepts an address. It identifies address components and validates them. It also standardizes the address for mailing and finds the best known latitude and longitude coordinates for it.
In the Autocomplete for checkout and delivery scenario, you terminate the session with a request to the Address Validation API to validate the selected address.
You are then billed as follows:
- All Autocomplete (New) requests are billed at the SKU: Autocomplete Session Usage, meaning there is no charge for those requests.
- An optional Place Details Essentials request is billed at no charge, if requested before the terminating Address Validation request.
- The terminating Address Validation request is billed at the SKU: Address Validation Enterprise.
Pricing without sessions
If you don't use sessions, you are billed per request to Autocomplete (New) using the SKU: Autocomplete Requests.
Pricing for incomplete or abandoned sessions
If a session is abandoned, meaning not terminated by a call to Place Details (New) or Address Validation, Autocomplete (New) requests revert to the per-request pricing model and are billed per the SKU: Autocomplete Requests.