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).
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.
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 do Place Details (novo) ou da Address Validation, são faturadas apenas pelas 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 (New) 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 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.
- Place Details (New) Essentials:você também recebe uma cobrança pela solicitação de encerramento na SKU: Places API 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 (New) que terminam em uma solicitação de Address Validation ou de Place Details (New) 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: uso da sessão do Autocomplete, ou seja, não há cobrança por essas solicitações.
-
Solicitação de Place Details (novo) ou Address Validation:você também recebe uma cobrança pela
solicitação de encerramento na SKU apropriada:
- As solicitações de encerramento do Place Details (New) são faturadas como SKU: Place Details Enterprise + Atmosphere, independente dos campos solicitados.
- As solicitações de encerramento da Address Validation são faturadas com a SKU: Address Validation Enterprise.
Cenários de preços de sessão
Os três cenários mais comuns de precificação por sessão 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
As seções a seguir descrevem os custos de faturamento individuais para cada cenário.
Preenchimento automático para dados de local
No cenário de dados de localização do Autocomplete, você quer usar o Autocomplete (novo) e o Place Details (novo) para obter informações de localização sobre um lugar. Por exemplo, você seleciona uma sugestão do Autocomplete (novo) e usa o Place Details (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 campos definidos pela SKU: Place Details Essentials.
A cobrança então será feita desta forma:
- As primeiras 12 solicitações do Autocomplete (novo) são faturadas na SKU: solicitações do Autocomplete.
- Todas as solicitações restantes do Autocomplete (New) são cobradas na SKU: uso da sessão do Autocomplete, ou seja, não há cobrança para essas solicitações.
- A solicitação final do Place Details (novo) é 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ê 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 única 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 com a SKU: Autocomplete Session Usage, ou seja, não há cobrança para essas solicitações.
- A solicitação de Place Details (novo) de encerramento é faturada na SKU: API Places 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. 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 com a SKU: Autocomplete Session Usage, ou seja, não há cobrança para essas solicitações.
- Uma solicitação opcional do Place Details Essentials não é cobrada se for feita antes da solicitação de validação de endereço de encerramento.
- A solicitação de validação de endereço de encerramento é faturada na SKU: Address Validation Enterprise.
Preços 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 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.