Sitzungstokens verwenden

Plattform auswählen: Android iOS Webdienst

Sitzungstokens gruppieren die Abfrage- und Auswahlphasen der automatischen Vervollständigung durch Nutzer zu Abrechnungszwecken in eine diskrete Sitzung suchen.

Sitzungstoken erstellen

Die Nutzer sind dafür verantwortlich, eindeutige Sitzungstokens für jede Sitzung zu generieren. Google empfiehlt die Verwendung von UUIDs der Version 4.

Beispiel

Während der Nutzer eine Anfrage eingibt, wird alle paar Mal eine Anfrage zur automatischen Vervollständigung aufgerufen. Tastenanschlägen (nicht pro Zeichen) und eine Liste möglicher Ergebnisse wird zurückgegeben. Wann? wenn der Nutzer eine Auswahl in der Ergebnisliste trifft, wird diese als und alle während der Suche gestellten Anfragen werden gebündelt und gezählt, als Einzelanfrage. Wenn der Nutzer einen Ort auswählt, wird die Suchanfrage angezeigt. kostenlos und nur die Ortsdatenanfrage wird in Rechnung gestellt. Wenn die Nutzenden treffen Sie innerhalb weniger Minuten nach Beginn der Sitzung eine Auswahl, in Rechnung gestellt.

Sehen wir uns diesen Ereignisfluss aus der Perspektive einer App an.

  1. Ein Nutzer beginnt mit der Eingabe einer Suchanfrage, um nach „Paris, Frankreich“ zu suchen.
  2. Nach Erkennung von Nutzereingaben erstellt die App eine neue Sitzung „Token A“.
  3. Während der Nutzer tippt, führt die API alle paar Mal eine Anfrage zur automatischen Vervollständigung durch. Zeichen, wodurch jeweils eine neue Liste mit möglichen Ergebnissen angezeigt wird:
    „P“
    „Par“
    „Paris“
    „Paris, Fr“
  4. Wenn der Nutzer eine Auswahl trifft:
    • Alle aus der Abfrage resultierenden Anfragen werden gruppiert und dem Sitzung, dargestellt durch „Token A“, als einzelne Anfrage.
    • Die Auswahl des Nutzers wird als Ortsdetailanfrage gezählt und hinzugefügt für die Sitzung, die durch „Token A“ dargestellt wird.
  5. Die Sitzung wird beendet und die App verwirft das Token A.

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