Places Widgets

Klasse PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement Klasse

Hinweis:Nur im v=beta-Kanal verfügbar.

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

Benutzerdefiniertes Element:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng|lat,lng,altitude" requested-language="string" requested-region="string" unit-system="metric|imperial" types="type1 type2 type3..."></gmp-place-autocomplete>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceAutocompleteElementOptions.

Zugriff durch Anrufen von const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
PlaceAutocompleteElement	PlaceAutocompleteElement(options) Parameter: options:  PlaceAutocompleteElementOptions

Attribute
includedPrimaryTypes	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:Array<string> optional Der primäre Ortstyp (z. B. „restaurant“ oder „gas_station“) ist enthalten. Ein Ort wird nur zurückgegeben, wenn sein primärer Typ in dieser Liste enthalten ist. Sie können bis zu fünf Werte angeben. Wenn keine Typen angegeben sind, werden alle Ortstypen zurückgegeben. HTML-Attribut <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:Array<string> optional Schließen Sie nur Ergebnisse in den angegebenen Regionen ein, die als bis zu 15 zweistellige CLDR-Regionencodes angegeben werden. Ein leeres Set schränkt die Ergebnisse nicht ein. Wenn sowohl locationRestriction als auch includedRegionCodes festgelegt sind, befinden sich die Ergebnisse im Schnittbereich. HTML-Attribut <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias	Typ:LocationBias optional Eine weiche Grenze oder ein Hinweis, der bei der Suche nach Orten verwendet werden soll.
locationRestriction	Typ:LocationRestriction optional Grenzen zum Einschränken von Suchergebnissen.
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. Entspricht dem Verhalten des Attributs „name“ für Eingaben. Beachten Sie, dass dieser Name verwendet wird, wenn ein Formular gesendet wird. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form. HTML-Attribut <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Der Ursprung, von dem aus die Entfernung berechnet werden soll. Wenn keine Angabe erfolgt, wird die Entfernung nicht berechnet. Die Höhe wird, sofern angegeben, nicht in die Berechnung einbezogen. HTML-Attribut <gmp-place-autocomplete origin="lat,lng|lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage	Typ:string optional Eine Sprach-ID für die Sprache, in der die Ergebnisse nach Möglichkeit zurückgegeben werden sollen. Ergebnisse in der ausgewählten Sprache werden möglicherweise höher eingestuft, 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 Ergebnisformatierung und ‑filterung verwendet wird. Die Vorschläge werden dadurch nicht auf dieses Land beschränkt. Für den Regionscode ist ein zweistelliger Ländercode der Top-Level-Domain (ccTLD) zulässig. 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 das Land „Vereinigtes Königreich Großbritannien und Nordirland“). HTML-Attribut <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:UnitSystem optional Das Einheitensystem, das zum Anzeigen von Entfernungen verwendet wird. Wenn nicht angegeben, wird das Einheitensystem durch „requestedRegion“ bestimmt. HTML-Attribut <gmp-place-autocomplete unit-system="metric|imperial"></gmp-place-autocomplete>
componentRestrictions	Eingestellt:Diese Property funktioniert weiterhin im Betakanal, wird aber nicht im Alphakanal oder bei der Veröffentlichung verfügbar sein. Geben Sie für die Migration sowohl diese Property als auch includeRegionCodes an. Hinweis:Nur im v=beta-Kanal verfügbar. Typ:ComponentRestrictions optional Die Einschränkungen für die Komponente. Mit Komponentenbeschränkungen werden Vorhersagen auf die übergeordnete Komponente beschränkt. Zum Beispiel das Land.
types	Eingestellt:Diese Property funktioniert weiterhin im Betakanal, wird aber nicht im Alphakanal oder bei der Veröffentlichung verfügbar sein. Geben Sie für die Migration sowohl diese Property als auch includedPrimaryTypes an. Hinweis:Nur im v=beta-Kanal verfügbar. 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>

