Jetons de session

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

Place Autocomplete utilise des jetons de session pour regrouper les phases de requête et de sélection d'une recherche avec saisie semi-automatique d'un utilisateur 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 qu'un appel à Place Details est effectué. Chaque session peut comporter plusieurs requêtes de saisie semi-automatique, suivies d'une sélection de lieu. La ou les clés API utilisées pour chaque requête au sein d'une session doivent appartenir au même projet de la console Google Cloud. 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 si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton 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 au cours d'une session appartiennent au même projet de la console Google Cloud.
  • N'oubliez pas de 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 éventuellement 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 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 n'avait été fourni.

Exemple

Lorsque l'utilisateur saisit une requête, une requête de saisie semi-automatique est appelée à quelques frappes de touches (et non par caractère), et une liste de résultats possibles est 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 au cours 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 dans les minutes qui suivent 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. Lorsqu'elle détecte une entrée utilisateur, l'application crée un jeton de session, "Jeton A".
  3. Au fur et à mesure que l'utilisateur saisit du texte, l'API envoie une requête de saisie semi-automatique à quelques caractères d'intervalle, et affiche une nouvelle liste de résultats potentiels pour chacun d'eux:
    "P"
    "Par"
    "Paris,"
    "Paris, France"
  4. Lorsque l'utilisateur effectue une sélection :
    • Toutes les requêtes résultant de la requête sont regroupées et ajoutées à la session représentée par le "Jeton A", sous la forme d'une requête unique.
    • La sélection effectuée par l'utilisateur est comptabilisée comme une requête Place Details et ajoutée à la session représentée par le "Jeton A".
  5. 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

Pour créer un jeton de session, appelez GMSAutocompleteSessionToken.init().