Places Autocomplete Service

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Klasse AutocompleteService

google.maps.places.AutocompleteService-Klasse

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

Mit dem URL-Parameter &libraries=places laden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Bei Verwendung von v=beta kann über const {AutocompleteService} = await google.map.importLibrary("places") aufgerufen werden. 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 Place Autocomplete-Vervollständigungen basierend auf der angegebenen Autocomplete-Anfrage ab.
getQueryPredictions
getQueryPredictions(request, callback)
Parameter:
Rückgabewert:Keine
Ruft Vorschläge für die automatische Vervollständigung von Abfragen basierend auf der angegebenen Anfrage zur automatischen Vervollständigung von Abfragen ab.

Schnittstelle AutocompletionRequest

google.maps.places.AutocompletionRequest-Schnittstelle

Eine Anfrage zur automatischen Vervollständigung, die an AutocompleteService.getPlacePredictions gesendet wird.
input
Typ: string
Der Nutzer hat einen Eingabestring eingegeben.
bounds optional
Grenzen für die Quellengewichtung nach Vorhersage. Vorhersagen werden im Hinblick auf das angegebene bounds bevorzugt, sind aber nicht darauf beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
componentRestrictions optional
Typ: ComponentRestrictions optional
Die Komponenteneinschränkungen. Komponenteneinschränkungen werden verwendet, um Vorhersagen auf Vorhersagen innerhalb der übergeordneten Komponente zu beschränken. Beispiel: das Land.
language optional
Typ: string optional
Eine Sprachkennzeichnung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, falls möglich. Ergebnisse in der ausgewählten Sprache erhalten möglicherweise ein höheres Ranking, Vorschläge sind jedoch nicht auf diese Sprache beschränkt. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ: LatLng optional
Ort für die Quellengewichtung nach Vorhersage. Vorhersagen werden nach den angegebenen location- und radius-Werten gewichtet. Alternativ kann bounds verwendet werden.
offset optional
Typ:number optional
Die Zeichenposition im Eingabebegriff, an der der Dienst Text für Vorhersagen verwendet (die Position des Cursors im Eingabefeld).
origin optional
Typ:LatLng|LatLngLiteral optional
Der Standort, aus dem AutocompletePrediction.distance_meters berechnet wird.
radius optional
Typ:number optional
Der Radius des Bereichs, der für die Quellengewichtung nach Vorhersage verwendet wird. Die radius wird in Metern angegeben und muss immer von einer location-Eigenschaft begleitet werden. Alternativ kann bounds verwendet werden.
region optional
Typ:string optional
Ein Regionscode, der für die Ergebnisformatierung und die Ergebnisfilterung verwendet wird. Die Vorschläge sind nicht auf dieses Land beschränkt. Für den Regionscode ist ein zweistelliger ccTLD-Wert zulässig. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. So lautet beispielsweise der ccTLD-Code für das Vereinigte Königreich „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ ist (technisch für die Rechtspersönlichkeit „Vereinigtes Königreich im Vereinigten Königreich und Nordirland“).
sessionToken optional
Eindeutige Referenz, mit der einzelne Anfragen in Sitzungen gruppiert werden.
types optional
Typ: Array<string> optional
Die Arten von Vorhersagen, die zurückgegeben werden sollen. Informationen zu 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 durch den Aufruf von AutocompleteService.getPlacePredictions zurückgegebene Autocomplete-Antwort mit einer Liste von AutocompletePredictions.
predictions
Die Liste der AutocompletePredictions.

Schnittstelle QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest-Schnittstelle

Eine QueryAutocompletion-Anfrage, die an QueryAutocompleteService gesendet wird
input
Typ:string
Der Nutzer hat einen Eingabestring eingegeben.
bounds optional
Grenzen für die Quellengewichtung nach Vorhersage. Vorhersagen werden im Hinblick auf das angegebene bounds bevorzugt, sind aber nicht darauf beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
location optional
Typ:LatLng optional
Ort für die Quellengewichtung nach Vorhersage. Vorhersagen werden nach den angegebenen location- und radius-Werten gewichtet. Alternativ kann bounds verwendet werden.
offset optional
Typ: number optional
Die Zeichenposition im Eingabebegriff, an der der Dienst Text für Vorhersagen verwendet (die Position des Cursors im Eingabefeld).
radius optional
Typ: number optional
Der Radius des Bereichs, der für die Quellengewichtung nach Vorhersage verwendet wird. Die radius wird in Metern angegeben und muss immer von einer location-Eigenschaft begleitet werden. Alternativ kann bounds verwendet werden.

Klasse AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken-Klasse