Teile
prediction-item	Ein Element im Drop-down-Menü mit Vorschlägen, das einen einzelnen Vorschlag 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 enthält. 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 des Vorschlags schwarz. Wenn zusätzlicher Text im Vorhersageelement 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 sind sowohl von diesen Teilformatierungen als auch von den Teilformatierungen für Vorhersageelemente betroffen.
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.

Methoden
addEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. addEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Die Groß-/Kleinschreibung muss beachtet werden. 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 Optionen Benutzerdefinierte Ereignisse unterstützen nur capture und passive. Rückgabewert:void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener.
removeEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. removeEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Typ des Ereignisses angibt, für das ein Event-Listener entfernt werden soll. listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Event-Ziel entfernt werden soll. options:  boolean|EventListenerOptions optional Optionen Rückgabewert:void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener.

Ereignisse
gmp-error	function(errorEvent) Argumente:  errorEvent:  Event 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.
gmp-select	function(placePredictionSelectEvent) Argumente:  placePredictionSelectEvent:  PlacePredictionSelectEvent Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen Ortsvorschlag auswählt. Enthält ein PlacePrediction-Objekt, das in ein Place-Objekt konvertiert werden kann.
gmp-placeselect	Eingestellt:Das Ereignis gmp-placeselect wird weiterhin im Betakanal ausgelöst, aber nicht im Alphakanal oder bei der Veröffentlichung. Für die Migration sollten Sie weiterhin auf das gmp-placeselect-Ereignis warten, aber auch einen Event-Listener für das gmp-select-Ereignis hinzufügen, das ein PlacePredictionSelectEvent-Objekt zurückgibt. function(placeAutocompletePlaceSelectEvent) Argumente:  placeAutocompletePlaceSelectEvent:  PlaceAutocompletePlaceSelectEvent Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen Ortsvorschlag auswählt. Enthält ein Place-Objekt.

PlaceAutocompleteElementOptions Schnittstelle

google.maps.places.PlaceAutocompleteElementOptions-Schnittstelle

Hinweis:Nur im v=alpha-Kanal verfügbar.

Optionen zum Erstellen eines PlaceAutocompleteElement. Eine Beschreibung der einzelnen Attribute finden Sie im Attribut mit demselben Namen in der Klasse „PlaceAutocompleteElement“.

Attribute
componentRestrictions optional	Eingestellt:Diese Property funktioniert weiterhin im Betakanal, wird aber nicht im Alphakanal oder bei der Veröffentlichung verfügbar sein. Geben Sie für die Migration sowohl diese Property als auch includedRegionCodes an. Hinweis:Nur im v=beta-Kanal verfügbar. Typ:ComponentRestrictions optional
includedPrimaryTypes optional	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:Array<string> optional
includedRegionCodes optional	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:Array<string> optional
locationBias optional	Typ:LocationBias optional
locationRestriction optional	Typ:LocationRestriction optional
name optional	Typ:string optional
origin optional	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
requestedLanguage optional	Typ:string optional
types optional	Eingestellt:Diese Property funktioniert weiterhin im Betakanal, wird aber nicht im Alphakanal oder bei der Veröffentlichung verfügbar sein. Geben Sie für die Migration sowohl diese Property als auch includedPrimaryTypes an. Hinweis:Nur im v=beta-Kanal verfügbar. Typ:Array<string> optional
unitSystem optional	Hinweis:Nur im v=alpha-Kanal verfügbar. Typ:UnitSystem optional

PlaceAutocompletePlaceSelectEvent-Klasse

google.maps.places.PlaceAutocompletePlaceSelectEvent Klasse

Eingestellt:Das Ereignis gmp-placeselect wird weiterhin im Betakanal ausgelöst, aber nicht im Alphakanal oder bei der Veröffentlichung. Für die Migration sollten Sie weiterhin auf das gmp-placeselect-Ereignis warten, aber auch einen Event-Listener für das gmp-select-Ereignis hinzufügen, das ein PlacePredictionSelectEvent-Objekt zurückgibt.

