Sitzungstokens fassen die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammen.
Sitzungstoken erstellen
Nutzer sind dafür verantwortlich, für jede Sitzung eindeutige Sitzungstokens zu generieren. Google empfiehlt die Verwendung von UUIDs der Version 4.
Beispiel
Während der Nutzer eine Anfrage eingibt, wird alle paar Tastendrücke (nicht pro Zeichen) eine Autocomplete-Anfrage aufgerufen und eine Liste möglicher Ergebnisse zurückgegeben. Wenn der Nutzer eine Auswahl aus der Ergebnisliste trifft, wird diese Auswahl als Anfrage gezählt. Alle Anfragen, die während der Suche gestellt werden, werden gebündelt und als eine einzelne Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos. Es wird nur die Anfrage für Ortsdaten in Rechnung gestellt. Wenn der Nutzer nicht innerhalb weniger Minuten nach Beginn der Sitzung eine Auswahl trifft, wird nur die Suchanfrage in Rechnung gestellt.
Sehen wir uns diesen Ablauf von Ereignissen aus der Perspektive einer App an.
Ein Nutzer beginnt mit der Eingabe einer Suchanfrage nach „Paris, Frankreich“.
Wenn die App eine Nutzereingabe erkennt, wird ein neues Sitzungstoken erstellt: „Token A“.
Während der Nutzer tippt, sendet die API alle paar Zeichen eine Anfrage zur automatischen Vervollständigung und zeigt für jede Anfrage eine neue Liste potenzieller Ergebnisse an:
„B“
„Ber“
„Berlin“
„Berlin, De“
Wenn der Nutzer eine Auswahl trifft:
Alle Anfragen, die sich aus der Abfrage ergeben, werden gruppiert und der Sitzung, die durch „Token A“ dargestellt wird, als einzelne Anfrage hinzugefügt.
Die Auswahl des Nutzers wird als „Place Details“-Anfrage gezählt und der Sitzung hinzugefügt, die durch „Token A“ dargestellt wird.
Die Sitzung wird beendet und die App verwirft „Token A“.
Weitere Informationen zur Abrechnung von Autocomplete-Anfragen finden Sie unter Nutzung und Abrechnung.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]
