Utiliser des jetons de session

Cette fonctionnalité nécessite l'activation de l'API Places (nouvelle version), la nouvelle génération de l'API Places. Pour en savoir plus, consultez Activer des API.

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 version 4.

Remarque :Les jetons de session peuvent se chevaucher entre les projets Google Cloud Console, mais ils doivent être uniques par projet. Par exemple, une application utilisant le projet A et une application utilisant le projet B peuvent utiliser le même jeton de session, mais plusieurs applications utilisant le projet A ne peuvent pas utiliser le même jeton de session.

Exemple

Lorsque l'utilisateur saisit une requête, une requête de saisie semi-automatique est appelée au bout de quelques frappes (et non par caractère), et une liste des 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 Autocomplete, consultez la section Utilisation et facturation.