Hinweis:Nur im v=beta-Kanal verfügbar.

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 durch Anrufen von const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Attribute
place	Hinweis:Nur im v=beta-Kanal verfügbar. Typ:Place

Klasse PlacePredictionSelectEvent

google.maps.places.PlacePredictionSelectEvent Klasse

Hinweis:Nur im v=alpha-Kanal verfügbar.

Dieses Ereignis wird erstellt, nachdem der Nutzer ein Vorschlagselement mit dem PlaceAutocompleteElement ausgewählt hat. Greifen Sie mit event.placePrediction auf die Auswahl zu.

Diese Klasse erweitert Event.

Zugriff durch Anrufen von const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Attribute
placePrediction	Typ:PlacePrediction

PlaceAutocompleteRequestErrorEvent-Klasse

google.maps.places.PlaceAutocompleteRequestErrorEvent Klasse

Eingestellt:Das Ereignis gmp-requesterror wird weiterhin im Betakanal ausgelöst, aber nicht im Alphakanal oder bei der Veröffentlichung. Für die Migration sollten Sie weiterhin auf das gmp-requesterror-Ereignis warten, aber auch einen Event-Listener für das gmp-error-Ereignis hinzufügen, das ein Event-Objekt zurückgibt.

Hinweis:Nur im v=beta-Kanal verfügbar.

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

Diese Klasse erweitert Event.

Zugriff durch Anrufen von const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

PlaceDetailsElement-Klasse

google.maps.places.PlaceDetailsElement Klasse

Hinweis:Nur im v=alpha-Kanal verfügbar.

Ein HTML-Element, in dem Details zu einem Ort angezeigt werden. Geben Sie mit den Methoden configureFromPlace() oder configureFromLocation() die zu rendernden Inhalte an. Wenn Sie das Element „Ortsdetails“ verwenden möchten, müssen Sie die Places UI Kit API für Ihr Projekt in der Google Cloud Console aktivieren.

Benutzerdefiniertes Element:
<gmp-place-details size="small"></gmp-place-details>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceDetailsElementOptions.

Zugriff durch Anrufen von const {PlaceDetailsElement} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
PlaceDetailsElement	PlaceDetailsElement([options]) Parameter: options:  PlaceDetailsElementOptions optional

Attribute
place	Typ:Place optional Schreibgeschützt. Place-Objekt mit der ID, dem Standort und dem Viewport des aktuell gerenderten Orts.
size	Typ:PlaceDetailsSize optional Die Größenvariante des PlaceDetailsElement. Standardmäßig wird im Element PlaceDetailsSize.X_LARGE angezeigt. HTML-Attribut <gmp-place-details size="small"></gmp-place-details> <gmp-place-details size="medium"></gmp-place-details> <gmp-place-details size="large"></gmp-place-details> <gmp-place-details size="x-large"></gmp-place-details>

Methoden
addEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. addEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Die Groß-/Kleinschreibung muss beachtet werden. 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 Optionen Benutzerdefinierte Ereignisse unterstützen nur capture und passive. Rückgabewert:void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener.
configureFromLocation	configureFromLocation(location) Parameter: location:  LatLng|LatLngLiteral Der Ort, für den Ortsdetails gerendert werden sollen. Rückgabewert:Promise<void> Ein Promise, das aufgelöst wird, sobald Ortsdaten geladen und gerendert wurden. Konfiguriert das Widget anhand einer LatLng mithilfe der umgekehrten Geocodierung.
configureFromPlace	configureFromPlace(place) Parameter: place:  Place|{id:string} Der Ort, für den Details gerendert werden sollen. Rückgabewert:Promise<void> Ein Promise, das aufgelöst wird, sobald Ortsdaten geladen und gerendert wurden. Konfiguriert das Widget anhand eines Place-Objekts oder einer Orts-ID.
removeEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. removeEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Typ des Ereignisses angibt, für das ein Event-Listener entfernt werden soll. listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Event-Ziel entfernt werden soll. options:  boolean|EventListenerOptions optional Optionen Rückgabewert:void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener.

