Places Autocomplete Service

Klasse AutocompleteService

google.maps.places.AutocompleteService-Klasse

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

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

Konstruktor
AutocompleteService	AutocompleteService() Parameter:Keine Erstellt eine neue Instanz des AutocompleteService.

Methoden
getPlacePredictions	getPlacePredictions(request[, callback]) Parameter: request:  AutocompletionRequest Die Anfrage für die automatische Vervollständigung. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional Ein Callback, der ein Array von AutocompletePrediction-Objekten und einen PlacesServiceStatus-Wert als Argument akzeptiert. Rückgabewert:  Promise<AutocompleteResponse> Ruft Place Autocomplete-Vervollständigungen basierend auf der bereitgestellten Autocomplete-Anfrage ab
getQueryPredictions	getQueryPredictions(request, callback) Parameter: request:  QueryAutocompletionRequest Die Anfrage zur automatischen Vervollständigung. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Ein Callback, der ein Array von QueryAutocompletePrediction-Objekten und einen PlacesServiceStatus-Wert als Argument akzeptiert. Rückgabewert: Keine Ruft automatische Vorschläge für die automatische Vervollständigung auf Basis der bereitgestellten Anfrage der automatischen Vervollständigung ab

Schnittstelle AutoAutocompleteRequest

Schnittstelle google.maps.places.AutocompletionRequest

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

Attribute
input	Typ:string Der Nutzer hat einen Eingabestring eingegeben.
bounds optional	Verworfen:bounds wurde am Mai 2023 eingestellt. Verwenden Sie stattdessen AutocompletionRequest.locationBias und AutocompletionRequest.locationRestriction. Typ:LatLngBounds|LatLngBoundsLiteral optional Grenzwerte für die Vorhersagegewichtung Die Vorhersagen werden nach dem bounds-Objekt gewichtet, sind jedoch nicht auf sie beschränkt. location und radius werden ignoriert, wenn bounds festgelegt ist.
componentRestrictions optional	Typ:ComponentRestrictions optional Die Komponenteneinschränkungen Mit den Komponenteneinschränkungen werden nur die Vorhersagen in der übergeordneten Komponente berücksichtigt. also z. B. das Land.
language optional	Typ:string optional Eine Sprach-ID 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	Verworfen:location wurde am Mai 2023 eingestellt. Verwenden Sie stattdessen AutocompletionRequest.locationBias und AutocompletionRequest.locationRestriction. Typ:LatLng optional Ort für die Vorhersagegewichtung. Die Gewichtungen werden nach den location und den radius gewichtet. Alternativ kann bounds verwendet werden.
locationBias optional	Typ:LocationBias optional Eine weiche Grenze oder ein Hinweis bei der Suche nach Orten
locationRestriction optional	Typ:LocationRestriction optional Grenzen zur Einschränkung von Suchergebnissen
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 Ort, an dem AutocompletePrediction.distance_meters berechnet wird.
radius optional	Verworfen:radius wurde am Mai 2023 eingestellt. Verwenden Sie stattdessen AutocompletionRequest.locationBias und AutocompletionRequest.locationRestriction. Typ:number optional Der Radius des Bereichs, der für die Gewichtung nach Vorhersage verwendet wird. Der radius wird in Metern angegeben und muss immer mit einer location-Property kombiniert werden. Alternativ kann bounds verwendet werden.
region optional	Typ:string optional Ein Regionscode, der für die Ergebnisformatierung und für das Filtern von Ergebnissen verwendet wird. Die Vorschläge werden nicht auf dieses Land eingeschränkt. Im 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 die ccTLD des Vereinigten Königreichs „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	Typ:AutocompleteSessionToken optional Eindeutige Referenz, mit der einzelne Anfragen in Sitzungen zusammengefasst werden.
types optional	Typ:Array<string> optional Die Typen der 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.

Schnittstelle AutocompleteResponse

Schnittstelle google.maps.places.AutocompleteResponse

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

Attribute
predictions	Typ:Array<AutocompletePrediction> Die Liste der AutocompletePrediction.

Schnittstelle QueryAutocompleteRequest

Schnittstelle google.maps.places.QueryAutocompletionRequest

Eine Anfrage für die automatische Autovervollständigung, die an die QueryAutocompleteService gesendet wird.

Attribute
input	Typ:string Der Nutzer hat einen Eingabestring eingegeben.
bounds optional	Typ:LatLngBounds|LatLngBoundsLiteral optional Grenzwerte für die Vorhersagegewichtung Die Vorhersagen werden nach dem bounds-Objekt gewichtet, sind jedoch nicht auf sie beschränkt. location und radius werden ignoriert, wenn bounds festgelegt ist.
location optional	Typ:LatLng optional Ort für die Vorhersagegewichtung. Die Gewichtungen werden nach den location und den radius 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 Gewichtung nach Vorhersage verwendet wird. Der radius wird in Metern angegeben und muss immer mit einer location-Property kombiniert werden. Alternativ kann bounds verwendet werden.

