Places Widgets

PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement Klasse

Implementierung von AutocompleteView für die Places API

Mit dieser Klasse wird PlaceAutocompleteElementOptions implementiert.

Zugriff über const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parameter:
element optional
Typ:HTMLElement|SVGElement optional
Dieses Feld ist schreibgeschützt. Das DOM-Element, das die Ansicht stützt.
inputElement
Das Eingabeelement, für das automatische Vervollständigungen angezeigt werden sollen.
Übernommen: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
Parameter:
  • eventName:  string
  • handler:  Function
Rückgabewert:  MapsEventListener
Fügt die angegebene Listener-Funktion dem angegebenen Ereignisnamen hinzu.
gmp-placeselect
function(place)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen Ortsvorschlag auswählt. Gibt ein Ortsobjekt zurück.
gmp-requesterror
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. ein falscher API-Schlüssel). Dieser Termin wird nicht als Bubble angezeigt.

PlaceAutocompleteElementOptions-Schnittstelle

google.maps.places.PlaceAutocompleteElementOptions-Schnittstelle

Optionen zum Erstellen eines PlaceAutocompleteElement-Elements.
inputElement
Das Eingabeelement, für das automatische Vervollständigungen angezeigt werden sollen.
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.
element optional
Typ:HTMLElement|SVGElement optional
Dieses Feld ist schreibgeschützt. Das DOM-Element, das die Ansicht stützt.
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.
requestedLanguage 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.
requestedRegion 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“).
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.

Autocomplete-Klasse

google.maps.places.Autocomplete Klasse

Ein Widget, das Vorschläge für Orte auf Grundlage der Texteingabe eines Nutzers bereitstellt. Sie wird an ein Eingabeelement des Typs text angehängt und wartet auf Texteingaben in diesem Feld. Die Liste mit Vorschlägen wird als Drop-down-Liste angezeigt und durch Eingabe von Text aktualisiert.

Diese Klasse erweitert MVCObject.

Zugriff über const {Autocomplete} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
Parameter:
Erstellt eine neue Instanz von Autocomplete, die mit den angegebenen Optionen an das angegebene Eingabetextfeld angehängt wird.
getBounds
getBounds()
Parameter:Keine
Rückgabewert:  LatLngBounds|undefined Die Gewichtungsgrenzen.
Gibt die Grenzen zurück, zu denen Vorhersagen verzerrt sind.
getFields
getFields()
Parameter:Keine
Rückgabewert:  Array<string>|undefined
Gibt die Felder zurück, die in der Detailantwort für den Ort eingeschlossen werden sollen, wenn die Details erfolgreich abgerufen wurden. Eine Liste der Felder finden Sie unter PlaceResult.
getPlace
getPlace()
Parameter:Keine
Rückgabewert:PlaceResult Der vom Nutzer ausgewählte Ort
Gibt die Details des vom Nutzer ausgewählten Orts zurück, wenn die Details erfolgreich abgerufen wurden Andernfalls wird ein Stub-Objekt zurückgegeben, bei dem die Eigenschaft name auf den aktuellen Wert des Eingabefelds festgelegt ist.
setBounds
setBounds(bounds)
Parameter:
Rückgabewert:Keine
Legt den bevorzugten Bereich fest, innerhalb dessen Ortsergebnisse zurückgegeben werden sollen. Die Ergebnisse sind nach diesem Bereich gewichtet, aber nicht darauf beschränkt.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parameter:
Rückgabewert:Keine
Legt die Komponenteneinschränkungen fest. Komponenteneinschränkungen werden verwendet, um Vorhersagen auf die Elemente innerhalb der übergeordneten Komponente zu beschränken. z. B. das Land.
setFields
setFields(fields)
Parameter:
  • fields:  Array<string> optional
Rückgabewert:Keine
Legt die Felder fest, die in der Detailantwort für den Ort eingeschlossen werden sollen, wenn die Details erfolgreich abgerufen wurden. Eine Liste der Felder finden Sie unter PlaceResult.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keine
setTypes
setTypes(types)
Parameter:
  • types:  Array<string> optional Die Typen der Vorhersagen, die einbezogen werden sollen.
