Utiliser des jetons de session

Sélectionnez une plate-forme: Android iOS Service Web

Les jetons de session regroupent les phases de requête et de sélection d'une recherche de saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation.

Créer un jeton de session

Les utilisateurs sont chargés de générer des jetons de session uniques pour chaque session. Google recommande d'utiliser les UUID de la version 4.

Exemple

Lorsque l'utilisateur saisit une requête, une requête de saisie semi-automatique est appelée toutes les quelques frappes (et non par caractère), et une liste de résultats possibles est renvoyée. Lorsque l'utilisateur fait une sélection dans la liste de résultats, la sélection est comptabilisée comme une requête, et toutes les requêtes effectuées lors de la recherche sont regroupées et comptabilisées comme une seule requête. Si l'utilisateur sélectionne un lieu, la requête de recherche est disponible sans frais, et seule la requête de données sur le lieu est facturée. Si l'utilisateur ne fait pas de sélection dans les quelques minutes suivant le début de la session, seule la requête de recherche est facturée.

Examinons ce flux d'événements du point de vue d'une application.

  1. Un utilisateur commence à saisir une requête pour rechercher "Paris, France".
  2. Lorsque l'application détecte une entrée utilisateur, elle crée un nouveau jeton de session, "Jeton A".
  3. À mesure que l'utilisateur saisit du texte, l'API envoie une requête de saisie semi-automatique tous les quelques caractères, et affiche une nouvelle liste de résultats potentiels pour chacun:
    "P"
    "Par"
    "Paris,"
    "Paris, Fr"
  4. Lorsque l'utilisateur fait une sélection:
  • Toutes les requêtes issues de la requête sont regroupées et ajoutées à la session représentée par "Jeton A", en tant que requête unique.
  • La sélection de l'utilisateur est comptabilisée comme une requête Place Details et ajoutée à la session représentée par "Jeton A".
  • La session est terminée, et l'application supprime le jeton A.

Pour en savoir plus sur la facturation des requêtes de saisie semi-automatique, consultez Utilisation et facturation.