O Google recomenda o uso de sessões com o Autocomplete (novo). As sessões ajudam a simplificar os preços e oferecem um modelo de preços consistente para uso com o Autocomplete (novo).
Uma sessão começa com a primeira solicitação do Autocomplete (New) que inclui um token de sessão, continua em cada solicitação subsequente do Autocomplete (New) e é encerrada por uma solicitação do Place Details (New) ou do Address Validation que usa o token de sessão.
Depois que a sessão termina, qualquer chamada para o Autocomplete (New), Place Details (New) ou Address Validation que use 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 (novo) ou Address Validation, são faturadas apenas para as solicitações do Autocomplete (novo) usando a SKU: Autocomplete Requests.
Faturamento por sessão
Sessões que terminam em uma solicitação do Place Details (New) Essentials
Para sessões do Autocomplete (novo) que terminam em uma solicitação usando campos da SKU: Places API Place Details Essentials:
- 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, usando a SKU: Autocomplete Requests.
- Para solicitações do Autocomplete (New) 13 e mais recentes na mesma sessão: você vai receber uma cobrança pela SKU: Autocomplete Session Usage, ou seja, não há cobrança por essas solicitações.
- Place Details (New) Essentials: a solicitação de encerramento também é faturada na SKU: API Places – Place Details Essentials.
Sessões que terminam em solicitações de Address Validation ou Place Details (New) (não Essentials)
Para sessões do Autocomplete (novo) que terminam em uma solicitação do Address Validation ou do Place Details (novo) usando campos do Place Details Pro, Enterprise ou Enterprise + Atmosphere:
- Solicitações do Autocomplete (novo): todas as solicitações do Autocomplete (novo) são faturadas na SKU: Autocomplete Session Usage, ou seja, não há cobrança por elas.
-
Solicitação do Place Details (New) ou do Address Validation: você também vai receber uma cobrança pela solicitação de encerramento na SKU apropriada:
- As solicitações de encerramento do Place Details (novo) são faturadas como SKU: Place Details Enterprise + Atmosphere, independentemente dos campos solicitados.
- As solicitações de encerramento da Address Validation são cobradas na SKU: Address Validation Enterprise.
Cenários de preços de sessões
Os três cenários mais comuns de preços de sessão 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
As seções a seguir descrevem as cobranças de faturamento individuais para cada cenário.
Preenchimento automático para dados de local
No cenário de preenchimento automático para dados de local, você quer usar o Autocomplete (novo) e o Place Details (novo) para receber informações de localização sobre um lugar. Por exemplo, você seleciona uma sugestão do Autocomplete (New) e usa o Place Details (New) para ver as coordenadas de latitude e longitude do lugar e mostrá-lo em um mapa.
As informações de localização 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 ao Place Details (New) que pede campos definidos pela SKU: Place Details Essentials.
A cobrança então será feita desta forma:
- As primeiras 12 solicitações do Autocomplete (New) são faturadas na SKU: Autocomplete Requests.
- Todas as solicitações restantes do Autocomplete (New) são faturadas na SKU: Autocomplete Session Usage, ou seja, não há cobrança por elas.
- A solicitação final do Place Details (novo) é cobrada na SKU: API Places – Place Details Essentials.
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 local sobre um lugar. Por exemplo, você pode solicitar:
- 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 única solicitação ao Place Details (New) que solicita 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 (New) são faturadas na SKU: Autocomplete Session Usage, ou seja, não há cobrança por elas.
- A solicitação final do Place Details (New) é faturada como SKU: Places API Place Details Enterprise + Atmosphere.
Preenchimento automático para finalização de compra e entrega
A API Address Validation é um serviço que aceita um endereço. Identifica e valida os componentes do endereço. Ela 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 de compra e entrega, você encerra 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 (New) são faturadas na SKU: Autocomplete Session Usage, ou seja, não há cobrança por elas.
- Uma solicitação opcional do Place Details Essentials é faturada sem custo financeiro, se solicitada antes da solicitação de encerramento do 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, a cobrança será feita por solicitação ao Autocomplete (New) usando a SKU: Autocomplete Requests.
Preços 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 (novo) ou o Address Validation, as solicitações do Autocomplete (novo) vão voltar ao modelo de preços por solicitação e serão faturadas de acordo com a SKU: Autocomplete Requests.