Places Widgets

Klasse PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement Kurs

„PlaceAutocompleteElement“ ist eine HTMLElement-Unterklasse, die eine UI-Komponente für die Places Autocomplete API bereitstellt.

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

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceAutocompleteElementOptions.

Rufe const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parameter: 
componentRestrictions
Die Komponenteneinschränkungen. Mit Komponenteneinschränkungen können Sie die Vorhersagen auf die übergeordnete Komponente beschränken. Zum Beispiel das Land.
locationBias
Typ:LocationBias optional
Eine weiche Grenze oder ein Hinweis, der bei der Suche nach Orten verwendet wird.
locationRestriction
Typ:LocationRestriction optional
Grenzen, um die 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. Das Verhalten entspricht dem des Attributs „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 werden möglicherweise höher gelistet, aber Vorschläge sind nicht auf diese Sprache beschränkt. Hier finden Sie eine Liste der unterstützten Sprachen.
HTML-Attribut:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Typ:string optional
Ein Regionscode, der für die Formatierung und Filterung von Ergebnissen verwendet wird. Die Vorschläge werden nicht auf dieses Land beschränkt. Der Regionscode kann ein zweistelliger Wert für eine Länderspezifische Top-Level-Domain (ccTLD) sein. 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 für die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“).
HTML-Attribut:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
Typ:Array<string> optional
Die Arten von 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.
HTML-Attribut:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
Ein Eintrag im Drop-down-Menü für Vorschläge, der 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 Vorhersage 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 Text „prediction-item-main-text“ schwarz. Wenn zusätzlicher Text im Element „prediction-item“ vorhanden ist, befindet er sich außerhalb von „prediction-item-main-text“ und übernimmt den Stil von „prediction-item“. 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 innerhalb von „prediction-item“ an einer beliebigen Stelle befinden. Er ist nicht unbedingt Teil von „prediction-item-main-text“.
prediction-item-selected
Das Element, das zu sehen ist, wenn der Nutzer es über die Tastatur aufruft. Hinweis: Die ausgewählten Elemente werden sowohl von diesen Teilstilen als auch von den Stilen der Elemente für die Vorhersage 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 Drop-down-Liste unter dem PlaceAutocompleteElement angezeigt.
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Die Groß- und Kleinschreibung ist dabei zu beachten.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der Methode „handleEvent“ sein.
  • options:  boolean|AddEventListenerOptions optional Siehe Optionen. Bei benutzerdefinierten Ereignissen werden nur capture und passive unterstützt.
Rückgabewert:void
Hiermit wird eine Funktion eingerichtet, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Weitere Informationen finden Sie unter addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
Rückgabewert:void
Entfernt einen zuvor mit addEventListener registrierten Ereignis-Listener aus dem Ziel. Siehe removeEventListener
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen Ortsvorschlag auswählt. Enthält ein Ortsobjekt.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. aufgrund eines falschen API-Schlüssels). Dieses Ereignis wird nicht weitergegeben.

PlaceAutocompleteElementOptions-Schnittstelle

google.maps.places.PlaceAutocompleteElementOptions Benutzeroberfläche

Optionen zum Erstellen eines PlaceAutocompleteElements.
componentRestrictions optional
PlaceAutocompleteElement.componentRestrictions ansehen
locationBias optional
Typ:LocationBias optional
PlaceAutocompleteElement.locationBias ansehen
locationRestriction optional
Typ:LocationRestriction optional
PlaceAutocompleteElement.locationRestriction ansehen
requestedLanguage optional
Typ:string optional
PlaceAutocompleteElement.requestedLanguage ansehen
requestedRegion optional
Typ:string optional
PlaceAutocompleteElement.requestedRegion ansehen
types optional
Typ:Array<string> optional
PlaceAutocompleteElement.types ansehen

PlaceAutocompletePlaceSelectEvent-Klasse

google.maps.places.PlaceAutocompletePlaceSelectEvent Kurs

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

Diese Klasse erweitert Event.

Rufe const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Betaplace
Typ:Place

PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent Kurs

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

Diese Klasse erweitert Event.

Rufe const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Autocomplete-Klasse

google.maps.places.Autocomplete Kurs

Ein Widget, das Ortsvorschläge basierend auf der Textzeile eines Nutzers liefert. Es wird an ein Eingabeelement vom Typ text angehängt und überwacht die Texteingaben in diesem Feld. Die Liste der Vorschläge wird als Drop-down-Liste angezeigt und aktualisiert sich während der Texteingabe.

Diese Klasse erweitert MVCObject.

