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, UUIDs der Version 4
zu verwenden.
Beispiel
Wenn der Nutzer eine Abfrage eingibt, wird alle paar Tasteneingaben (nicht pro Zeichen) eine Anfrage zur automatischen Vervollständigung aufgerufen und eine Liste mit möglichen Ergebnissen zurückgegeben. Wenn der Nutzer eine Auswahl aus der Ergebnisliste trifft, zählt die Auswahl als Anfrage. Alle Anfragen, die während der Suche gestellt werden, werden gebündelt und als eine einzige 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 innerhalb weniger Minuten nach Beginn der Sitzung keine Auswahl trifft, wird nur die Suchanfrage in Rechnung gestellt.
Sehen wir uns diesen Ablauf von Ereignissen aus der Sicht einer App an.
Ein Nutzer beginnt mit der Eingabe einer Abfrage, um nach „Paris, Frankreich“ zu suchen.
Nachdem die App eine Nutzereingabe erkannt hat, erstellt sie ein neues Sitzungstoken: „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 mit potenziellen Ergebnissen an:
„P“
„Par“
„Paris,“
„Paris, Fr“
Wenn der Nutzer eine Auswahl trifft:
Alle Anfragen, die aus der Abfrage resultieren, werden gruppiert und der Sitzung, die durch „Token A“ dargestellt wird, als eine einzige Anfrage hinzugefügt.
Die Auswahl des Nutzers wird als „Place Details“-Anfrage gezählt und der
Sitzung, die durch „Token A“ dargestellt wird, hinzugefügt.
Die Sitzung wird beendet und die App verwirft „Token A“.
Weitere Informationen zur Abrechnung von Anfragen zur automatischen Vervollständigung 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: 2026-05-29 (UTC)."],[],["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"]]
