Places Widgets

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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.

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 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:
  • fields: Array<string> optional
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:
  • types: Array<string> optional Die Typen der einzuschließenden Vorhersagen.
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
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.

bounds 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'].
placeIdOnly optional
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.

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.

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 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
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.

bounds 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.