Autocomplete Data (new)

AutocompleteRequest-Schnittstelle

google.maps.places.AutocompleteRequest Benutzeroberfläche

Anfrageschnittstelle für AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Typ:string
Der Textstring, in dem gesucht werden soll.
includedPrimaryTypes optional
Typ:Array<string> optional
Enthält den primären Ortstyp (z. B. „restaurant“ oder „gas_station“).

Ein Ort wird nur zurückgegeben, wenn sein primärer Typ in dieser Liste enthalten ist. Sie können bis zu fünf Werte angeben. Wenn keine Typen angegeben sind, werden alle Ortstypen zurückgegeben.
includedRegionCodes optional
Typ:Array<string> optional
Es werden nur Ergebnisse in den angegebenen Regionen berücksichtigt. Diese werden als bis zu 15 zweistellige CLDR-Regionscodes angegeben. Eine leere Gruppe schränkt die Ergebnisse nicht ein. Wenn sowohl locationRestriction als auch includedRegionCodes festgelegt sind, befinden sich die Ergebnisse im Schnittbereich.
inputOffset optional
Typ:number optional
Ein nullbasierter Unicode-Zeichenabstand von input, der die Cursorposition in input angibt. Die Cursorposition kann sich darauf auswirken, welche Vorschläge zurückgegeben werden. Wenn keine Angabe erfolgt, wird standardmäßig die Länge von input verwendet.
language optional
Typ:string optional
Die Sprache, in der Ergebnisse zurückgegeben werden sollen. Standardmäßig wird die Spracheinstellung des Browsers verwendet. Die Ergebnisse können in verschiedenen Sprachen vorliegen, wenn die in input verwendete Sprache von language abweicht oder für den zurückgegebenen Ort keine Übersetzung aus der Landessprache in language verfügbar ist.
locationBias optional
Typ:LocationBias optional
Ergebnisse für einen bestimmten Ort höher gewichten.

Es sollte höchstens eine von locationBias oder locationRestriction festgelegt sein. Wenn keines davon festgelegt ist, werden die Ergebnisse durch die IP-Adresse verzerrt. Das bedeutet, dass die IP-Adresse einem ungenauen Standort zugeordnet und als Verzerrungssignal verwendet wird.
locationRestriction optional
Typ:LocationRestriction optional
Ergebnisse auf einen bestimmten Standort beschränken.

Es sollte höchstens eine von locationBias oder locationRestriction festgelegt sein. Wenn keines davon festgelegt ist, werden die Ergebnisse durch die IP-Adresse verzerrt. Das bedeutet, dass die IP-Adresse einem ungenauen Standort zugeordnet und als Verzerrungssignal verwendet wird.
origin optional
Typ:LatLng|LatLngLiteral optional
Der Startpunkt, von dem aus die geodätische Entfernung zum Ziel berechnet werden soll (wird als PlacePrediction.distanceMeters zurückgegeben). Wenn dieser Wert weggelassen wird, wird die geodätische Entfernung nicht zurückgegeben.
region optional
Typ:string optional
Der Regionscode, angegeben als zweistelliger CLDR-Regionscode. Das wirkt sich auf die Adressformatierung, das Ergebnisranking und möglicherweise auch darauf aus, welche Ergebnisse zurückgegeben werden. Die Ergebnisse werden dadurch nicht auf die angegebene Region beschränkt.
sessionToken optional
Ein Token, das eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Erstelle über AutocompleteSessionToken ein neues Sitzungstoken.

Die Sitzung beginnt, wenn der Nutzer mit der Eingabe einer Suchanfrage beginnt, und endet, wenn er einen Ort auswählt und Place.fetchFields aufruft. Jede Sitzung kann mehrere Abfragen und einen fetchFields-Aufruf umfassen. Die Anmeldedaten, 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 Place Autocomplete-Aufrufe.
  • Für jede Sitzung muss ein neues Token generiert werden.
  • 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.

Klasse AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken Kurs

