O Google recomenda o uso de sessões com o Autocomplete (New). As sessões ajudam a simplificar os preços e oferecem um modelo consistente para uso com o Autocomplete (novo).
O preço da sessão começa com a primeira solicitação do Autocomplete (novo) que inclui um token de sessão, continua em cada solicitação do Autocomplete (novo) subsequente e é encerrado por uma solicitação do Place Details (novo) ou da Validação de endereço que usa o token de sessão.
Depois que a sessão é encerrada, qualquer chamada para o Autocomplete (novo), Place Details (novo) 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, aquelas que não são encerradas por uma solicitação do Place Details (New) ou da Validação de endereço, são faturadas apenas pelas solicitações de preenchimento automático usando a SKU: Autocomplete Requests.
Os três cenários de preços mais comuns são:
- Preenchimento automático de dados de local
- Preenchimento automático para descoberta de lugares
- Preenchimento automático para finalização da compra e entrega
Preenchimento automático de dados de local
Nesse cenário, você quer usar o Autocomplete e o Place Details (New) para receber informações de localização sobre um lugar. Por exemplo, você seleciona uma sugestão do Autocompletar e usa o Place Details (New) para receber as coordenadas de latitude e longitude do lugar e mostrar esse lugar em um mapa.
As informações de local podem incluir:
- Endereço
- Local como coordenadas de latitude e longitude
- Plus Code
- Tipos
- Janela de visualização
Essa sessão é encerrada por uma única solicitação para o Place Details (New) que solicita todos os campos definidos pela SKU: Place Details Essentials.
Uma sessão começa com a primeira solicitação do Autocomplete (Novo) que inclui um token de sessão, continua com cada solicitação do Autocomplete (Novo) subsequente e é encerrada por uma solicitação do Place Details (Novo) ou da Validação de endereço que usa o token de sessão. Para uma sessão do Autocomplete (novo), o faturamento é feito da seguinte maneira:
- Primeiras 12 solicitações do Autocomplete (novo): o faturamento é feito para cada solicitação do Autocomplete (novo), até um máximo de 12, usando a SKU: solicitações do Autocomplete.
- Para solicitações de Autocomplete (Novo) 13 e mais recentes na mesma sessão: a cobrança é feita na SKU: uso da sessão do Autocomplete, ou seja, não há cobrança por essas solicitações.
- Solicitação de dados do Places ou de validação de endereço:você também vai receber 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 mais do que apenas dados de localização sobre um lugar. Por exemplo, você pode solicitar 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, a sessão é encerrada por uma solicitação do Place Details (New) que solicita qualquer campo incluído nos SKUs do Place Details (New) Pro, Enterprise ou Enterprise + Atmosphere.
A cobrança será feita da seguinte maneira:
- Todas as solicitações de Autocomplete (novo) são faturadas na SKU: uso da sessão do Autocomplete, o que significa que 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 do 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, você encerra a sessão com uma solicitação à API Address Validation para validar o endereço selecionado. A cobrança será feita da seguinte maneira:
- Todas as solicitações de Autocomplete (novo) são faturadas na SKU: uso da sessão do Autocomplete, o que significa que não há cobrança por essas solicitações.
- 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 sua fatura para 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ços sem sessões
Se você não usar sessões, o faturamento será feito por solicitação para o Autocomplete (Novo) usando a SKU: Solicitações de preenchimento automático.
Preço alternativo para sessões incompletas ou abandonadas
Se uma sessão for abandonada, ou seja, não for encerrada por uma chamada para o Place Details (New) ou a Validação de endereço, as solicitações do Autocomplete (New) vão voltar para o modelo de preços por solicitação e serão faturadas de acordo com a SKU: Autocomplete Requests.