Stellt ein Sitzungstoken dar, das zum Erfassen einer Sitzung mit automatischer Vervollständigung verwendet wird. Das kann eine Reihe von AutocompleteService.getPlacePredictions-Aufrufen gefolgt von einem einzelnen PlacesService.getDetails-Aufruf sein.

Mit dem URL-Parameter &libraries=places laden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Bei Verwendung von v=beta kann über const {AutocompleteSessionToken} = await google.map.importLibrary("places") aufgerufen werden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
AutocompleteSessionToken
AutocompleteSessionToken()
Parameter:Keine
Creates a new instance of AutocompleteSessionToken.

Schnittstelle ComponentRestrictions

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 Vorhersagen auf das angegebene Land (ISO 3166-1 Alpha-2-Ländercode, Groß-/Kleinschreibung nicht berücksichtigend). Beispiel: 'us', 'br' oder 'au'. Sie können einen einzelnen String oder ein Array mit bis zu fünf Ländercodestrings angeben.

AutocompletePrediction

google.maps.places.AutocompletePrediction-Schnittstelle

Stellt eine einzelne automatische Vervollständigung dar.
description
Typ: string
Dies ist die unformatierte Version der Suchanfrage, die vom Places-Dienst vorgeschlagen wurde.
matched_substrings
Ein Satz von Teilstrings in der Beschreibung des Ortes, die mit Elementen in der Eingabe des Nutzers übereinstimmen, um diese Teilstrings hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, ausgedrückt in Unicode-Zeichen.
place_id
Typ:string
Eine Orts-ID, mit der Details zu diesem Ort mithilfe des Ortsdetaildienstes abgerufen werden können (siehe PlacesService.getDetails)
structured_formatting
Strukturierte Informationen zur Beschreibung des Ortes, unterteilt in einen Haupt- und einen sekundären Text, einschließlich einer Reihe übereinstimmender Teilstrings aus der Eingabe bei der automatischen Vervollständigung, gekennzeichnet durch Offset und Länge, ausgedrückt in Unicode-Zeichen.
terms
Informationen zu einzelnen Begriffen in der Beschreibung oben, von der höchsten bis zur kleinsten. 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 vom Ort zum AutocompletionRequest.origin.

Schnittstelle QueryAutocompletePrediction

google.maps.places.QueryAutocompletePrediction-Schnittstelle

Stellt eine einzelne Query Autocomplete-Vorhersage dar.
description
Typ: string
Dies ist die unformatierte Version der Suchanfrage, die vom Places-Dienst vorgeschlagen wurde.
matched_substrings
Ein Satz von Teilstrings in der Beschreibung des Ortes, die mit Elementen in der Eingabe des Nutzers übereinstimmen, um diese Teilstrings hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, ausgedrückt in Unicode-Zeichen.
terms
Informationen zu den einzelnen Begriffen in der Beschreibung oben. Kategoriale Begriffe stehen an erster Stelle (z. B. „Restaurant“). Die Adressenbegriffe werden vom größten zum am wenigsten spezifischen Wert 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 mithilfe des Ortsdetaildienstes abgerufen werden können (siehe PlacesService.getDetails)

PredictionTerm-Schnittstelle

google.maps.places.PredictionTerm-Schnittstelle

Ein Vorhersagebegriff.
offset
Typ: number
Der Versatz in Unicode-Zeichen vom Anfang dieses Begriffs in der Beschreibung des Ortes.
value
Typ: string
Der Wert dieses Begriffs, z. B. „Taco Bell“.

Schnittstelle PredictionSubstring

google.maps.places.PredictionSubstring-Schnittstelle

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

StructuredFormatierung

google.maps.places.StructuredFormatting-Schnittstelle

Enthält strukturierte Informationen zur Beschreibung des Orts, die in einen Haupttext und einen sekundären Text unterteilt sind, einschließlich eines Arrays von übereinstimmenden Teilstrings aus der Eingabe der automatischen Vervollständigung, gekennzeichnet durch Offset und Länge, ausgedrückt in Unicode-Zeichen
main_text
Typ: string
Dies ist der Haupttext der unformatierten Beschreibung des vom Places-Dienst vorgeschlagenen Ortes. Normalerweise der Name des Orts.
main_text_matched_substrings
Eine Reihe von Teilstrings im Haupttext, die Elementen in der Eingabe des Nutzers entsprechen, geeignet, um diese Teilstrings hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, ausgedrückt in Unicode-Zeichen.
secondary_text
Typ:string
Dies ist der sekundäre Textteil der unformatierten Beschreibung des vom Places-Dienst vorgeschlagenen Ortes. Normalerweise der Standort des Orts.