Place Autocomplete utilise des jetons de session pour regrouper les phases de requête et de sélection d'une recherche de saisie semi-automatique des utilisateurs dans une session distincte à des fins de facturation. La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu et passe un appel Place Details. Chaque session peut comporter plusieurs requêtes de saisie semi-automatique, suivies d'une sélection de lieu. Les clés API utilisées pour chaque requête au cours d'une session doivent appartenir au même projet Google Cloud Console. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si le paramètre sessiontoken est omis ou que vous réutilisez un jeton de session, la session est facturée comme si aucun jeton de session n'était fourni (chaque requête est facturée séparément).
Nous vous recommandons de respecter les consignes suivantes:
- Utiliser des jetons de session pour toutes les sessions de saisie semi-automatique.
- Générez un nouveau jeton pour chaque session.
- Assurez-vous que la ou les clés API utilisées pour toutes les requêtes Place Autocomplete et Place Details dans une session appartiennent au même projet Google Cloud Console.
- Veillez à transmettre un jeton de session unique pour chaque nouvelle session. Si vous utilisez le même jeton pour plusieurs sessions, chaque requête est facturée individuellement.
Vous pouvez omettre le jeton de session de saisie semi-automatique d'une requête. Si le jeton de session est omis, chaque requête est facturée séparément, ce qui déclenche le code SKU Autocomplete - Per Request. Si vous réutilisez un jeton de session, la session est considérée comme non valide, et les requêtes sont facturées comme si aucun jeton de session n'était fourni.
Exemple
Lorsque l'utilisateur saisit une requête, une requête de saisie semi-automatique est appelée à quelques reprises (et non par caractère). Une liste de résultats possibles est alors renvoyée. Lorsque l'utilisateur effectue une sélection dans la liste des résultats, celle-ci est comptabilisée comme une requête. 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 de lieu est facturée. Si l'utilisateur n'effectue pas de sélection quelques minutes après 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.
- Un utilisateur commence à saisir une requête pour rechercher "Paris, France".
- Lorsqu'elle détecte une entrée utilisateur, l'application crée un jeton de session ("Token A").
- À mesure que l'utilisateur saisit du texte, l'API effectue une requête de saisie semi-automatique tous les deux ou trois caractères. Elle affiche une nouvelle liste de résultats potentiels pour chaque requête :
"
" &Parce
; Paris &
- Lorsque l'utilisateur effectue une sélection :
- Toutes les requêtes générées par la requête sont regroupées et ajoutées à la session représentée par le "jeton A" comme une seule requête.
- La sélection de l'utilisateur est comptabilisée comme une requête Places Details et est ajoutée à la session représentée par le 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 page Utilisation et facturation.
Créer des jetons de session
Vous pouvez créer des jetons de session en utilisant le mécanisme programmatique de votre choix. Nous vous recommandons d'utiliser un UUID de version 4 pour les jetons de session.