Sitzungstokens fassen die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammen.
Sitzungstoken erstellen
Die 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 Suchanfrage eingibt, wird alle paar Tastenanschläge (nicht pro Zeichen) eine Autocomplete-Anfrage aufgerufen und eine Liste möglicher Ergebnisse zurückgegeben. Wenn der Nutzer eine Auswahl in der Ergebnisliste trifft, wird die Auswahl als Anfrage gezählt. Alle während der Suche gestellten Anfragen werden zusammengefasst und als einzelne Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos und nur die Ortsdatenanfrage wird berechnet. Trifft der Nutzer nicht innerhalb weniger Minuten nach Beginn der Sitzung eine Auswahl, wird nur die Suchanfrage berechnet.
Sehen wir uns diesen Ablauf aus der Perspektive einer App an.
- Ein Nutzer beginnt mit der Eingabe einer Suchanfrage, um nach „Paris, Frankreich“ zu suchen.
- Wenn die App Nutzereingaben erkennt, erstellt sie ein neues Sitzungstoken, „Token A“.
- Während der Nutzer tippt, sendet die API alle paar Zeichen eine Autocomplete-Anfrage und zeigt für jede Anfrage eine neue Liste mit möglichen Ergebnissen an:
„P“
„Par“
„Paris,“
„Paris, Fr“ - Wenn der Nutzer eine Auswahl trifft:
- Alle aus der Abfrage resultierenden Anfragen werden als einzelne Anfrage gruppiert und der Sitzung hinzugefügt, die durch „Token A“ dargestellt wird.
- Die Auswahl des Nutzers wird als „Place Details“-Anfrage gezählt und der Sitzung mit dem Token „A“ hinzugefügt.
- Die Sitzung ist beendet und die App verwirft „Token A“.
Weitere Informationen zur Abrechnung von Autocomplete-Anfragen finden Sie unter Nutzung und Abrechnung.