Places Autocomplete Service (deprecated)

AutocompleteService-Klasse

Klasse google.maps.places.AutocompleteService
Bibliothek "places"

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

const {AutocompleteService} = await google.maps.importLibrary("places");
AutocompleteService
AutocompleteService()
Parameter: Keine
Erstellt eine neue Instanz von AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parameter:
Rückgabewert: Promise<AutocompleteResponse>
Ruft automatische Vervollständigungen für Orte basierend auf der angegebenen Anfrage für die automatische Vervollständigung ab.
getQueryPredictions
getQueryPredictions(request, callback)
Parameter:
Rückgabewert: Keiner
Ruft automatische Vervollständigungen für Abfragen basierend auf der angegebenen Anfrage für die automatische Vervollständigung ab.

AutocompletionRequest-Schnittstelle

Schnittstelle google.maps.places.AutocompletionRequest

Eine Anfrage zur automatischen Vervollständigung, die an AutocompleteService.getPlacePredictions gesendet werden soll.
input
Typ: string
Der vom Nutzer eingegebene Eingabestring.
bounds
optional
Grenzwerte für die Vorhersagegewichtung. Bei den Vervollständigungen werden Orte innerhalb des angegebenen bounds bevorzugt, sind aber nicht auf sie beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
componentRestrictions
optional
Typ: ComponentRestrictions optional
Die Einschränkungen der Komponente. Mit Komponentenbeschränkungen werden Vervollständigungen auf die übergeordnete Komponente beschränkt. Beispiel: das Land.
language
optional
Typ: string optional
Eine Sprachkennung für die Sprache, in der die Ergebnisse nach Möglichkeit zurückgegeben werden sollen. Ergebnisse in der ausgewählten Sprache werden möglicherweise höher eingestuft, 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 die Vorhersagegewichtung. Die Vorhersagen werden auf die angegebenen location und radius ausgerichtet. Alternativ kann bounds verwendet werden.
locationBias
optional
Typ: LocationBias optional
Eine weiche Grenze oder ein Hinweis, der bei der Suche nach Orten verwendet werden soll.
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 Vervollständigungen 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 Vorhersagegewichtung verwendet wird. Der radius wird in Metern angegeben und muss immer von einer location-Property begleitet werden. Alternativ kann bounds verwendet werden.
region
optional
Typ: string optional
Ein Regionscode, der für die Formatierung und Filterung der Ergebnisse verwendet wird. Die Vorschläge werden nicht auf dieses Land beschränkt. Für den Regionscode ist ein zweistelliger Wert für die ccTLD („Top-Level-Domain“) zulässig. 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 gesehen für das Vereinigte Königreich Großbritannien und Nordirland).
sessionToken
optional
Eindeutige Referenz, mit der einzelne Anfragen zu Sitzungen zusammengefasst werden.
types
optional
Typ: Array<string> optional
Die Typen von Vervollständigungen, die zurückgegeben werden sollen. Informationen zu unterstützten 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 von AutocompleteService.getPlacePredictions zurückgegeben wird und eine Liste von AutocompletePredictions enthält.
predictions
Die Liste der AutocompletePredictions.

QueryAutocompletionRequest-Schnittstelle

Schnittstelle google.maps.places.QueryAutocompletionRequest

Eine QueryAutocompletion-Anfrage, die an QueryAutocompleteService gesendet werden soll.
input
Typ: string
Der vom Nutzer eingegebene Eingabestring.
bounds
optional
Grenzwerte für die Vorhersagegewichtung. Bei den Vervollständigungen werden Orte innerhalb des angegebenen bounds bevorzugt, sind aber nicht auf sie beschränkt. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
location
optional
Typ: LatLng optional
Standort für die Vorhersagegewichtung. Die Vorhersagen werden auf die angegebenen location und radius ausgerichtet. Alternativ kann 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 Vorhersagegewichtung verwendet wird. Der radius wird in Metern angegeben und muss immer von einer location-Property begleitet werden. Alternativ kann bounds verwendet werden.

ComponentRestrictions-Schnittstelle

Schnittstelle google.maps.places.ComponentRestrictions

