Place Autocomplete usa tokens de sesión para agrupar las fases de consulta y selección de una búsqueda de autocompletado del usuario en una sesión discreta con fines de facturación. La sesión comienza cuando el usuario comienza a escribir una consulta y finaliza cuando selecciona un lugar y se realiza una llamada a Place Details. Cada sesión puede tener varias consultas de autocompletado seguidas de una selección de lugar. Las claves de API que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de Google Cloud Console. Una vez que finaliza una sesión, el token deja de ser válido. Tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro sessiontoken o si vuelves a usar un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).
Recomendamos los siguientes lineamientos:
- Usa tokens de sesión para todas las sesiones de autocompletado.
- Genere un token nuevo para cada sesión.
- Asegúrate de que las claves de API que se usen para todas las solicitudes de Place Autocomplete y Place Details dentro de una sesión pertenezcan al mismo proyecto de Google Cloud Console.
- Asegúrate de pasar un token de sesión único para cada sesión nueva. Usar el mismo token en más de una sesión hará que cada solicitud se facture de forma individual.
De manera opcional, puedes omitir el token de sesión de autocompletado de una solicitud. Si se omite el token de sesión, cada solicitud se factura por separado, lo que activa el SKU Autocomplete, por solicitud. Si vuelves a usar un token de sesión, esta se considera no válida y las solicitudes se cobran como si no se hubiera proporcionado un token de sesión.
Ejemplo
A medida que el usuario escribe una consulta, se llama a una solicitud de autocompletado cada pocas pulsaciones de teclas (no por carácter) y se muestra una lista de resultados posibles. Cuando el usuario hace una selección en la lista de resultados, la selección cuenta como una solicitud, y todas las solicitudes realizadas durante la búsqueda se agrupan y cuentan como una sola solicitud. Si el usuario selecciona un lugar, la consulta de búsqueda estará disponible sin cargo y solo se cobrará la solicitud de datos de lugar. Si el usuario no realiza una selección unos minutos después del inicio de la sesión, solo se cobra la búsqueda.
Examinemos este flujo de eventos desde la perspectiva de una app.
- Un usuario comienza a escribir una consulta para buscar "París, Francia"
- Después de detectar la entrada del usuario, la app crea un nuevo token de sesión, "Token A".
- A medida que el usuario escribe, la API realiza una solicitud de autocompletado cada algunos caracteres y muestra una nueva lista de resultados potenciales para cada uno:
- Cuando el usuario realiza una selección:
- Todas las solicitudes que resultan de la consulta se agrupan y se agregan a la sesión representada por el token A como una única solicitud.
- La selección del usuario se cuenta como una solicitud a Place Details y se agrega a la sesión representada por el token A.
- La sesión concluye, y la aplicación descarta el token.
Para obtener más información sobre cómo se facturan las solicitudes de Autocomplete, consulta Uso y facturación.
Crear tokens de sesión
Puedes crear tokens de sesión con el mecanismo programático que prefieras. Recomendamos usar un UUID de la versión 4 para los tokens de sesión.