Sitzungstokens

Plattform auswählen: Android iOS JavaScript Webdienst

Place Autocomplete verwendet Sitzungstokens, um die Abfrage- und Auswahlphasen einer automatischen Vervollständigung durch den Nutzer zu Abrechnungszwecken in einer separaten Sitzung zu gruppieren. Die Sitzung beginnt, wenn der Nutzer mit der Eingabe einer Abfrage beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf von Place Details erfolgt. Jede Sitzung kann mehrere Abfragen für die automatische Vervollständigung, gefolgt von einer Ortsauswahl, enthalten. Die für die einzelnen Anfragen innerhalb einer Sitzung verwendeten API-Schlüssel müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet ist, ist das Token nicht mehr gültig. Ihre Anwendung muss für jede Sitzung ein neues Token generieren. Wenn der Parameter sessiontoken weggelassen wird oder Sie ein Sitzungstoken wiederverwenden, wird die Sitzung so abgerechnet, als wäre kein Sitzungstoken angegeben worden. Jede Anfrage wird separat abgerechnet.

Wir empfehlen folgende Richtlinien:

  • Verwenden Sie Sitzungstokens für alle Sitzungen mit automatischer Vervollständigung.
  • Generieren Sie für jede Sitzung ein neues Token.
  • Die API-Schlüssel, die für alle „Place Autocomplete“- und „Place Details“-Anfragen innerhalb einer Sitzung verwendet werden, müssen zum selben Google Cloud Console-Projekt gehören.
  • Für jede neue Sitzung muss ein eindeutiges Sitzungstoken übergeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage einzeln in Rechnung gestellt.

Sie können das Sitzungstoken für die automatische Vervollständigung optional in einer Anfrage weglassen. Ohne das Sitzungstoken wird jede Anfrage separat abgerechnet und die SKU Autocomplete – Per Request wird ausgelöst. Wenn Sie ein Sitzungstoken wiederverwenden, wird die Sitzung als ungültig betrachtet und die Anfragen werden so abgerechnet, als wäre kein Sitzungstoken angegeben worden.

Beispiel

Während der Nutzer eine Abfrage eingibt, wird eine Anfrage zur automatischen Vervollständigung alle paar Tastenanschläge (nicht pro Zeichen) aufgerufen und eine Liste möglicher Ergebnisse zurückgegeben. Trifft der Nutzer eine Auswahl aus der Ergebnisliste, gilt diese Auswahl als Anfrage. Alle während der Suche gestellten Anfragen werden gruppiert und als einzelne Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos verfügbar und nur die Ortsdatenanfrage wird in Rechnung gestellt. Wenn der Nutzer innerhalb weniger Minuten nach Beginn der Sitzung keine Auswahl trifft, wird nur die Suchanfrage in Rechnung gestellt.

Betrachten wir diesen Ereignisfluss aus der Perspektive einer App.

  1. Ein Nutzer beginnt mit der Eingabe einer Suchanfrage, um nach "Paris, Frankreich" zu suchen.
  2. Nachdem die Nutzereingabe erkannt wurde, erstellt die Anwendung ein neues Sitzungstoken „Token A“.
  3. Während der Nutzer eingibt, stellt die API nach wenigen Zeichen eine Anfrage zur automatischen Vervollständigung. Dabei wird jeweils eine neue Liste mit möglichen Ergebnissen angezeigt:
    „P“
    „Par“
    „Paris“,
    „Paris, Fr“
  4. Wenn der Nutzer eine Auswahl trifft:
    • Alle Anfragen, die aus der Abfrage resultieren, 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 durch „Token A“ dargestellten Sitzung hinzugefügt.
  5. Die Sitzung ist beendet und die App verwirft Token A.

Weitere Informationen zur Abrechnung von Anfragen zur automatischen Vervollständigung finden Sie unter Nutzung und Abrechnung.

Sitzungstokens erstellen

Sie können Sitzungstokens mit einem beliebigen programmatischen Mechanismus erstellen. Wir empfehlen die Verwendung einer UUID der Version 4 für Sitzungstokens.