Klasse AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken-Klasse

Stellt ein Sitzungstoken für das Tracking einer Sitzung mit automatischer Vervollständigung dar. Es kann aus mehreren AutocompleteService.getPlacePredictions-Aufrufen gefolgt von einem einzelnen PlacesService.getDetails-Aufruf bestehen.

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

Konstruktor
AutocompleteSessionToken	AutocompleteSessionToken() Parameter:Keine 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.

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

Schnittstelle für AutocompletePrediction

Schnittstelle google.maps.places.AutocompletePrediction

Eine einzelne automatische Vervollständigung.

Attribute
description	Typ:string Dies ist die unformatierte Version der Abfrage, die vom Places-Dienst vorgeschlagen wurde.
matched_substrings	Typ:Array<PredictionSubstring> Eine Reihe von Teilstrings in der Beschreibung des Ortes, die mit Elementen in der Nutzereingabe übereinstimmen. Sie werden verwendet, um diese Teilstrings hervorzuheben. 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 Details zu diesem Ort mithilfe des Ortsdetaildienstes abgerufen werden können (siehe PlacesService.getDetails).
structured_formatting	Typ:StructuredFormatting Strukturierte Informationen zur Beschreibung des Ortes, unterteilt in einen Haupt- und einen sekundären Text, einschließlich eines Arrays mit übereinstimmenden Teilstrings aus der automatischen Vervollständigung, gekennzeichnet durch einen Offset und eine Länge in Unicode-Zeichen
terms	Typ:Array<PredictionTerm> Informationen zu einzelnen Begriffen oben in der Beschreibung, von der höchsten bis zur am wenigsten spezifischen Begriffe. Beispiele: „Taco Bell“, „Willitis“ und „CA“.
types	Typ:Array<string> Ein Array aus Typen, zu denen die Vorhersage gehört, z. B. 'establishment' oder 'geocode'.
distance_meters optional	Typ:number optional Die Entfernung in Metern des Ortes zu AutocompletionRequest.origin.

Schnittstelle QueryAutocompletePrediction

Schnittstelle google.maps.places.QueryAutocompletePrediction

Eine einzelne Vervollständigung von Suchanfragen.

Attribute
description	Typ:string Dies ist die unformatierte Version der Abfrage, die vom Places-Dienst vorgeschlagen wurde.
matched_substrings	Typ:Array<PredictionSubstring> Eine Reihe von Teilstrings in der Beschreibung des Ortes, die mit Elementen in der Nutzereingabe übereinstimmen. Sie werden verwendet, um diese Teilstrings hervorzuheben. Jeder Teilstring wird durch einen Offset und eine Länge gekennzeichnet, ausgedrückt in Unicode-Zeichen.
terms	Typ:Array<PredictionTerm> Informationen zu einzelnen Begriffen oben. Kategoriale Begriffe stehen an erster Stelle (z. B. „Restaurant“). Die Adresse wird von der am wenigsten spezifischen bis zur am wenigsten spezifischen Bezeichnung verwendet. 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).

Schnittstelle PredictionTerm

Schnittstelle google.maps.places.PredictionTerm

Ein Vorhersagebegriff.

Attribute
offset	Typ:number Der Versatz in Unicode-Zeichen zum Anfang dieses Begriffs in der Beschreibung des Orts.
value	Typ:string Der Wert dieses Begriffs, z. B. „Taco Bell“.

Schnittstelle PredictionSubstring

Schnittstelle google.maps.places.PredictionSubstring

Stellt einen Vorhersage-Teilstring dar.

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

Schnittstelle StructuredFormatierung

Schnittstelle google.maps.places.StructuredFormatting

Enthält strukturierte Informationen zur Beschreibung des Ortes, unterteilt in einen Haupttext und einen Sekundärtext, einschließlich eines Arrays mit übereinstimmenden Teilstrings aus der automatischen Vervollständigung, gekennzeichnet durch einen Offset und eine Länge in Unicode-Zeichen

Attribute
main_text	Typ:string Dies ist der Haupttext der unformatierten Beschreibung des Ortes, der vom Places-Dienst vorgeschlagen wurde. Normalerweise der Name des Orts.
main_text_matched_substrings	Typ:Array<PredictionSubstring> 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 gekennzeichnet, ausgedrückt in Unicode-Zeichen.
secondary_text	Typ:string Dies ist der sekundäre Textteil der unformatierten Beschreibung des Ortes, der vom Places-Dienst vorgeschlagen wurde. Normalerweise der Ort.