Usa tokens de sesión

Selecciona la plataforma: Android iOS Servicio web

Los tokens de sesión agrupan las etapas de consulta y selección de la búsqueda con autocompletado de un usuario en una sesión discreta para realizar la facturación correspondiente.

Crea un token de sesión

Los usuarios son responsables de generar tokens de sesión únicos para cada sesión. Google recomienda usar UUID de la versión 4.

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 posibles resultados. Cuando el usuario selecciona un elemento de la lista de resultados, la selección se considera una solicitud, y todas las solicitudes realizadas durante la búsqueda se agrupan y se consideran una sola solicitud. Si el usuario selecciona un lugar, la búsqueda está disponible sin cargo, y solo se cobra la solicitud de datos de Place. Si el usuario no realiza una selección en los primeros minutos de la sesión, solo se cobrará la búsqueda.

Examinemos este flujo de eventos desde la perspectiva de una app.

  1. Un usuario comienza a escribir una búsqueda para encontrar "París, Francia".
  2. Cuando detecta la entrada del usuario, la app crea un nuevo token de sesión, "Token A".
  3. A medida que el usuario escribe, la API realiza una solicitud de autocompletado cada pocos caracteres y muestra una nueva lista de posibles resultados para cada uno:
    "P"
    "Par"
    "Paris,"
    "Paris, Fr"
  4. Cuando el usuario hace una selección, ocurre lo siguiente:
  • Todas las solicitudes que resulten de la consulta se agruparán y se agregarán a la sesión representada por el "Token A" como una sola solicitud.
  • La selección del usuario se cuenta como una solicitud de Place Details y se agrega a la sesión representada por el "Token A".
  • La sesión finaliza y la app descarta el "Token A".

Para obtener más información sobre cómo se facturan las solicitudes de Autocomplete, consulta Uso y facturación.