Places Autocomplete Service

Klasse AutocompleteService

google.maps.places.AutocompleteService Kurs

Enthält Methoden zum Abrufen automatischer Vervollständigungen.

Rufe const {AutocompleteService} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
AutocompleteService
AutocompleteService()
Parameter:Keine
Erstellt eine neue Instanz des AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parameter: 
Rückgabewert:Promise<AutocompleteResponse>
Ruft automatische Vervollständigungen für Orte basierend auf der angegebenen Autocomplete-Anfrage ab.
getQueryPredictions
getQueryPredictions(request, callback)
Parameter: 
Rückgabewert:Keiner
Ruft automatische Vervollständigungen für Suchanfragen auf Grundlage der angegebenen Anfrage ab.

AutocompletionRequest-Schnittstelle

google.maps.places.AutocompletionRequest Benutzeroberfläche

Eine Anfrage zur automatischen Vervollständigung, die an AutocompleteService.getPlacePredictions gesendet werden soll.
input
Typ:string
Der Nutzer hat einen Eingabestring eingegeben.
bounds optional
Grenzen für die Voreingenommenheit der Vorhersage. Bei den Vorhersagen wird der angegebene bounds berücksichtigt, es werden aber nicht nur Vorhersagen für diesen bounds erstellt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
componentRestrictions optional
Die Komponenteneinschränkungen. Mit Komponenteneinschränkungen können Sie die Vorhersagen auf die übergeordnete Komponente beschränken. Zum Beispiel das Land.
language optional
Typ:string optional
Eine Sprachkennung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen (falls möglich). Ergebnisse in der ausgewählten Sprache werden möglicherweise höher gelistet, aber Vorschläge sind nicht auf diese Sprache beschränkt. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng optional
Standort für die Vorhersagevoreingenommenheit. Die Vorhersagen sind dann auf die angegebenen location und radius ausgerichtet. Alternativ kann auch bounds verwendet werden.
locationBias optional
Typ:LocationBias optional
Eine weiche Grenze oder ein Hinweis, der bei der Suche nach Orten verwendet wird.
locationRestriction optional
Typ:LocationRestriction optional
Grenzen, um die Suchergebnisse einzuschränken.
offset optional
Typ:number optional
Die Zeichenposition im Eingabebegriff, an der der Dienst Text für Vorschläge verwendet (die Position des Cursors im Eingabefeld).
origin optional
Typ:LatLng|LatLngLiteral optional
Der Standort, von dem aus AutocompletePrediction.distance_meters berechnet wird.
radius optional
Typ:number optional
Der Radius des Bereichs, der für die Vorhersageverzerrung verwendet wird. radius wird in Metern angegeben und muss immer mit einer location-Eigenschaft kombiniert werden. Alternativ kann auch bounds verwendet werden.
region optional
Typ:string optional
Ein Regionscode, der für die Formatierung und Filterung von Ergebnissen verwendet wird. Die Vorschläge werden nicht auf dieses Land beschränkt. Der Regionscode kann ein zweistelliger Wert für eine Länderspezifische Top-Level-Domain (ccTLD) sein. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, mit folgenden Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch für die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“).
sessionToken optional
Eindeutige Referenz, mit der einzelne Anfragen in Sitzungen zusammengefasst werden.
types optional
Typ:Array<string> optional
Die Arten von Vorhersagen, die zurückgegeben werden sollen. Informationen zu den unterstützten Typen finden Sie im Entwicklerhandbuch. Wenn keine Typen angegeben sind, werden alle Typen zurückgegeben.

AutocompleteResponse-Schnittstelle

google.maps.places.AutocompleteResponse Benutzeroberfläche

Eine Autocomplete-Antwort, die vom Aufruf von AutocompleteService.getPlacePredictions zurückgegeben wird und eine Liste von AutocompletePredictions enthält.
predictions
Die Liste der AutocompletePrediction.

Schnittstelle QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest Benutzeroberfläche

Eine Anfrage für die automatische Vervollständigung von Suchanfragen, die an QueryAutocompleteService gesendet werden soll.
input
Typ:string
Der Nutzer hat einen Eingabestring eingegeben.
bounds optional
Grenzen für die Voreingenommenheit der Vorhersage. Bei den Vorhersagen wird der angegebene bounds berücksichtigt, es werden aber nicht nur Vorhersagen für diesen bounds erstellt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
location optional
Typ:LatLng optional
Standort für die Vorhersagevoreingenommenheit. Die Vorhersagen sind dann auf die angegebenen location und radius ausgerichtet. Alternativ kann auch bounds verwendet werden.
offset optional
Typ:number optional
Die Zeichenposition im Eingabebegriff, an der der Dienst Text für Vorschläge verwendet (die Position des Cursors im Eingabefeld).
radius optional
Typ:number optional
Der Radius des Bereichs, der für die Vorhersageverzerrung verwendet wird. radius wird in Metern angegeben und muss immer mit einer location-Eigenschaft kombiniert werden. Alternativ kann auch bounds verwendet werden.

ComponentRestrictions-Benutzeroberfläche

google.maps.places.ComponentRestrictions Benutzeroberfläche

