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, 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.

  1. Ein Nutzer beginnt mit der Eingabe einer Abfrage, um nach „Paris, Frankreich“ zu suchen.
  2. Wenn die App eine Nutzereingabe erkennt, erstellt sie ein neues Sitzung token, "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 mit potenziellen Ergebnissen an:
    „P“
    „Par“
    „Paris,“
    „Paris, Fr“
  4. Wenn der Nutzer eine Auswahl trifft:
    • Alle Anfragen, die aus der Abfrage resultieren, werden gruppiert und der Sitzung hinzugefügt, die durch "Token A" dargestellt wird. Sie werden als eine einzige Anfrage gezählt.
    • Die Auswahl des Nutzers wird als „Place Details“-Anfrage gezählt und der Sitzung hinzugefügt, die durch „Token A“ dargestellt wird.
  5. 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.