O Google recomenda usar sessões com o Place Autocomplete. As sessões ajudam a simplificar os preços e oferecem um modelo consistente para uso com o Place Autocomplete.
O preço da sessão começa com a primeira solicitação do Place Autocomplete que inclui um token, continua por cada solicitação subsequente do Place Autocomplete e termina por uma solicitação ao Place Details que usa o token.
Após o encerramento da sessão, qualquer chamada para o Place Autocomplete, o Place Details (novo) que usa o token da sessão expirado é faturada como se não houvesse esse token.
Sessões incompletas, ou seja, que não são encerradas por uma solicitação do Place Details, são cobradas apenas pelas solicitações de preenchimento automático usando SKU: solicitações de preenchimento automático.
Os três cenários de preç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 de compra e entrega
Preenchimento automático para dados de local
Neste cenário, você tem interesse em usar o Autocomplete e o Place Details (novo) para receber informações de localização de um lugar. Por exemplo, você seleciona uma sugestão do preenchimento automático e usa o Place Details para conferir as coordenadas de latitude e longitude do lugar e mostrá-lo em um mapa.
As informações de localização 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 ao Place Details que solicita todos os campos definidos pelo SKU: Place Details (somente local).
A cobrança será feita desta forma:
- Cada solicitação do Place Autocomplete, até um máximo de 12 solicitações, usando o SKU: solicitações do Autocomplete.
- Cobrado em US $2,83 por 1.000 solicitações até 100.000 solicitações
- Cobrado em US $2,27 por 1.000 solicitações até 500.000 solicitações
- As solicitações 13 ou mais recentes do Place Autocomplete enquanto você está em uma sessão ativa são faturadas de acordo com o SKU: uso da sessão do Autocomplete, o que significa que essas solicitações não são cobradas.
- Uma solicitação do Places Details usando SKU: Place Details (Location Only):
- Cobrado em US $5,00 por 1.000 solicitações até 100.000 solicitações
- Cobrado em US $4,00 por 1.000 solicitações até 500.000 solicitações
Preenchimento automático para descoberta de lugares
No cenário do Autocomplete para a descoberta de lugares, você quer saber mais do que apenas os dados de localização de 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, sua sessão é encerrada por uma solicitação para o Place Details (novo), que solicita qualquer campo incluído nas SKUs Basic, Advanced ou Preferencial.
A cobrança será feita desta forma:
- Todas as solicitações do Place Autocomplete são faturadas em SKU: Autocomplete Session Usage, ou seja, elas não são cobradas.
- Uma solicitação de SKU: Place Details (Preferencial):
- Cobrado em US $25,00 por 1.000 solicitações até 100.000 solicitações
- Cobrado em US $20,00 por 1.000 solicitações até 500.000 solicitações
Exemplos de preço
A tabela a seguir mostra exemplos de preços para os três cenários da sessão principal. Esta tabela também lista as SKUs que aparecem no seu extrato para cada cenário.
Cenário | Exemplo de solicitação | SKUs faturadas | Preço por mil solicitações |
---|---|---|---|
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, a cobrança será feita conforme a solicitação do Place Autocomplete usando o SKU: solicitações do Autocomplete a US $2,83 por 1.000 solicitações.
Preços substitutos para sessões incompletas ou abandonadas
Se uma sessão for abandonada, ou seja, não encerrada por uma chamada para o Place Details (novo), as solicitações do Place Autocomplete serão revertidas para o modelo de preços por solicitação e serão cobradas a US$ 2,83 a cada 1.000 solicitações, conforme definido em SKU: solicitações do Autocomplete.