PlaceAutocompleteElement
google.maps.places.PlaceAutocompleteElement
Klasse
- PlaceAutocompleteElement ist eine
HTMLElement
-Unterklasse, die eine UI-Komponente für die Places Autocomplete API bereitstellt. Nachdem dieplaces
-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.
Konstruktor | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) Parameter:
|
Attribute | |
---|---|
componentRestrictions |
Typ:
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. |
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:
|
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:
|
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:
|
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:
|
Teile | |
---|---|
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. |
Methoden | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel geliefert wird. Siehe addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options]) Parameter:
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.
Attribute | |
---|---|
componentRestrictions optional |
Typ:
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 PlaceAutocompleteElement.types ansehen |
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.
Attribute | |
---|---|
place |
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.
Konstruktor | |
---|---|
Autocomplete |
Autocomplete(inputField[, opts]) Parameter:
Erstellt eine neue Instanz von Autocomplete , die mit den angegebenen Optionen an das angegebene Eingabetextfeld angehängt wird. |
Methoden | |
---|---|
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 OrtGibt 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:
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:
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
|
Veranstaltungen | |
---|---|
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.
Attribute | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Das Gebiet, in dem nach Orten gesucht wird. |
componentRestrictions optional |
Typ:
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'] . |
|
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. |
SearchBox-Klasse
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.
Konstruktor | |
---|---|
SearchBox |
SearchBox(inputField[, opts]) Parameter:
Erstellt eine neue Instanz von SearchBox , die mit den angegebenen Optionen an das angegebene Eingabetextfeld angehängt wird. |
Methoden | |
---|---|
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
|
Veranstaltungen | |
---|---|
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.
Attribute | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral 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. |