Bei Place Autocomplete werden Sitzungstokens verwendet, um die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammenzufassen. Die Sitzung beginnt, wenn der Nutzer mit der Eingabe beginnt, und endet, wenn er einen Ort auswählt und ein „Place Details“-Aufruf erfolgt. Jede Sitzung kann mehrere Autocomplete-Abfragen und eine Ortsauswahl umfassen. Die API-Schlüssel, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zu demselben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet wird, ist das Token nicht mehr gültig. Ihre App 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 mit automatischer Vervollständigung.
- Generiere 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 weitergegeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage separat in Rechnung gestellt.
Sie können das Autocomplete-Sitzungstoken optional aus einer Anfrage auslassen. Wenn das Sitzungstoken weggelassen wird, wird jede Anfrage separat abgerechnet. Dadurch wird die SKU Autocomplete – Per Request ausgelöst. Wenn Sie ein Sitzungstoken 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 in der Ergebnisliste trifft, wird die Auswahl als Anfrage gezählt. Alle während der Suche getätigten Anfragen werden zusammengefasst und als einzelne Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos und es wird nur die Anfrage für Ortsdaten berechnet. 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 aus der Perspektive einer App an.
- Ein Nutzer beginnt, eine Suchanfrage für „Paris, Frankreich“ einzugeben.
- Wenn die App Nutzereingaben erkennt, erstellt sie ein neues Sitzungstoken, „Token A“.
- Während der Nutzer tippt, sendet die API alle paar Zeichen eine Anfrage für die automatische Vervollständigung und zeigt für jede Anfrage eine neue Liste mit möglichen Ergebnissen an:
„P“
„Par“
„Paris,“
„Paris, Fr“
- Wenn der Nutzer eine Auswahl trifft:
- Alle Anfragen, die aus der Abfrage resultieren, 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 mit dem Token „A“ hinzugefügt.
- Die Sitzung wird beendet und die App verwirft „Token A“.
Weitere Informationen zur Abrechnung von Autocomplete-Anfragen finden Sie unter Nutzung und Abrechnung.
Sitzungstokens erstellen
Sie können Sitzungstokens mit dem gewünschten programmatischen Mechanismus erstellen. Wir empfehlen, für Sitzungstokens eine UUID der Version 4 zu verwenden.