Ereignisse
gmp-load	function(event) Argumente:  event:  Event Dieses Ereignis wird ausgelöst, wenn das Element geladen und sein Inhalt gerendert wird. Dieses Ereignis wird nicht weitergegeben.
gmp-requesterror	function(event) Argumente:  event:  Event 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.

PlaceDetailsElementOptions-Schnittstelle

google.maps.places.PlaceDetailsElementOptions-Schnittstelle

Hinweis:Nur im v=alpha-Kanal verfügbar.

Optionen für PlaceDetailsElement.

Attribute
size optional	Typ:PlaceDetailsSize optional PlaceDetailsElement.size ansehen

PlaceDetailsSize-Konstanten

google.maps.places.PlaceDetailsSize Konstanten

Hinweis:Nur im v=alpha-Kanal verfügbar.

Größenvarianten für PlaceDetailsElement.

Zugriff durch Anrufen von const {PlaceDetailsSize} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstanten
LARGE	Große Variante mit einem großen Bild, grundlegenden Informationen und Kontaktdaten.
MEDIUM	Mittlere Variante mit einem großen Bild und grundlegenden Informationen.
SMALL	Kleine Variante mit einem kleinen Bild und grundlegenden Informationen.
X_LARGE	Extragroße Variante mit einer Fotocollage, Rezensionen und umfassenden Informationen zum Ort.

Klasse PlaceListElement

google.maps.places.PlaceListElement Klasse

Hinweis:Nur im v=alpha-Kanal verfügbar.

Ein HTML-Element, in dem die Ergebnisse einer Ortssuche in einer Liste angezeigt werden. Verwenden Sie die Methoden configureFromSearchByTextRequest() oder configureFromSearchNearbyRequest(), um die Anfrage anzugeben, für die Ergebnisse gerendert werden sollen. Wenn Sie das Element „Ortsliste“ verwenden möchten, müssen Sie die Places UI Kit API für Ihr Projekt in der Google Cloud Console aktivieren.

Benutzerdefiniertes Element:
<gmp-place-list selectable></gmp-place-list>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceListElementOptions.

Zugriff durch Anrufen von const {PlaceListElement} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
PlaceListElement	PlaceListElement([options]) Parameter: options:  PlaceListElementOptions optional

Attribute
places	Typ:Array<Place> Schreibgeschützt. Array mit Place-Objekten, die die IDs, Standorte und Viewports der aktuell gerenderten Orte enthalten.
selectable	Typ:boolean Gibt an, ob die Listenelemente ausgewählt werden können. Bei „true“ sind die Listenelemente Schaltflächen, die bei einem Klick das gmp-placeselect-Ereignis auslösen. Die barrierefreie Tastaturnavigation und ‑auswahl wird ebenfalls unterstützt. HTML-Attribut <gmp-place-list selectable></gmp-place-list>

Methoden
addEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. addEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Die Groß-/Kleinschreibung muss beachtet werden. 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 Optionen Benutzerdefinierte Ereignisse unterstützen nur capture und passive. Rückgabewert:void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener.
configureFromSearchByTextRequest	configureFromSearchByTextRequest(request) Parameter: request:  SearchByTextRequest Die Anfrage, für die Ergebnisse gerendert werden sollen. Die Property fields des SearchByTextRequest ist nicht erforderlich. Rückgabewert:Promise<void> Ein Promise, das aufgelöst wird, sobald Ortsdaten geladen und gerendert wurden. Konfiguriert das Widget so, dass Suchergebnisse aus einer Places Text Search API-Anfrage gerendert werden.
configureFromSearchNearbyRequest	configureFromSearchNearbyRequest(request) Parameter: request:  SearchNearbyRequest Die Anfrage, für die Ergebnisse gerendert werden sollen. Die Property fields des SearchNearbyRequest ist nicht erforderlich. Rückgabewert:Promise<void> Ein Promise, das aufgelöst wird, sobald Ortsdaten geladen und gerendert wurden. Konfiguriert das Widget so, dass Suchergebnisse aus einer Places Nearby Search API-Anfrage gerendert werden.
removeEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. removeEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Typ des Ereignisses angibt, für das ein Event-Listener entfernt werden soll. listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Event-Ziel entfernt werden soll. options:  boolean|EventListenerOptions optional Optionen Rückgabewert:void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener.