Stellt ein Sitzungstoken dar, das zum Erfassen einer Sitzung mit automatischer Vervollständigung verwendet wird.

Rufe const {AutocompleteSessionToken} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
AutocompleteSessionToken
AutocompleteSessionToken()
Parameter:Keine
Creates a new instance of AutocompleteSessionToken.

Klasse AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion Kurs

Ein Vorschlag für die automatische Vervollständigung.

Rufe const {AutocompleteSuggestion} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parameter: 
Rückgabewert:Promise<{suggestions:Array<AutocompleteSuggestion>}>
Ruft eine Liste mit Vorschlägen für die automatische Vervollständigung ab.
placePrediction
Typ:PlacePrediction optional
Der für Menschen lesbare Name des zurückgegebenen Ergebnisses. Bei Ergebnissen für Unternehmen sind dies in der Regel der Name und die Adresse des Unternehmens.

Klasse PlacePrediction

google.maps.places.PlacePrediction Kurs

Vorhersageergebnisse für eine Place Autocomplete-Vorhersage.

Rufe const {PlacePrediction} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
distanceMeters
Typ:number optional
Die Länge der Geodäten in Metern von origin, falls origin angegeben ist.
mainText
Typ:FormattableText optional
Der Name des Orts.
placeId
Typ:string
Die eindeutige Kennung des vorgeschlagenen Orts. Diese Kennung kann in anderen APIs verwendet werden, die Orts-IDs akzeptieren.
secondaryText
Typ:FormattableText optional
Stellt zusätzliche Merkmale zur Unterscheidung dar (z. B. eine Stadt oder Region), um den Ort weiter zu identifizieren.
text
Der für Menschen lesbare Name des zurückgegebenen Ergebnisses. Bei Ergebnissen für Unternehmen sind dies in der Regel der Name und die Adresse des Unternehmens.

text wird Entwicklern empfohlen, die ein einzelnes UI-Element anzeigen möchten. Entwickler, die zwei separate, aber zusammenhängende UI-Elemente anzeigen möchten, sollten stattdessen PlacePrediction.mainText und PlacePrediction.secondaryText verwenden.
types
Typ:Array<string>
Liste der Typen, die für diesen Ort gelten, aus Tabelle A oder Tabelle B in https://developers.google.com/maps/documentation/places/web-service/place-types.
toPlace
toPlace()
Parameter:Keine
Rückgabewert:Place
Gibt eine Ortsdarstellung dieser PlacePrediction zurück. Für vollständige Details zum Ort ist ein nachfolgender Aufruf von Place.fetchFields erforderlich.

Klasse StringRange

google.maps.places.StringRange Kurs

Ermittelt einen Teilstring in einem bestimmten Text.

Rufe const {StringRange} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
endOffset
Typ:number
Der Offset des letzten Unicode-Zeichens des Teilstrings (ab Null, exklusiv).
startOffset
Typ:number
Der nullbasierte Offset des ersten Unicode-Zeichens des Teilstrings (inklusive).

Klasse FormattableText

google.maps.places.FormattableText Kurs

Text, der eine Ortsvorhersage darstellt. Der Text kann unverändert oder formatiert verwendet werden.

Rufe const {FormattableText} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
matches
Eine Liste von Stringbereichen, die angeben, wo die Eingabeanfrage in FormattableText.text übereinstimmt. Mit den Bereichen können bestimmte Teile von text formatiert werden. Die Teilstrings stimmen möglicherweise nicht genau mit AutocompleteRequest.input überein, wenn die Übereinstimmung anhand anderer Kriterien als der Stringübereinstimmung ermittelt wurde (z. B. Rechtschreibkorrekturen oder Transliterationen). Diese Werte sind Unicode-Zeichenabstände von FormattableText.text. Die Bereiche sind garantiert in aufsteigender Reihenfolge der Offsetwerte angeordnet.
text
Typ:string
Text, der unverändert verwendet oder mit FormattableText.matches formatiert werden kann.