Places Autocomplete Service

AutocompleteService-Klasse

google.maps.places.AutocompleteService Klasse

Enthält Methoden zum Abrufen von automatischen Vervollständigungen.

Zugriff über const {AutocompleteService} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

AutocompleteService
AutocompleteService()
Parameter:Keine
Erstellt eine neue Instanz von AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parameter:
Rückgabewert:  Promise<AutocompleteResponse>
Ruft automatisch Place Autocomplete-Vorschläge auf Basis der bereitgestellten Autocomplete-Anfrage ab.
getQueryPredictions
getQueryPredictions(request, callback)
Parameter:
Rückgabewert:Keine
Ruft automatisch vervollständigte Suchanfragen auf Basis der bereitgestellten Anfrage zur automatischen Vervollständigung von Abfragen ab.

AutocompletionRequest-Schnittstelle

google.maps.places.AutocompletionRequest-Schnittstelle

Eine Anfrage für eine automatische Vervollständigung wird an AutocompleteService.getPlacePredictions gesendet.

input
Typ:string
Der vom Nutzer eingegebene String.
bounds optional
Grenzen für die Vorhersagegewichtung. Vorhersagen sind nach dem gegebenen bounds gewichtet, sind aber nicht darauf beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
componentRestrictions optional
Die Komponenteneinschränkungen. Komponenteneinschränkungen werden verwendet, um Vorhersagen auf die Elemente innerhalb der übergeordneten Komponente zu beschränken. z. B. 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 können ein höheres Ranking erhalten, Vorschläge sind jedoch nicht auf diese Sprache beschränkt. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng optional
Standort für Vorhersagegewichtung. Vorhersagen sind nach den angegebenen location und radius gewichtet. Alternativ kann bounds verwendet werden.
locationBias optional
Typ:LocationBias optional
Eine weiche Grenze oder ein Hinweis für die Suche nach Orten.
locationRestriction optional
Typ:LocationRestriction optional
Begrenzungen, um 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, an dem AutocompletePrediction.distance_meters berechnet wird.
radius optional
Typ:number optional
Der Radius des Bereichs, der für die Vorhersagegewichtung verwendet wird. radius wird in Metern angegeben und muss immer mit einer location-Eigenschaft verknüpft sein. Alternativ kann bounds verwendet werden.
region optional
Typ:string optional
Ein Regionscode, der für die Ergebnisformatierung und für die Ergebnisfilterung verwendet wird. Die Vorschläge sind nicht auf dieses Land beschränkt. Für den Regionscode kann ein zweistelliger ccTLD-Wert („Top-Level-Domain“) verwendet werden. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“).
sessionToken optional
Eindeutige Referenz, die verwendet wird, um einzelne Anfragen in Sitzungen zu bündeln.
types optional
Typ:Array<string> optional
Die Vorhersagetypen, die zurückgegeben werden sollen. Die unterstützten Typen finden Sie im Entwicklerhandbuch. Wenn keine Typen angegeben sind, werden alle Typen zurückgegeben.

AutocompleteResponse-Schnittstelle

google.maps.places.AutocompleteResponse-Schnittstelle

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

predictions
Die Liste der AutocompletePredictions.

QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest-Schnittstelle

Eine „Query Autocomplete“-Anfrage, die an QueryAutocompleteService gesendet wird

input
Typ:string
Der vom Nutzer eingegebene String.
bounds optional
Grenzen für die Vorhersagegewichtung. Vorhersagen sind nach dem gegebenen bounds gewichtet, sind aber nicht darauf beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
location optional
Typ:LatLng optional
Standort für Vorhersagegewichtung. Vorhersagen sind nach den angegebenen location und radius gewichtet. Alternativ kann 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 Vorhersagegewichtung verwendet wird. radius wird in Metern angegeben und muss immer mit einer location-Eigenschaft verknüpft sein. Alternativ kann bounds verwendet werden.

AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken Klasse

Stellt ein Sitzungstoken zum Nachverfolgen einer Sitzung mit automatischer Vervollständigung dar, bei der es sich um eine Reihe von AutocompleteService.getPlacePredictions-Aufrufen gefolgt von einem einzelnen PlacesService.getDetails-Aufruf handeln kann.

Zugriff über const {AutocompleteSessionToken} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

AutocompleteSessionToken
AutocompleteSessionToken()
Parameter:Keine
Creates a new instance of AutocompleteSessionToken.

ComponentRestrictions-Schnittstelle

google.maps.places.ComponentRestrictions-Schnittstelle

Definiert die Komponenteneinschränkungen, die mit dem Dienst für die automatische Vervollständigung verwendet werden können.

