Places Widgets

PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement Klasse

  • PlaceAutocompleteElement ist eine HTMLElement-Unterklasse, die eine UI-Komponente für die Places Autocomplete API bereitstellt. Nachdem die places-Bibliothek geladen wurde, kann eine Eingabe mit der Funktion zur automatischen Vervollständigung in HTML erstellt werden. Beispiel:
    <gmp-placeautocomplete ></gmp-placeautocomplete>

Benutzerdefiniertes Element:
<gmp-placeautocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-placeautocomplete>

Diese Klasse erweitert HTMLElement.

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:
componentRestrictions
Die Komponenteneinschränkungen. Komponenteneinschränkungen werden verwendet, um Vorhersagen auf die Elemente innerhalb der übergeordneten Komponente zu beschränken. z. B. das Land.
locationBias
Typ:LocationBias optional
Eine weiche Grenze oder ein Hinweis für die Suche nach Orten.
locationRestriction
Typ:LocationRestriction optional
Begrenzungen, um Suchergebnisse einzuschränken.
name
Typ:string optional
Der Name, der für das Eingabeelement verwendet werden soll. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Verhält sich wie das Attribut „name“ für Eingaben. Dieser Name wird verwendet, wenn ein Formular gesendet wird. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
HTML-Attribut:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
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.
HTML-Attribut:
  • <gmp-placeautocomplete requested-language="string"></gmp-placeautocomplete>
requestedRegion
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“).
HTML-Attribut:
  • <gmp-placeautocomplete requested-region="string"></gmp-placeautocomplete>
types
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.
HTML-Attribut:
  • <gmp-placeautocomplete types="type1 type2 type3..."></gmp-placeautocomplete>
prediction-item
Ein Element im Drop-down-Menü mit Vorhersagen, das eine einzelne Vorhersage darstellt.
prediction-item-icon
Das links von jedem Element in der Liste der Vorhersagen angezeigte Symbol.
prediction-item-main-text
Ein Teil des Vorhersageelements, der den Haupttext der Vervollständigung darstellt. Bei geografischen Standorten enthält es einen Ortsnamen wie "Sydney" oder einen Straßennamen und eine Hausnummer wie "Königsstraße 10". Standardmäßig ist der Haupttext für das Vorhersageelement schwarz. Wenn im Prediction-Element zusätzlicher Text vorhanden ist, befindet er sich außerhalb von Prediction-Element-Haupttext und übernimmt den Stil des Vorschlags-Elements. Standardmäßig wird das Element grau dargestellt. Der zusätzliche Text ist in der Regel eine Adresse.
prediction-item-match
Der Teil der gelieferten Vervollständigung, der der Eingabe des Nutzers entspricht. Standardmäßig wird dieser übereinstimmende Text durch Fettformatierung hervorgehoben. Der übereinstimmende Text kann sich an einer beliebigen Stelle innerhalb des Vorschlags-Elements befinden. Er ist nicht unbedingt Teil von Prediction-Element-Haupttext.
prediction-item-selected
Das Element, wenn der Nutzer über die Tastatur zu ihm navigiert. Hinweis: Die ausgewählten Elemente werden sowohl von diesen Teilen-Stilen als auch von den Teil-Stilen für das Prediction-Element beeinflusst.
prediction-list
Das visuelle Element, das die Liste der Vorhersagen enthält, die vom Place Autocomplete-Dienst zurückgegeben wurden. Diese Liste wird als Dropdown-Liste unter dem PlaceAutocompleteElement angezeigt.
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter:
  • typestring Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Dabei wird die Groß- und Kleinschreibung berücksichtigt.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung empfängt. Dies muss eine Funktion oder ein Objekt mit der Methode "handleEvent" sein
  • optionsboolean|AddEventListenerOptions optional Weitere Informationen finden Sie unter Optionen. Benutzerdefinierte Ereignisse unterstützen nur capture und passive.
Rückgabewert:  void
Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel geliefert wird. Siehe addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter:
  • typestring Ein String, der die Art des Ereignisses angibt, für das ein Ereignis-Listener entfernt werden soll.
  • listenerEventListener|EventListenerObject Der Event-Listener des Event-Handlers, der aus dem Ereignisziel entfernt werden soll.
  • optionsboolean|EventListenerOptions optional Siehe Optionen
Rückgabewert:  void
Entfernt einen Event-Listener, der zuvor mit addEventListener registriert wurde, aus dem Ziel. Siehe removeEventListener.

PlaceAutocompleteElementOptions-Schnittstelle

google.maps.places.PlaceAutocompleteElementOptions-Schnittstelle

Optionen zum Erstellen eines PlaceAutocompleteElement-Elements.

componentRestrictions optional
locationBias optional
Typ:LocationBias optional
locationRestriction optional
Typ:LocationRestriction optional
requestedLanguage optional
Typ:string optional
requestedRegion optional
Typ:string optional
types optional
Typ:Array<string> optional

PlaceAutocompletePlaceSelectEvent-Klasse

google.maps.places.PlaceAutocompletePlaceSelectEvent Klasse

Dieses Ereignis wird erstellt, nachdem der Nutzer einen Ort mit dem „Place Autocomplete“-Element ausgewählt hat. Greifen Sie mit event.place auf die Auswahl zu.

Diese Klasse erweitert Event.

Zugriff über const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Betaplace
Typ:Place

PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent Klasse

Dieses Ereignis wird vom PlaceAutocompleteElement ausgegeben, wenn ein Problem mit der Netzwerkanfrage auftritt.

Diese Klasse erweitert Event.

Zugriff über const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

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:
  • fieldsArray<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:
  • typesArray<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.