Places Autocomplete Service

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

Klasse AutocompleteService

Klasse google.maps.places.AutocompleteService

Enthält Methoden zum Abrufen von Autocomplete-Vorhersagen.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

AutocompleteService
AutocompleteService()
Parameter: –
Erstellt eine neue Instanz von AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parameter:
Ruft Vervollständigungen für Orte automatisch ab, die auf der bereitgestellten Autocomplete-Anfrage basieren.
getQueryPredictions
getQueryPredictions(request, callback)
Parameter:
Rückgabewert: Keine
Ruft automatische Vervollständigungen für Suchanfragen basierend auf der angegebenen Anfrage zur automatischen Vervollständigung ab

Schnittstelle AutoCompletionRequest

Schnittstelle google.maps.places.AutocompletionRequest

Eine Anfrage zur automatischen Vervollständigung wird an AutocompleteService.getPlacePredictions gesendet.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

input
Typ: string
Der Nutzer hat einen Eingabestring eingegeben.
bounds optional
Grenzen für die Vorhersageverzerrung. Vorhersagen werden dem angegebenen bounds zugeordnet, sind jedoch nicht darauf beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
componentRestrictions optional
Die Komponenteneinschränkungen. Mit Komponenteneinschränkungen werden Vorhersagen auf solche innerhalb der übergeordneten Komponente beschränkt. 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 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
Position für die Quellengewichtung nach Vorhersage. Vorhersagen werden zugunsten der angegebenen location und radius gewichtet. Alternativ kann auch bounds verwendet werden.
offset optional
Typ:number optional
Die Zeichenposition im Eingabebegriff, an der der Dienst Text für Vervollständigungen 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 Gewichtung nach Vorhersage verwendet wird. Die radius wird in Metern angegeben und muss immer mit einer location-Property versehen werden. Alternativ kann auch bounds verwendet werden.
region optional
Typ: string optional
Ein Regionscode, der für die Formatierung der Ergebnisse und die Filterung der Ergebnisse verwendet wird. Die Vorschläge werden nicht auf dieses Land beschränkt. Für den Regionscode ist ein zweistelliger ccTLD-Wert („Top-Level-Domain“) zulässig. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. So lautet beispielsweise die ccTLD 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 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. Unterstützte Typen finden Sie im Entwicklerhandbuch. Wenn keine Typen angegeben sind, werden alle Typen zurückgegeben.

Schnittstelle AutocompleteResponse

Schnittstelle google.maps.places.AutocompleteResponse

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

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

predictions
Die Liste der AutocompletePredictions.

Schnittstelle QueryAutocompleteRequest

Schnittstelle google.maps.places.QueryAutocompletionRequest

Eine Anfrage für die automatische Vervollständigung, die an QueryAutocompleteService gesendet werden soll.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

input
Typ: string
Der Nutzer hat einen Eingabestring eingegeben.
bounds optional
Grenzen für die Vorhersageverzerrung. Vorhersagen werden dem angegebenen bounds zugeordnet, sind jedoch nicht darauf beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
location optional
Typ:LatLng optional
Position für die Quellengewichtung nach Vorhersage. Vorhersagen werden zugunsten der angegebenen location und radius gewichtet. Alternativ kann auch bounds verwendet werden.
offset optional
Typ:number optional
Die Zeichenposition im Eingabebegriff, an der der Dienst Text für Vervollständigungen verwendet (die Position des Cursors im Eingabefeld).
radius optional
Typ:number optional
Der Radius des Bereichs, der für die Gewichtung nach Vorhersage verwendet wird. Die radius wird in Metern angegeben und muss immer mit einer location-Property versehen werden. Alternativ kann auch bounds verwendet werden.

Klasse AutocompleteSessionToken

Klasse google.maps.places.AutocompleteSessionToken