Ereignisse
gmp-load	function(event) Argumente:  event:  Event Dieses Ereignis wird ausgelöst, wenn das Element geladen und sein Inhalt gerendert wird. Dieses Ereignis wird nicht weitergegeben.
gmp-placeselect	function(event) Argumente:  event:  PlaceListPlaceSelectEvent Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen Ort auswählt. Enthält ein Place-Objekt und den Index des ausgewählten Orts in der Liste.
gmp-requesterror	function(event) Argumente:  event:  Event 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.

PlaceListElementOptions Schnittstelle

google.maps.places.PlaceListElementOptions-Schnittstelle

Hinweis:Nur im v=alpha-Kanal verfügbar.

Optionen für PlaceListElement.

Attribute
selectable optional	Typ:boolean optional PlaceListElement.selectable ansehen

PlaceListPlaceSelectEvent-Klasse

google.maps.places.PlaceListPlaceSelectEvent Klasse

Hinweis:Nur im v=alpha-Kanal verfügbar.

Dieses Ereignis wird von PlaceListElement ausgegeben, wenn der Nutzer einen Ort auswählt.

Diese Klasse erweitert Event.

Zugriff durch Anrufen von const {PlaceListPlaceSelectEvent} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Attribute
index	Typ:number Der Listenindex des ausgewählten Orts.
place	Typ:Place Ein Place-Objekt mit der ID, dem Standort und dem Darstellungsbereich des ausgewählten Orts.

Autocomplete-Klasse

google.maps.places.Autocomplete Klasse

Ein Widget, das Ortsvorschläge basierend auf der Texteingabe eines Nutzers liefert. Es wird an ein Eingabeelement vom Typ text angehängt und überwacht dieses Feld auf Texteingaben. Die Liste der Vorschläge wird als Drop-down-Liste angezeigt und aktualisiert, sobald Text eingegeben wird.

Diese Klasse erweitert MVCObject.

Zugriff durch Anrufen von const {Autocomplete} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
Autocomplete	Autocomplete(inputField[, opts]) Parameter: inputField:  HTMLInputElement Das Textfeld <input>, an das die Autocomplete angehängt werden soll. opts:  AutocompleteOptions optional Optionen. Erstellt eine neue Instanz von Autocomplete, die mit den angegebenen Optionen an das angegebene Eingabefeld angehängt wird.