Rückgabewert:Keine
Legt die Typen von Vorhersagen fest, die zurückgegeben werden sollen. Die unterstützten Typen finden Sie im Entwicklerhandbuch. Wenn keine Typen angegeben sind, werden alle Typen zurückgegeben.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn ein PlaceResult für einen vom Nutzer ausgewählten Ort verfügbar gemacht wird.
Wenn der Nutzer den Namen eines Ortes eingibt, der nicht vom Steuerelement vorgeschlagen wurde, und die Eingabetaste drückt, oder wenn eine Place Details-Anfrage fehlschlägt, enthält PlaceResult die Nutzereingabe in der Eigenschaft name. Es sind keine anderen Eigenschaften definiert.

AutocompleteOptions-Schnittstelle

google.maps.places.AutocompleteOptions-Schnittstelle

Die Optionen, die für ein Autocomplete-Objekt festgelegt werden können.
bounds optional
Das Gebiet, in dem nach Orten gesucht wird.
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.
fields optional
Typ:Array<string> optional
Felder, die in die Details-Antwort für den Ort aufgenommen werden sollen, wenn die Details erfolgreich abgerufen wurden; in Rechnung gestellt. Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt (für Produktionsbereitstellungen wird dies nicht empfohlen). Eine Liste der Felder finden Sie unter PlaceResult. Verschachtelte Felder können mit Punktpfaden angegeben werden (z. B. "geometry.location"). Der Standardwert ist ['ALL'].
placeIdOnly optional
Typ:boolean optional
Gibt an, ob nur Orts-IDs abgerufen werden sollen. Das beim Auslösen des „place_changed“-Ereignisses zur Verfügung gestellte „PlaceResult“-Ereignis enthält nur die Felder „place_id“, „types“ und „name“ mit den vom Autocomplete-Dienst zurückgegebenen „place_id“, „types“ und „description“. Standardmäßig deaktiviert.
strictBounds optional
Typ:boolean optional
Boolescher Wert, der angibt, dass das Autocomplete-Widget nur die Orte zurückgeben soll, die sich beim Senden der Abfrage innerhalb des Bereichs des Widgets befinden. Wenn Sie strictBounds auf false (Standardeinstellung) setzen, werden die Ergebnisse nach Orten innerhalb der Begrenzungen gewichtet, aber nicht darauf beschränkt.
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.

google.maps.places.SearchBox Klasse

Ein Widget, das Abfragevorhersagen basierend auf der Texteingabe eines Nutzers bereitstellt. Sie wird an ein Eingabeelement des Typs text angehängt und wartet auf Texteingaben in diesem Feld. Die Liste mit Vorschlägen wird als Drop-down-Liste angezeigt und durch Eingabe von Text aktualisiert.

Diese Klasse erweitert MVCObject.

Zugriff über const {SearchBox} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
SearchBox
SearchBox(inputField[, opts])
Parameter:
Erstellt eine neue Instanz von SearchBox, die mit den angegebenen Optionen an das angegebene Eingabetextfeld angehängt wird.
getBounds
getBounds()
Parameter:Keine
Rückgabewert:  LatLngBounds|undefined
Gibt die Grenzen zurück, zu denen Abfragevorhersagen verzerrt sind.
getPlaces
getPlaces()
Parameter:Keine
Rückgabewert:  Array<PlaceResult>|undefined
Gibt die vom Nutzer ausgewählte Abfrage zurück, die mit dem Ereignis places_changed verwendet werden soll.
setBounds
setBounds(bounds)
Parameter:
Rückgabewert:Keine
Legt die Region fest, die für die Gewichtung von Abfragevorhersagen verwendet werden soll. Die Ergebnisse werden nur auf diesen Bereich ausgerichtet und nicht vollständig darauf beschränkt.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn der Nutzer eine Anfrage auswählt. Zum Abrufen neuer Orte sollte getPlaces verwendet werden.

SearchBoxOptions-Schnittstelle

google.maps.places.SearchBoxOptions-Schnittstelle

Die Optionen, die für ein SearchBox-Objekt festgelegt werden können.
bounds optional
Der Bereich, nach dem Abfragevorhersagen gewichtet werden sollen. Vorhersagen werden voreingenommen zu Suchanfragen, die auf diese Grenzen ausgerichtet sind, sind aber nicht darauf beschränkt.