Stellt ein Sitzungstoken für das Tracking einer Autocomplete-Sitzung dar. Es kann eine Reihe von AutocompleteService.getPlacePredictions-Aufrufen gefolgt von einem einzelnen PlacesService.getDetails-Aufruf sein.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

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

Schnittstelle ComponentRestrictions

Schnittstelle google.maps.places.ComponentRestrictions

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

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

country optional
Typ:string|Array<string> optional
Beschränkt die Vervollständigungen 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 oder ein Array mit bis zu fünf Ländercodestrings angeben.

Schnittstelle AutocompletePrediction

Schnittstelle google.maps.places.AutocompletePrediction

Stellt eine einzelne automatische Vervollständigung dar.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

description
Typ:string
Dies ist die unformatierte Version der Abfrage, die vom Places-Dienst vorgeschlagen wird.
matched_substrings
Eine Reihe von Teilstrings in der Beschreibung des Orts, die mit Elementen in der Eingabe des Nutzers übereinstimmen. Sie eignen sich zum Hervorheben dieser Teilstrings. Jeder Teilstring wird durch einen Offset und eine Länge gekennzeichnet, ausgedrückt in Unicode-Zeichen.
place_id
Typ:string
Eine Orts-ID, mit der über den Ortsdatendienst Details zu diesem Ort abgerufen werden können (siehe PlacesService.getDetails).
structured_formatting
Strukturierte Informationen zur Beschreibung des Orts, unterteilt in einen Haupt- und einen Sekundärtext, einschließlich eines Arrays übereinstimmender Teilstrings aus der Eingabe der automatischen Vervollständigung, angegeben durch Offset und Länge in Unicode-Zeichen.
terms
Informationen zu einzelnen Begriffen in der Beschreibung oben, von der höchsten zur am wenigsten spezifischen Kategorie. 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

Schnittstelle google.maps.places.QueryAutocompletePrediction

Stellt eine einzelne Vervollständigung von Suchanfragen dar.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

description
Typ: string
Dies ist die unformatierte Version der Abfrage, die vom Places-Dienst vorgeschlagen wird.
matched_substrings
Eine Reihe von Teilstrings in der Beschreibung des Orts, die mit Elementen in der Eingabe des Nutzers übereinstimmen. Sie eignen sich zum Hervorheben dieser Teilstrings. Jeder Teilstring wird durch einen Offset und eine Länge gekennzeichnet, 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 Adressbegriffe werden vom äußersten bis zum am wenigsten spezifischen Begriff 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 über den Ortsdatendienst Details zu diesem Ort abgerufen werden können (siehe PlacesService.getDetails).

Schnittstelle PredictionTerm

Schnittstelle google.maps.places.PredictionTerm

Stellt einen Vorhersagebegriff dar.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

offset
Typ:number
Der Versatz in Unicode-Zeichen für den Anfang dieses Begriffs in der Ortsbeschreibung.
value
Typ:string
Der Wert dieses Begriffs, z. B. „Taco Bell“.

Schnittstelle PredictionSubstring

Schnittstelle google.maps.places.PredictionSubstring

Stellt einen Teilstring für die Vorhersage dar.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

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

Oberfläche StructuredFormatierung

Schnittstelle google.maps.places.StructuredFormatting

Enthält strukturierte Informationen zur Beschreibung des Orts, unterteilt in einen Haupt- und einen Sekundärtext, einschließlich eines Arrays übereinstimmender Teilstrings aus der automatischen Vervollständigung, angegeben durch Offset und Länge, angegeben in Unicode-Zeichen.

Erfordert den URL-Parameter &libraries=places. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

main_text
Typ: string
Dies ist der Haupttext der unformatierten Beschreibung des Ortes, der vom Places-Dienst vorgeschlagen wurde. In der Regel der Name des Orts.
main_text_matched_substrings
Eine Reihe von Teilstrings im Haupttext, die Elementen in der Eingabe des Nutzers entsprechen, um diese Teilstrings hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge gekennzeichnet, 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.