Methoden
getBounds	getBounds() Parameter:Keine Rückgabewert:LatLngBounds|undefined Die Bias-Grenzwerte. Gibt die Grenzen zurück, auf die Vorhersagen ausgerichtet sind.
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 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 die Details abgerufen wurden. Andernfalls wird ein Platzhalterobjekt vom Typ „Place“ zurückgegeben, wobei die name-Property auf den aktuellen Wert des Eingabefelds festgelegt ist.
setBounds	setBounds(bounds) Parameter: bounds:  LatLngBounds|LatLngBoundsLiteral optional Die Bias-Grenzwerte. Rückgabewert:Keiner Legt den bevorzugten Bereich fest, in dem Orts-Ergebnisse zurückgegeben werden sollen. Bei den Ergebnissen werden Orte in diesem Gebiet bevorzugt, es werden jedoch nicht nur Orte gefunden.
setComponentRestrictions	setComponentRestrictions(restrictions) Parameter: restrictions:  ComponentRestrictions optional Die zu verwendenden Einschränkungen. Rückgabewert:Keiner Legt die Einschränkungen für die Komponente fest. Mit Komponentenbeschränkungen werden Vorhersagen auf die übergeordnete Komponente beschränkt. Zum Beispiel das Land.
setFields	setFields(fields) Parameter: fields:  Array<string> optional Rückgabewert:Keiner Legt die Felder fest, die für den Ort in der Detailantwort enthalten sein sollen, wenn die Details erfolgreich abgerufen wurden. Eine Liste der Felder finden Sie unter PlaceResult.
setOptions	setOptions(options) Parameter: options:  AutocompleteOptions optional Rückgabewert:Keiner
setTypes	setTypes(types) Parameter: types:  Array<string> optional Die Arten von Vorhersagen, die berücksichtigt werden sollen. Rückgabewert:Keiner Legt die Arten von 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.
Geerbt:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Ereignisse

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 von der Steuerung vorgeschlagen wurde, und die Eingabetaste drückt oder eine Place Details-Anfrage fehlschlägt, enthält PlaceResult die Nutzereingabe in der Eigenschaft name, ohne dass andere Eigenschaften definiert sind.

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 werden soll.
componentRestrictions optional	Typ:ComponentRestrictions optional Die Einschränkungen für die Komponente. Mit Komponentenbeschränkungen werden Vorhersagen auf die übergeordnete Komponente beschränkt. Zum Beispiel das Land.
fields optional	Typ:Array<string> optional Felder, die in der Detailantwort für den Ort enthalten sein sollen, wenn die Details erfolgreich abgerufen wurden. Diese 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	Eingestellt:placeIdOnly wurde am 15. Januar 2019 eingestellt und wird am 15. Januar 2020 deaktiviert. Verwenden Sie stattdessen AutocompleteOptions.fields: fields: ['place_id', 'name', 'types']. Typ:boolean optional Gibt an, ob nur Orts-IDs abgerufen werden sollen. Das PlaceResult, das beim Auslösen des place_changed-Ereignisses verfügbar gemacht wird, enthält nur die Felder „place_id“, „types“ und „name“ mit den von Autocomplete zurückgegebenen „place_id“, „types“ und „description“. 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 beim Senden der Anfrage innerhalb der Grenzen des Autocomplete-Widgets befinden. Wenn Sie „strictBounds“ auf false (Standardeinstellung) festlegen, werden 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.

SearchBox-Klasse

google.maps.places.SearchBox Klasse

Ein Widget, das basierend auf der Texteingabe eines Nutzers Vorschläge für Suchanfragen liefert. Es wird an ein Eingabeelement vom Typ text angehängt und überwacht dieses Feld auf Texteingaben. Die Liste der Vorschläge wird als Drop-down-Liste angezeigt und aktualisiert, sobald Text eingegeben wird.

Diese Klasse erweitert MVCObject.

Zugriff durch Anrufen von const {SearchBox} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
SearchBox	SearchBox(inputField[, opts]) Parameter: inputField:  HTMLInputElement opts:  SearchBoxOptions optional Erstellt eine neue Instanz von SearchBox, die mit den angegebenen Optionen an das angegebene Eingabefeld 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 vom Nutzer ausgewählte Abfrage zurück, die mit dem places_changed-Ereignis verwendet werden soll.
setBounds	setBounds(bounds) Parameter: bounds:  LatLngBounds|LatLngBoundsLiteral optional Rückgabewert:Keiner Legt die Region fest, die für die Beeinflussung von Vorhersagen für Abfragen verwendet werden soll. Die Ergebnisse werden nur auf dieses Gebiet ausgerichtet und nicht vollständig darauf beschränkt.
Geerbt:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Ereignisse
places_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn der Nutzer eine Anfrage auswählt. Mit getPlaces können neue Orte abgerufen 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, in dem die Vorhersagen für die Anfrage bevorzugt werden sollen. Vorhersagen werden auf Abfragen ausgerichtet, die auf diese Grenzen abzielen, sind aber nicht auf sie beschränkt.