Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Jetons de session

Les jetons de session sont des chaînes (ou des objets) générées par l'utilisateur qui suivent les appels Autocomplete (nouveau) en tant que sessions. Autocomplete (nouveau) utilise des jetons de session pour regrouper 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.

Les utilisateurs sont responsables de la création de jetons de session pour chaque session. Les jetons de session doivent être des chaînes base64 sécurisées pour les URL et les noms de fichiers. Les utilisateurs peuvent générer des jetons de session de n'importe quelle manière, bien que Google recommande d'utiliser des identifiants uniques universels (UUID) de version 4 pour les jetons de session.

La session commence par un appel à Autocomplete (New) et se termine par un appel à Place Details (New) ou Address Validation. Chaque session peut comporter plusieurs requêtes Autocomplete (New), suivies d'une requête Places Details (New) ou Address Validation. La ou les clés API utilisées pour chaque requête d'une session doivent appartenir au même projet de la console Google Cloud.

Remarque : Les jetons de session ne peuvent pas être échangés entre les points de terminaison de l'API Places et ceux de l'API Places (New) ou de l'API Address Validation. Par exemple, une requête Place Autocomplete peut être suivie d'une requête Place Details dans la même session, mais pas d'une requête Place Details (New) ni d'une requête Address Validation dans la même session.

Les jetons de session se terminent de différentes manières :

• Place Details (New) est appelé.
• Address Validation est appelé.
• La session est abandonnée.

Remarque : Vous pouvez éventuellement omettre le jeton de session Autocomplete (New) d'une requête. Si le jeton de session est omis, chaque requête est facturée séparément et le SKU Autocomplete – Per Request est appliqué.

Lorsque la session prend fin, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque nouvelle session. Si vous omettez le paramètre sessionToken ou si vous réutilisez un jeton de session, la nouvelle session est facturée comme si aucun jeton n'était fourni (chaque requête est facturée séparément).

Pour en savoir plus sur la facturation des requêtes Autocomplete (New), consultez Tarifs d'Autocomplete (New) et des sessions.