Places Widgets

Klasse PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement-Klasse

AutocompleteView for Places API implementieren

Diese Klasse implementiert PlaceAutocompleteElementOptions.

Durch Aufrufen von 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 unterstü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 Ort auswählt. Gibt ein „Place“-Objekt zurück.
gmp-requesterror
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Back-End abgelehnt wurde (z.B. ein falscher API-Schlüssel). Dieses Ereignis wird nicht als Bubble angezeigt.

Schnittstelle PlaceAutocompleteElementOptions

Schnittstelle google.maps.places.PlaceAutocompleteElementOptions

Optionen zum Erstellen eines PlaceAutocompleteElements.
inputElement
Das Eingabeelement, für das automatische Vervollständigungen angezeigt werden sollen.
componentRestrictions optional
Die Komponenteneinschränkungen Mit den Komponenteneinschränkungen werden nur die Vorhersagen in der übergeordneten Komponente berücksichtigt. also z. B. das Land.
element optional
Typ:HTMLElement|SVGElement optional
Dieses Feld ist schreibgeschützt. Das DOM-Element, das die Ansicht unterstützt.
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
requestedLanguage 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.
requestedRegion 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“).
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.

Klasse Autocomplete

google.maps.places.Autocomplete-Klasse

Ein Widget, das Vorschläge zu Orten basierend auf der Texteingabe eines Nutzers liefert. Er wird an ein Eingabeelement vom Typ text angehängt und wartet auf Texteingaben in diesem Feld. Die Liste der Vervollständigungen wird als Drop-down-Liste dargestellt und aktualisiert, wenn Text eingegeben wird.

Diese Klasse erweitert MVCObject.

Durch Aufrufen von 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 an das angegebene Eingabetextfeld mit den angegebenen Optionen angehängt wird.
getBounds
getBounds()
Parameter:Keine
Rückgabewert:  LatLngBounds|undefined Die Grenzen der Gewichtung.
Gibt die Grenzen zurück, auf die Vorhersagen gewichtet sind.
getFields
getFields()
Parameter:Keine
Rückgabewert:  Array<string>|undefined
Gibt die Felder zurück, die für den Ort in der Antwortantwort einbezogen werden sollen, sobald 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 diese erfolgreich abgerufen wurden. Andernfalls wird ein Stub-Objekt zurückgegeben, bei dem das Attribut name auf den aktuellen Wert des Eingabefelds festgelegt ist.
setBounds
setBounds(bounds)
Parameter:
Rückgabewert: Keine
Legt den bevorzugten Bereich fest, in dem Place-Ergebnisse zurückgegeben werden sollen. Die Ergebnisse werden in diesem Gebiet bevorzugt.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parameter:
Rückgabewert: Keine
Legt die Komponenteneinschränkungen fest. Mit den Komponenteneinschränkungen werden nur die Vorhersagen in der übergeordneten Komponente berücksichtigt. also z. B. das Land.
setFields
setFields(fields)
Parameter:
  • fields:  Array<string> optional
Rückgabewert: Keine
Legt die Felder fest, die für den Ort in der Antwort angegeben werden sollen, wenn die Details 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 einzuschließenden Vervollständigungen.
Rückgabewert: Keine
Legt die Typen der Vorhersagen 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 Ort verfügbar ist, den der Nutzer ausgewählt hat.
Wenn der Nutzer den Namen eines Ortes eingibt, der nicht vom Steuerelement vorgeschlagen wurde und die Eingabetaste drückt, oder wenn eine „Places Details“-Anfrage fehlschlägt, enthält die PlaceResult die Nutzereingabe in der Eigenschaft name ohne andere Eigenschaften.

Schnittstelle AutocompleteOptions

Schnittstelle google.maps.places.AutocompleteOptions

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 den Komponenteneinschränkungen werden nur die Vorhersagen in der übergeordneten Komponente berücksichtigt. also z. B. das Land.
fields optional
Typ:Array<string> optional
Felder, die für den Ort in die Detailantwort aufgenommen werden sollen, nachdem die Details abgerufen wurden (wird abgerechnet). Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt. Dies wird für Produktionsbereitstellungen 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 PlaceResult-Objekt, das beim Auslösen des „place_changed“-Ereignisses verfügbar ist, enthält nur die Felder „place_id“, „types“ und „name“. Dabei werden die „place_id“, „types“ und „description“ 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 innerhalb der Grenzen des Autocomplete-Widgets zum Zeitpunkt des Sendens der Abfrage befinden. Wenn Sie „StrictBounds“ auf false festlegen (Standardeinstellung), werden die Ergebnisse nach Orten gewichtet, aber nicht auf diese beschränkt.
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.

google.maps.places.SearchBox-Klasse

Ein Widget, das Vorschläge für Suchanfragen basierend auf der Texteingabe eines Nutzers liefert. Er wird an ein Eingabeelement vom Typ text angehängt und wartet auf Texteingaben in diesem Feld. Die Liste der Vervollständigungen wird als Drop-down-Liste dargestellt und aktualisiert, wenn Text eingegeben wird.

Diese Klasse erweitert MVCObject.

Durch Aufrufen von 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 an das angegebene Eingabetextfeld mit den angegebenen Optionen angehängt wird.
getBounds
getBounds()
Parameter:Keine
Rückgabewert:  LatLngBounds|undefined
Gibt die Grenzen zurück, auf die Abfragevorhersagen gewichtet 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 dann nur für diesen Bereich gewichtet und nicht vollständig auf ihn 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 Abfrage auswählt. Mit getPlaces sollten neue Orte abgerufen werden.

Schnittstelle SearchBoxOptions

Schnittstelle google.maps.places.SearchBoxOptions

Die Optionen, die für ein SearchBox-Objekt festgelegt werden können.
bounds optional
Der Bereich, für den Abfragevorhersagen gewichtet werden sollen. Bei Abfragen werden Abfragen bevorzugt, die auf diese Grenzen ausgerichtet sind.