Os tokens de sessão agrupam as fases de consulta e seleção do preenchimento automático de um usuário pesquisa em uma sessão discreta para fins de cobrança.
Criar um token de sessão
Os usuários são responsáveis por gerar tokens exclusivos para cada sessão. O Google recomenda o uso da versão 4 dos UUIDs.
Exemplo
À medida que o usuário digita uma consulta, uma solicitação de preenchimento automático é chamada em intervalos (não por caractere) e uma lista de possíveis resultados será retornada. Quando o usuário faz uma seleção na lista de resultados, a seleção conta como um e todas as solicitações feitas durante a pesquisa são agrupadas e contadas como uma única solicitação. Se o usuário selecionar um lugar, a consulta de pesquisa estará disponível sem custos financeiros, e apenas a solicitação de dados de lugar é cobrada. Se o usuário não fazer uma seleção alguns minutos após o início da sessão, apenas o e a consulta de pesquisa é cobrada.
Vamos examinar esse fluxo de eventos da perspectiva de um aplicativo.
- Um usuário começa a digitar uma consulta para pesquisar "Paris, França".
- Ao detectar a entrada do usuário, o app cria uma nova sessão "Token A".
- À medida que o usuário digita, a API faz uma solicitação de preenchimento automático
caracteres, mostrando uma nova lista de possíveis resultados para cada:
“P”
“Par”
"Paris"
"Paris, Sx"
- Quando o usuário faz uma seleção:
- Todas as solicitações resultantes da consulta são agrupadas e adicionadas ao representada pelo "Token A" como uma única solicitação.
- A seleção do usuário é contada como uma solicitação de Place Details e adicionada à sessão representada pelo "Token A".
- A sessão é concluída, e o app descarta o "Token A".
Para mais informações sobre como as solicitações de preenchimento automático são faturadas, consulte Uso e Faturamento.