O Google recomenda usar sessões com o Autocomplete (novo). As sessões ajudam a simplificar os preços e oferecem um modelo consistente para uso com o Autocomplete (novo).
O preço por sessão começa com a primeira solicitação do Autocomplete (New) que inclui um token de sessão, continua com cada solicitação subsequente do Autocomplete (New) e é encerrado por uma solicitação do Place Details (New) ou da Address Validation que usa o token de sessão.
Depois que a sessão termina, qualquer chamada para Autocomplete (New), Place Details (New) ou Address Validation que usa o token de sessão expirado é faturada como se não houvesse um token de sessão.
As sessões incompletas, ou seja, que não são encerradas por uma solicitação de Place Details (New) ou Address Validation, são faturadas apenas pelas solicitações do Autocomplete usando a SKU: Autocomplete Requests.
Os três cenários de precificação mais comuns são:
- Preenchimento automático para dados de local
- Preenchimento automático para descoberta de lugares
- Preenchimento automático para finalização da compra e entrega
Preenchimento automático para dados de local
Neste cenário, você quer usar o Autocomplete e o Place Details (novo) para receber informações de localização sobre um lugar. Por exemplo, você seleciona uma sugestão do preenchimento automático e usa os detalhes do lugar (novo) para receber as coordenadas de latitude e longitude do lugar e mostrá-lo em um mapa.
As informações de local podem incluir:
- 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 (New) que pede qualquer campo definido pela SKU: Place Details Essentials.
Uma sessão começa com a primeira solicitação do Autocomplete (New) que inclui um token de sessão, continua com cada solicitação subsequente do Autocomplete (New) e é encerrada por uma solicitação para Place Details (New) ou Address Validation que usa o token de sessão. Para uma sessão do Autocomplete (novo), a cobrança é feita da seguinte forma:
- Primeiras 12 solicitações do Autocomplete (novo): você recebe uma cobrança por cada solicitação do Autocomplete (novo), até um máximo de 12 solicitações, usando o SKU: solicitações do Autocomplete.
- Para solicitações do Autocomplete (New) 13 e superiores na mesma sessão: você recebe uma cobrança na SKU: Autocomplete Session Usage, ou seja, não há cobrança para essas solicitações.
- Solicitação de Place Details ou Address Validation:você também recebe uma cobrança pela solicitação final usando essas SKUs.
Preenchimento automático para descoberta de lugares
No cenário de preenchimento automático para descoberta de lugares, você quer obter mais do que apenas dados de localização sobre um lugar. Por exemplo, você pode pedir qualquer uma das seguintes opções:
- Opções de acessibilidade
- Horário de funcionamento atual
- Opções de estacionamento
- Avaliações
- Classificações
Nesse cenário, sua sessão é encerrada por uma solicitação do Place Details (New) que pede qualquer campo incluído nas SKUs Pro, Enterprise ou Enterprise + Atmosphere do Place Details (New).
A cobrança então será feita desta forma:
- Todas as solicitações do Autocomplete (novo) são faturadas na SKU: uso da sessão do Autocomplete, ou seja, não há cobrança por essas solicitações.
Preenchimento automático para finalização da compra e entrega
A API Address Validation é um serviço que aceita um endereço. Ele identifica e valida os componentes de endereço. Ele também padroniza o endereço para correspondência e encontra as coordenadas de latitude e longitude mais conhecidas para ele.
No cenário de preenchimento automático para finalização da compra e entrega, encerre a sessão com uma solicitação à API Address Validation para validar o endereço selecionado. A cobrança então será feita desta forma:
- Todas as solicitações do Autocomplete (novo) são faturadas na SKU: uso da sessão do Autocomplete, ou seja, não há cobrança por essas solicitações.
- Uma solicitação opcional de SKU: Place Details Essentials.
- Uma solicitação de SKU: Address Validation Enterprise.
Exemplos de preços
A tabela a seguir mostra exemplos de preços para os três principais cenários de sessão. Essa tabela também lista as SKUs que aparecem na fatura em cada cenário.
| Cenário | Exemplo de solicitação | SKUs faturadas | Solicitações faturadas |
|---|---|---|---|
| Dados de local |
|
|
|
| Descoberta de lugares |
|
|
|
| Finalização da compra e entrega |
|
|
Exemplo de preço sem sessões
Se você não usar sessões, o faturamento será por solicitação ao Autocomplete (New) usando a SKU: Autocomplete Requests.
Preços alternativos para sessões incompletas ou abandonadas
Se uma sessão for abandonada, ou seja, não encerrada por uma chamada para o Place Details (New) ou a Address Validation, as solicitações do Autocomplete (New) vão voltar ao modelo de preços por solicitação e serão cobradas de acordo com a SKU: Autocomplete Requests.