Place Autocomplete verwendet Sitzungstokens, um die Abfrage- und Auswahlphasen einer automatisch vervollständigten Suche 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 eine Place Details-Anfrage aufgerufen wird. Jede Sitzung kann mehrere Autocomplete-Abfragen gefolgt von einer Ortsauswahl enthalten. Die für jede Anfrage in 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. Die 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 bereitgestellt 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.
- Achten Sie darauf, dass die API-Schlüssel, die für alle „Place Autocomplete“- und „Place Details“-Anfragen innerhalb einer Sitzung verwendet werden, 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 in einer Anfrage optional 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 nach wenigen Tastenanschlägen (nicht pro Zeichen) aufgerufen und eine Liste möglicher Ergebnisse zurückgegeben. Trifft der Nutzer eine Auswahl aus der Ergebnisliste, wird dies als Anfrage gezählt. Alle Anfragen, die während der Suche gestellt wurden, werden gebündelt und als einzelne Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos. Es werden nur die Kosten für die Ortsdatenanfrage berechnet. Wenn der Nutzer innerhalb weniger Minuten nach Beginn der Sitzung keine Auswahl trifft, wird nur die Suchanfrage berechnet.
Sehen wir uns diesen Ereignisfluss aus der Perspektive einer App an.
- Ein Nutzer beginnt mit der Eingabe einer Suchanfrage, um nach "Paris, Frankreich" zu suchen.
- Bei Erkennung der Nutzereingabe erstellt die Anwendung ein neues Sitzungstoken namens „Token A“.
- Während der Nutzer tippt, führt die API alle paar Zeichen eine Anfrage zur automatischen Vervollständigung durch, mit der jeweils eine neue Liste möglicher Ergebnisse angezeigt wird:
"P"
"Par"
"Paris",
"Paris, Fr"
- Wenn der Nutzer eine Auswahl trifft:
- Alle Anfragen, die aus der Abfrage stammen, werden gruppiert und als einzelne Anfrage der Sitzung hinzugefügt, die durch "Token A" dargestellt wird.
- Die Auswahl des Nutzers wird als „Place Details“-Anfrage gezählt und der durch „Token A“ dargestellten Sitzung hinzugefügt.
- Die Sitzung ist 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 einem beliebigen programmatischen Mechanismus erstellen. Wir empfehlen die Verwendung einer UUID der Version 4 für Sitzungstokens.