Hier werden die Komponenteneinschränkungen definiert, die mit dem automatischen Vervollständigungsservice verwendet werden können.
country optional
Typ:string|Array<string> optional
Beschränkt die Vorschläge auf das angegebene Land (ISO 3166-1 Alpha-2-Ländercode, keine Berücksichtigung der Groß- und Kleinschreibung). Beispiel: 'us', 'br' oder 'au'. Sie können einen einzelnen oder ein Array mit bis zu fünf Ländercode-Strings angeben.

Benutzeroberfläche AutocompletePrediction

google.maps.places.AutocompletePrediction Benutzeroberfläche

Stellt eine einzelne automatische Vervollständigung dar.
description
Typ:string
Dies ist die unformatierte Version der vom Places-Dienst vorgeschlagenen Suchanfrage.
matched_substrings
Eine Reihe von Teilstrings in der Beschreibung des Orts, die mit Elementen in der Nutzereingabe übereinstimmen und zum Hervorheben dieser Teilstrings geeignet sind. Jeder Teilstring wird durch einen Offset und eine Länge in Unicode-Zeichen identifiziert.
place_id
Typ:string
Eine Orts-ID, mit der Details zu diesem Ort über den Dienst „Place Details“ (siehe PlacesService.getDetails) abgerufen werden können.
structured_formatting
Strukturierte Informationen zur Beschreibung des Orts, unterteilt in einen Haupttext und einen sekundären Text, einschließlich einer Reihe übereinstimmender Teilstrings aus der AutoComplete-Eingabe, die durch einen Offset und eine Länge gekennzeichnet sind, die in Unicode-Zeichen ausgedrückt werden.
terms
Informationen zu den einzelnen Begriffen in der obigen Beschreibung, von am besten zu am wenigsten spezifisch. Beispiel: „Taco Bell“, „Willitis“ und „CA“.
types
Typ:Array<string>
Ein Array von Typen, zu denen die Vorhersage gehört, z. B. 'establishment' oder 'geocode'.
distance_meters optional
Typ:number optional
Die Entfernung in Metern des Ortes zum AutocompletionRequest.origin.

QueryAutocompletePrediction-Schnittstelle

google.maps.places.QueryAutocompletePrediction Benutzeroberfläche

Stellt eine einzelne automatische Vervollständigung für Suchanfragen dar.
description
Typ:string
Dies ist die unformatierte Version der vom Places-Dienst vorgeschlagenen Suchanfrage.
matched_substrings
Eine Reihe von Teilstrings in der Beschreibung des Orts, die mit Elementen in der Nutzereingabe übereinstimmen und zum Hervorheben dieser Teilstrings geeignet sind. Jeder Teilstring wird durch einen Offset und eine Länge in Unicode-Zeichen identifiziert.
terms
Informationen zu den einzelnen Begriffen in der obigen Beschreibung. Kategorische Begriffe stehen zuerst (z. B. „Restaurant“). Adressbegriffe werden von den spezifischeren zu den weniger spezifischen angezeigt. Beispiel: „San Francisco“ und „CA“.
place_id optional
Typ:string optional
Nur verfügbar, wenn die Vorhersage ein Ort ist. Eine Orts-ID, mit der Details zu diesem Ort über den Dienst „Place Details“ (siehe PlacesService.getDetails) abgerufen werden können.

PredictionTerm-Schnittstelle

google.maps.places.PredictionTerm Benutzeroberfläche

Stellt einen Vorhersagebegriff dar.
offset
Typ:number
Der Offset (in Unicode-Zeichen) des Beginns dieses Begriffs in der Beschreibung des Orts.
value
Typ:string
Der Wert dieses Begriffs, z. B. „Taco Bell“.

PredictionSubstring-Schnittstelle

google.maps.places.PredictionSubstring Benutzeroberfläche

Stellt einen Teilstring der Vorhersage dar.
length
Typ:number
Die Länge des Teilstrings.
offset
Typ:number
Der Offset zum Anfang des Teilstrings innerhalb des Beschreibungsstrings.

StructuredFormatting-Schnittstelle

google.maps.places.StructuredFormatting Benutzeroberfläche

Enthält strukturierte Informationen zur Beschreibung des Orts, unterteilt in einen Haupttext und einen sekundären Text, einschließlich einer Reihe von übereinstimmenden Teilstrings aus der Eingabe für die automatische Vervollständigung, die durch einen Offset und eine Länge gekennzeichnet sind, die in Unicode-Zeichen ausgedrückt werden.
main_text
Typ:string
Dies ist der Haupttextteil der unformatierten Beschreibung des vom Places-Dienst vorgeschlagenen Orts. Normalerweise der Name des Orts.
main_text_matched_substrings
Eine Reihe von Teilstrings im Haupttext, die mit Elementen in der Nutzereingabe übereinstimmen und zum Hervorheben dieser Teilstrings geeignet sind. Jeder Teilstring wird durch einen Offset und eine Länge in Unicode-Zeichen identifiziert.
secondary_text
Typ:string
Dies ist der sekundäre Textteil der unformatierten Beschreibung des vom Places-Dienst vorgeschlagenen Orts. Normalerweise der Standort des Orts.