country optional
Typ:string|Array<string> optional
Beschränkt die Vorhersagen auf das angegebene Land (ISO 3166-1 Alpha-2-Ländercode, Groß-/Kleinschreibung wird nicht berücksichtigt). Beispiel: 'us', 'br' oder 'au'. Sie können einen einzelnen String oder ein Array mit bis zu fünf Ländercodestrings angeben.

AutocompletePrediction-Oberfläche

google.maps.places.AutocompletePrediction-Schnittstelle

Stellt einen einzelnen automatisch vervollständigten Vorschlag dar.

description
Typ:string
Das ist die unformatierte Version der vom Places-Dienst vorgeschlagenen Abfrage.
matched_substrings
Ein Satz von Teilzeichenfolgen in der Ortsbeschreibung, die mit Elementen in der Eingabe des Nutzers übereinstimmen. Geeignet, um diese Teilzeichenfolgen hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, die in Unicode-Zeichen ausgedrückt werden.
place_id
Typ:string
Eine Orts-ID, mit der mit dem „Place Details“-Dienst Details zu diesem Ort abgerufen werden können (siehe PlacesService.getDetails).
structured_formatting
Strukturierte Informationen zur Beschreibung des Orts, unterteilt in einen Haupttext und einen Sekundärtext, einschließlich eines Arrays übereinstimmender Teilstrings aus der Eingabe für die automatische Vervollständigung, die durch einen Offset und eine Länge definiert werden, ausgedrückt in Unicode-Zeichen.
terms
Informationen zu einzelnen Begriffen in der Beschreibung, von der höchsten bis zur am wenigsten spezifischen. 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 von AutocompletionRequest.origin.

QueryAutocompletePrediction-Schnittstelle

google.maps.places.QueryAutocompletePrediction-Schnittstelle

Stellt eine einzelne Query Autocomplete-Vervollständigung dar.

description
Typ:string
Das ist die unformatierte Version der vom Places-Dienst vorgeschlagenen Abfrage.
matched_substrings
Ein Satz von Teilzeichenfolgen in der Ortsbeschreibung, die mit Elementen in der Eingabe des Nutzers übereinstimmen. Geeignet, um diese Teilzeichenfolgen hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, die in Unicode-Zeichen ausgedrückt werden.
terms
Informationen zu einzelnen Begriffen in der Beschreibung oben. Kategorische Begriffe stehen an erster Stelle (z. B. „Restaurant“). Adressbegriffe werden vom stärksten zum am wenigsten spezifischen Begriff angezeigt. Beispiel: „Hamburg“ und „München“.
place_id optional
Typ:string optional
Nur verfügbar, wenn die Vorhersage ein Ort ist. Eine Orts-ID, mit der mit dem „Place Details“-Dienst Details zu diesem Ort abgerufen werden können (siehe PlacesService.getDetails).

PredictionTerm-Schnittstelle

google.maps.places.PredictionTerm-Schnittstelle

Stellt einen Vorhersagebegriff dar.

offset
Typ:number
Der Abstand (in Unicode-Zeichen) des Anfangs dieses Begriffs in der Beschreibung des Orts.
value
Typ:string
Der Wert dieses Begriffs, z. B. „Taco Bell“.

PredictionSubstring-Oberfläche

google.maps.places.PredictionSubstring-Schnittstelle

Stellt einen Vorhersage-Teilstring dar.

length
Typ:number
Die Länge der Teilzeichenfolge.
offset
Typ:number
Der Offset zum Anfang des Teilstrings im Beschreibungsstring.

StructuredFormatting

google.maps.places.StructuredFormatting-Schnittstelle

Enthält strukturierte Informationen über die Beschreibung des Orts, unterteilt in einen Haupttext und einen Sekundärtext, einschließlich eines Arrays übereinstimmender Teilstrings aus der Eingabe für die automatische Vervollständigung, die durch einen Offset und eine Länge in Unicode-Zeichen ausgedrückt werden.

main_text
Typ:string
Dies ist der Haupttextteil der unformatierten Beschreibung des Orts, die vom Places-Dienst vorgeschlagen wurde. Normalerweise der Name des Orts.
main_text_matched_substrings
Ein Satz von Teilzeichenfolgen im Haupttext, die mit Elementen in der Eingabe des Nutzers übereinstimmen. Geeignet, um diese Teilzeichenfolgen hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, die in Unicode-Zeichen ausgedrückt werden.
secondary_text
Typ:string
Dies ist der sekundäre Textteil der unformatierten Beschreibung des Orts, die vom Places-Dienst vorgeschlagen wurde. Dies ist normalerweise der Standort des Orts.