Klasse Autocomplete
google.maps.places.Autocomplete
-Klasse
Ein Widget, das basierend auf der Texteingabe eines Nutzers Ortsvorhersagen liefert. Er wird an ein Eingabeelement des Typs 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
.
Mit dem URL-Parameter &libraries=places
laden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Bei Verwendung von v=beta
kann über const {Autocomplete} = await google.map.importLibrary("places")
aufgerufen werden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
Autocomplete |
Autocomplete(inputField[, opts]) Parameter:
Erstellt eine neue Instanz von Autocomplete , die an das angegebene Eingabetextfeld mit den angegebenen Optionen angehängt wird. |
Methoden | |
---|---|
getBounds |
getBounds() Parameter:Keine
Rückgabewert:
LatLngBounds|undefined Die Grenzen der GewichtungGibt die Grenzen zurück, auf die Vorhersagen angewendet wurden. |
getFields |
getFields() Parameter:Keine
Rückgabewert:
Array<string>|undefined Gibt die Felder zurück, die für den Ort in der Detailantwort enthalten sein sollen, wenn die Details 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-Place-Objekt zurückgegeben, wobei die Eigenschaft name auf den aktuellen Wert des Eingabefelds festgelegt ist. |
setBounds |
setBounds(bounds) Parameter:
Rückgabewert:Keine
Legt den bevorzugten Bereich fest, in dem Ortsergebnisse zurückgegeben werden sollen. Die Ergebnisse sind auf dieses Gebiet ausgerichtet, sind aber nicht darauf beschränkt. |
setComponentRestrictions |
setComponentRestrictions(restrictions) Parameter:
Rückgabewert:Keine
Legt die Komponenteneinschränkungen fest. Komponenteneinschränkungen werden verwendet, um Vorhersagen auf Vorhersagen innerhalb der übergeordneten Komponente zu beschränken. Beispiel: das Land. |
setFields |
setFields(fields) Parameter:
Rückgabewert: Keine
Legt die Felder fest, die für den Ort in der Detailantwort enthalten sein 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:
Rückgabewert: Keine
Legt die Arten von Vorhersagen fest, die zurückgegeben werden sollen. Informationen zu 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
|
Events | |
---|---|
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 Orts eingibt, der vom Steuerelement nicht vorgeschlagen wurde, und die Eingabetaste drückt, oder wenn eine „Place Details“-Anfrage fehlschlägt, enthält der PlaceResult die Nutzereingabe in der Eigenschaft name . Es sind keine weiteren Attribute 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 Der Bereich, in dem nach Orten gesucht wird. |
componentRestrictions optional |
Typ:
ComponentRestrictions optional Die Komponenteneinschränkungen. Komponenteneinschränkungen werden verwendet, um Vorhersagen auf Vorhersagen innerhalb der übergeordneten Komponente zu beschränken. Beispiel: das Land. |
fields optional |
Typ:
Array<string> optional Felder, die für den Ort in die Antwort der Details aufgenommen werden sollen, wenn die Details abgerufen wurden (wird dann in Rechnung gestellt). 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'] . |
|
Typ:
boolean optional Gibt an, ob nur Orts-IDs abgerufen werden sollen. Das PlaceResult, das beim Auslösen des „place_changed“-Ereignisses zur Verfügung gestellt wird, enthält nur die Felder „place_id“, „types“ und „name“, wobei „place_id“, „types“ und „description“ vom Autocomplete-Dienst zurückgegeben werden. Standardmäßig deaktiviert. |
strictBounds optional |
Typ:
boolean optional Boolescher Wert, der angibt, dass das Widget für die automatische Vervollständigung nur die Orte zurückgeben soll, die sich innerhalb des Rahmens des Widgets zum Zeitpunkt der Anfrage befinden Wenn Sie „StrictBounds“ auf false (Standardeinstellung) setzen, werden die Ergebnisse nach Orten innerhalb der Grenzen gewichtet, aber nicht darauf beschränkt. |
types optional |
Typ:
Array<string> optional Die Arten von Vorhersagen, die zurückgegeben werden sollen. Informationen zu unterstützten Typen finden Sie im Entwicklerhandbuch. Wenn keine Typen angegeben sind, werden alle Typen zurückgegeben. |
SearchBox
google.maps.places.SearchBox
-Klasse
Ein Widget, das Abfragevorschläge basierend auf der Texteingabe eines Nutzers liefert. Er wird an ein Eingabeelement des Typs 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
.
Mit dem URL-Parameter &libraries=places
laden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Bei Verwendung von v=beta
kann über const {SearchBox} = await google.map.importLibrary("places")
aufgerufen werden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
SearchBox |
SearchBox(inputField[, opts]) Parameter:
Erstellt eine neue Instanz von SearchBox , die an das angegebene Eingabetextfeld mit den angegebenen Optionen angehängt wird. |
Methoden | |
---|---|
getBounds |
getBounds() Parameter: Keine
Rückgabewert:
LatLngBounds|undefined Gibt die Grenzen zurück, auf die Abfragevorhersagen ausgerichtet sind. |
getPlaces |
getPlaces() Parameter: Keine
Rückgabewert:
Array<PlaceResult>|undefined Gibt die Abfrage zurück, die vom Nutzer für das Ereignis places_changed ausgewählt wurde. |
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 in diesem Bereich bevorzugt und sind nicht vollständig darauf beschränkt. |
Übernommen:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Events | |
---|---|
places_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn der Nutzer eine Suchanfrage auswählt. Mit getPlaces sollten neue Orte abgerufen werden. |
SearchBoxOptions
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, auf den Abfragevorhersagen ausgerichtet werden sollen. Vorhersagen sind auf Abfragen ausgerichtet, die auf diese Grenzen ausgerichtet sind. Sie sind jedoch nicht darauf beschränkt. |