Sitzungstokens verwenden

Plattform auswählen: Android iOS Webdienst

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 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 aus der Ergebnisliste trifft, zählt die Auswahl als Anfrage. Alle während der Suche gestellten Anfragen werden gebündelt und als eine einzige Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos und 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.

  1. Ein Nutzer beginnt mit der Eingabe einer Suchanfrage nach „Paris, Frankreich“.
  2. Wenn die App eine Nutzereingabe erkennt, erstellt sie ein neues Sitzungstoken, „Token A“.
  3. Während der Nutzer tippt, stellt die API alle paar Zeichen eine Anfrage zur automatischen Vervollständigung und zeigt für jede Anfrage eine neue Liste potenzieller Ergebnisse an:
    „P“
    „Par“
    „Paris,“
    „Paris, Fr“
  4. Wenn der Nutzer eine Auswahl trifft:
  • Alle Anfragen, die sich aus der Abfrage ergeben, werden gruppiert und der durch „Token A“ dargestellten Sitzung 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 ist beendet und die App verwirft „Token A“.

Informationen zur Abrechnung von Autocomplete-Anfragen finden Sie unter Nutzung und Abrechnung.