Rufe const {Autocomplete} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. 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 Grenzen der Voreingenommenheit.
Gibt die Grenzen zurück, in denen die Vorhersagen verzerrt sind.
getFields
getFields()
Parameter:Keine
Rückgabewert:Array<string>|undefined
Gibt die Felder zurück, die für den Ort in der Antwort mit Details enthalten sein 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.
Die Details des vom Nutzer ausgewählten Orts werden zurückgegeben, sofern sie erfolgreich abgerufen werden konnten. Andernfalls wird ein Platz-Stub-Objekt zurückgegeben, bei dem die Property name auf den aktuellen Wert des Eingabefelds festgelegt ist.
setBounds
setBounds(bounds)
Parameter: 
Rückgabewert:Keiner
Legt den bevorzugten Bereich fest, in dem Ergebnisse für Orte zurückgegeben werden sollen. Bei den Ergebnissen werden Orte innerhalb dieses Gebiets bevorzugt, es werden jedoch nicht nur Orte gefunden.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parameter: 
Rückgabewert:Keiner
Legt die Komponenteneinschränkungen fest. Mit Komponenteneinschränkungen können Sie die Vorhersagen auf die übergeordnete Komponente beschränken. Zum Beispiel das Land.
setFields
setFields(fields)
Parameter: 
  • fields:  Array<string> optional
Rückgabewert:Keiner
Hiermit werden die Felder festgelegt, die für den Ort in der Antwort mit Details enthalten sein sollen, wenn die Details erfolgreich abgerufen wurden. Eine Liste der Felder finden Sie unter PlaceResult.
setOptions
setOptions(options)
Parameter: 
Rückgabewert:Keiner
setTypes
setTypes(types)
Parameter: 
  • types:  Array<string> optionalDie Arten von Vorhersagen, die eingeschlossen werden sollen.
Rückgabewert:Keiner
Legt die Arten von Vorschlägen fest, 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.
Ü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 Orts eingibt, der nicht vom Steuerelement vorgeschlagen wurde, und die Eingabetaste drückt, oder wenn eine Anfrage für Ortsdetails fehlschlägt, enthält das PlaceResult die Nutzereingabe in der Property name. Es sind keine anderen Properties definiert.

Benutzeroberfläche AutocompleteOptions

google.maps.places.AutocompleteOptions Benutzeroberfläche

Die Optionen, die für ein Autocomplete-Objekt festgelegt werden können.
bounds optional
Der Bereich, in dem nach Orten gesucht werden soll.
componentRestrictions optional
Die Komponenteneinschränkungen. Mit Komponenteneinschränkungen können Sie die Vorhersagen auf die übergeordnete Komponente beschränken. Zum Beispiel das Land.
fields optional
Typ:Array<string> optional
Felder, die für den Ort in der Antwort mit Details enthalten sein müssen, wenn die Details erfolgreich abgerufen wurden. Diese Felder werden in Rechnung gestellt. Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt. Bei Produktions-Deployments wird hiervon abgeraten. 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. Der PlaceResult, der beim Auslösen des Ereignisses „place_changed“ verfügbar gemacht wird, enthält nur die Felder „place_id“, „types“ und „name“. „place_id“, „types“ und „description“ werden vom Autocomplete-Dienst zurückgegeben. Standardmäßig deaktiviert.
strictBounds optional
Typ:boolean optional
Ein boolescher Wert, der angibt, dass das Autocomplete-Widget nur die Orte zurückgeben soll, die sich zum Zeitpunkt des Sendens der Anfrage innerhalb des Autocomplete-Widgets befinden. Wenn Sie „strictBounds“ auf false (Standardeinstellung) festlegen, werden bei den Ergebnissen Orte innerhalb des Gebiets bevorzugt, es werden jedoch nicht nur Orte gefunden.
types optional
Typ:Array<string> optional
Die Arten von 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.

google.maps.places.SearchBox Kurs

Ein Widget, das Suchanfragevorschläge basierend auf der Texteingabe eines Nutzers liefert. Es wird an ein Eingabeelement vom Typ text angehängt und überwacht die Texteingaben in diesem Feld. Die Liste der Vorschläge wird als Drop-down-Liste angezeigt und aktualisiert sich während der Texteingabe.

Diese Klasse erweitert MVCObject.

Rufe const {SearchBox} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. 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, innerhalb derer Suchanfragevorschläge verzerrt sind.
getPlaces
getPlaces()
Parameter:Keine
Rückgabewert:Array<PlaceResult>|undefined
Gibt die vom Nutzer ausgewählte Abfrage zurück, die für das Ereignis vom Typ places_changed verwendet werden soll.
setBounds
setBounds(bounds)
Parameter: 
Rückgabewert:Keiner
Legt die Region fest, die für die Voreingenommenheit von Abfragevorhersagen verwendet werden soll. Die Ergebnisse werden nur in diesem Gebiet bevorzugt, sind aber 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 Suchanfrage auswählt. getPlaces sollte verwendet werden, um neue Orte abzurufen.

SearchBoxOptions-Schnittstelle

google.maps.places.SearchBoxOptions Benutzeroberfläche

Die Optionen, die für ein SearchBox-Objekt festgelegt werden können.
bounds optional
Der Bereich, in Richtung dem Suchanfragen verzerrt werden sollen. Bei den Vorhersagen werden Suchanfragen, die auf diese Gebiete ausgerichtet sind, bevorzugt, sind aber nicht darauf beschränkt.