In Place Autocomplete (Legacy) werden Sitzungstokens verwendet, um die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammenzufassen. Die Sitzung wird gestartet, wenn der Nutzer mit der Eingabe beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf von „Place Details (Legacy)“ erfolgt. Jede Sitzung kann mehrere Autocomplete-Abfragen und eine Ortsauswahl umfassen. Die API-Schlüssel, die für die einzelnen Anfragen innerhalb einer Sitzung verwendet werden, müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet wird, ist das Token nicht mehr gültig. Ihre Anwendung muss für jede Sitzung ein neues Token generieren. Wenn Sie den sessiontoken-Parameter weglassen oder ein Sitzungstoken wiederverwenden, wird die Sitzung so in Rechnung gestellt, als wäre kein Sitzungstoken bereitgestellt worden. Jede Anfrage wird separat abgerechnet.
Wir empfehlen folgende Richtlinien:
- Verwenden Sie Sitzungstokens für alle Sitzungen, bei denen eine automatische Vervollständigung erfolgt.
- Generieren Sie für jede Sitzung ein neues Token.
- Die API-Schlüssel, die für alle Place Autocomplete (Legacy)- und Place Details (Legacy)-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 weitergegeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage separat in Rechnung gestellt.
Sie können das Sitzungstoken für die automatische Vervollständigung optional aus einer Anfrage weglassen. Wenn das Sitzungstoken weggelassen wird, wird jede Anfrage separat abgerechnet und die SKU Autocomplete – Per Request wird ausgelöst. Wenn Sie ein Token wiederverwenden, wird die Sitzung als ungültig betrachtet und die Anfragen werden so berechnet, als wäre kein Sitzungstoken angegeben worden.
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 nur die Anfrage für Ortsdaten wird in Rechnung gestellt. Wenn der Nutzer nicht innerhalb weniger Minuten nach Beginn der Sitzung eine Auswahl trifft, wird nur die Suchanfrage in Rechnung gestellt.
Betrachten Sie diesen Ablauf aus der Perspektive einer App:
- Ein Nutzer beginnt mit der Eingabe einer Suchanfrage nach „Paris, Frankreich“.
- Wenn die App eine Nutzereingabe 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 potenzieller Ergebnisse an:
„P“
„Par“
„Paris,“
„Paris, Fr“
- Wenn der Nutzer eine Auswahl trifft:
- Alle Anfragen, die sich aus der Abfrage ergeben, werden gruppiert und der Sitzung, die durch „Token A“ dargestellt wird, 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 „Place Autocomplete (Legacy)“-Anfragen finden Sie unter Nutzung und Abrechnung.
Sitzungstokens erstellen
Rufen Sie GMSAutocompleteSessionToken.init() auf, um ein Sitzungstoken zu erstellen.