Definiert die Komponenteneinschränkungen, die mit dem Autocomplete-Dienst verwendet werden können.
country
optional
Typ: string|Array<string> optional
Beschränkt Vorschläge 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 Ländercode oder ein Array mit bis zu fünf Ländercodes angeben.

AutocompletePrediction-Schnittstelle

Schnittstelle google.maps.places.AutocompletePrediction

Stellt eine einzelne automatische Vervollständigung dar.
description
Typ: string
Dies ist die unformatierte Version der Suchanfrage, die vom Places-Dienst vorgeschlagen wird.
matched_substrings
Eine Reihe von Teilstrings in der Beschreibung des Ortes, die mit Elementen in der Nutzereingabe übereinstimmen. Diese Teilstrings können hervorgehoben werden. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, die in Unicode-Zeichen angegeben werden.
place_id
Typ: string
Eine Orts-ID, mit der Details zu diesem Ort über den Place Details-Dienst abgerufen werden können (siehe PlacesService.getDetails).
structured_formatting
Strukturierte Informationen zur Beschreibung des Ortes, aufgeteilt in einen Haupttext und einen Sekundärtext, einschließlich eines Arrays von übereinstimmenden Teilstrings aus der Eingabe für die automatische Vervollständigung, die durch einen Offset und eine Länge in Unicode-Zeichen identifiziert werden.
terms
Informationen zu einzelnen Begriffen in der obigen Beschreibung, von den spezifischsten bis zu den am wenigsten spezifischen. Beispiel: „Taco Bell“, „Willitis“ und „CA“.
types
Typ: Array<string>
Ein Array von Typen, zu denen die Vervollständigung gehört, z. B. 'establishment' oder 'geocode'.
distance_meters
optional
Typ: number optional
Die Entfernung des Ortes zum AutocompletionRequest.origin in Metern.

QueryAutocompletePrediction-Schnittstelle

Schnittstelle google.maps.places.QueryAutocompletePrediction

Stellt eine einzelne automatische Vervollständigung für eine Abfrage dar.
description
Typ: string
Dies ist die unformatierte Version der Suchanfrage, die vom Places-Dienst vorgeschlagen wird.
matched_substrings
Eine Reihe von Teilstrings in der Beschreibung des Ortes, die mit Elementen in der Nutzereingabe übereinstimmen. Diese Teilstrings können hervorgehoben werden. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, die in Unicode-Zeichen angegeben werden.
terms
Informationen zu einzelnen Begriffen in der obigen Beschreibung. Kategorische Begriffe stehen an erster Stelle (z. B. „Restaurant“). Die Adressbegriffe werden von der spezifischsten bis zur am wenigsten spezifischen Angabe angezeigt. Beispiel: „San Francisco“ und „CA“.
place_id
optional
Typ: string optional
Nur verfügbar, wenn die Vervollständigung ein Ort ist. Eine Orts-ID, mit der Details zu diesem Ort über den Place Details-Dienst abgerufen werden können (siehe PlacesService.getDetails).

PredictionTerm-Schnittstelle

Schnittstelle google.maps.places.PredictionTerm

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

PredictionSubstring-Schnittstelle

Schnittstelle google.maps.places.PredictionSubstring

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

StructuredFormatting-Schnittstelle

Schnittstelle google.maps.places.StructuredFormatting

Enthält strukturierte Informationen zur Beschreibung des Ortes, aufgeteilt in einen Haupttext und einen Sekundärtext, einschließlich eines Arrays von übereinstimmenden Teilstrings aus der Eingabe für die automatische Vervollständigung, die durch einen Offset und eine Länge in Unicode-Zeichen identifiziert werden.
main_text
Typ: string
Dies ist der Haupttextteil der unformatierten Beschreibung des Ortes, der vom Places-Dienst vorgeschlagen wird. Normalerweise der Name des Orts.
main_text_matched_substrings
Eine Reihe von Teilstrings im Haupttext, die mit Elementen in der Nutzereingabe übereinstimmen und sich zum Hervorheben dieser Teilstrings eignen. Jeder Teilstring wird durch einen Offset und eine Länge identifiziert, die in Unicode-Zeichen angegeben werden.
secondary_text
Typ: string
Dies ist der sekundäre Textteil der unformatierten Beschreibung des Orts, der vom Places-Dienst vorgeschlagen wird. Normalerweise der Standort des Ortes.