O Google recomenda o uso de sessões com o Autocomplete (nova geração). As sessões simplificam os preços e oferecem um modelo de preços consistente para uso com o Autocomplete (nova geração).
Uma sessão começa com a primeira solicitação do Autocomplete (nova geração) que inclui um token de sessão, continua com cada solicitação subsequente do Autocomplete (nova geração) e é encerrada por uma solicitação do Place Details (nova geração) ou da Address Validation que usa o token de sessão.
Depois que a sessão é encerrada, qualquer chamada para o Autocomplete (nova geração), o Place Details (nova geração) ou a Address Validation que usa o token de sessão expirado é faturada como se não houvesse token de sessão.
As sessões incompletas, ou seja, aquelas que não são encerradas por uma solicitação do Place Details (nova geração) ou da Address Validation, são faturadas apenas para as solicitações do Autocomplete (nova geração) usando a SKU: Autocomplete Requests.
Faturamento de sessões
Sessões que terminam em uma solicitação do Place Details (nova geração) Essentials
Para sessões do Autocomplete (nova geração) que terminam em uma solicitação usando campos de SKU: Places API Place Details Essentials:
- Primeiras 12 solicitações do Autocomplete (nova geração): você recebe a cobrança de cada solicitação do Autocomplete (nova geração), até um máximo de 12 solicitações, usando a SKU: Autocomplete Requests.
- Para as solicitações do Autocomplete (nova geração) 13 e mais na mesma sessão: você recebe a cobrança da SKU: Autocomplete Session Usage, o que significa que não há cobrança para essas solicitações.
- Place Details (nova geração) Essentials:você também recebe a cobrança da solicitação de encerramento na SKU: Places API Place Details Essentials.
Sessões que terminam em solicitações da Address Validation ou do Place Details (nova geração) (não Essentials)
Para sessões do Autocomplete (nova geração) que terminam em uma solicitação da Address Validation ou do Place Details (nova geração) usando campos do Place Details Pro, Enterprise, ou Enterprise + Atmosphere:
- Solicitações do Autocomplete (nova geração):todas as solicitações do Autocomplete (nova geração) são faturadas na SKU: Autocomplete Session Usage, o que significa que não há cobrança para essas solicitações.
-
Solicitação do Place Details (nova geração) ou da Address Validation:você também recebe a cobrança da
solicitação de encerramento na SKU apropriada:
- As solicitações de encerramento do Place Details (nova geração) são faturadas na SKU: Place Details Enterprise + Atmosphere, independentemente dos campos solicitados.
- As solicitações de encerramento da Address Validation são faturadas na SKU: Address Validation Enterprise.
Cenários de preços de sessões
Os três cenários de preços de sessões mais comuns são:
- Preenchimento automático para dados de localização
- Preenchimento automático para descoberta de lugares
- Preenchimento automático para finalização da compra e entrega
As seções a seguir descrevem as cobranças de faturamento individuais para cada cenário.
Preenchimento automático para dados de localização
No cenário de preenchimento automático para dados de localização, você está interessado em usar o Autocomplete (nova geração) e o Place Details (nova geração) para receber informações de localização sobre um lugar. Por exemplo, você seleciona uma sugestão do Autocomplete (nova geração) e usa o Place Details (nova geração) para receber as coordenadas de latitude e longitude do lugar para mostrá-lo em um mapa.
As informações de localização podem incluir o seguinte:
- Endereço
- Localização como coordenadas de latitude e longitude
- Plus Code
- Tipos
- Janela de visualização
Essa sessão é encerrada por uma única solicitação do Place Details (nova geração) que solicita campos definidos pela SKU: Place Details Essentials.
Você recebe a cobrança da seguinte maneira:
- As primeiras 12 solicitações do Autocomplete (nova geração) são faturadas na SKU: Autocomplete Requests.
- Todas as solicitações restantes do Autocomplete (nova geração) são faturadas na SKU: Autocomplete Session Usage, o que significa que não há cobrança para essas solicitações.
- A solicitação de encerramento do Place Details (nova geração) é cobrada na SKU: Places API Place Details Essentials.
Preenchimento automático para descoberta de lugares
No cenário de preenchimento automático para descoberta de lugares, você está interessado em receber mais do que apenas dados de localização sobre um lugar. Por exemplo, você pode solicitar qualquer um dos seguintes:
- Opções de acessibilidade
- Horário de funcionamento atual
- Opções de estacionamento
- Avaliações
- Classificações
Para esse cenário, sua sessão é encerrada por uma única solicitação do Place Details (nova geração) que solicita qualquer campo incluído nas SKUs Place Details (nova geração) Pro, Enterprise ou Enterprise + Atmosphere.
Você recebe a cobrança da seguinte maneira:
- Todas as solicitações do Autocomplete (nova geração) são faturadas na SKU: Autocomplete Session Usage, o que significa que não há cobrança para essas solicitações.
- A solicitação de encerramento do Place Details (nova geração) é faturada na SKU: Places API Place Details Enterprise + Atmosphere.
Preenchimento automático para finalização da compra e entrega
A API Address Validation é um serviço que aceita um endereço. Ela identifica os componentes do endereço e os valida. Ela também padroniza o endereço para correspondência e encontra as coordenadas de latitude e longitude mais conhecidas.
No cenário de preenchimento automático para finalização da compra e entrega, você encerra a sessão com uma solicitação da API Address Validation para validar o endereço selecionado.
Você recebe a cobrança da seguinte maneira:
- Todas as solicitações do Autocomplete (nova geração) são faturadas na SKU: Autocomplete Session Usage, o que significa que não há cobrança para essas solicitações.
- Uma solicitação opcional do Place Details Essentials é faturada sem custo financeiro, se solicitada antes da solicitação de encerramento da Address Validation.
- A solicitação de encerramento da Address Validation é faturada na SKU: Address Validation Enterprise.
Preços sem sessões
Se você não usar sessões, receberá a cobrança por solicitação do Autocomplete (nova geração) usando a SKU: Autocomplete Requests.
Preços para sessões incompletas ou abandonadas
Se uma sessão for abandonada, ou seja, não encerrada por uma chamada para o Place Details (nova geração) ou a Address Validation, as solicitações do Autocomplete (nova geração) serão revertidas para o modelo de preços por solicitação e serão faturadas per the SKU: Autocomplete Requests.