Klasse PlaceAutocompleteElement
google.maps.places.PlaceAutocompleteElement
Klasse
PlaceAutocompleteElement ist eine HTMLElement
-Unterklasse, die eine UI-Komponente für die Places Autocomplete API bereitstellt.
PlaceAutocompleteElement verwendet intern automatisch AutocompleteSessionToken
, um die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu gruppieren.
Der erste Aufruf von Place.fetchFields
für ein Place
, das von PlacePrediction.toPlace
zurückgegeben wird, enthält automatisch das Sitzungstoken, das zum Abrufen des PlacePrediction
verwendet wurde.
Weitere Informationen zur Funktionsweise von Sitzungen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-session-tokens.
Benutzerdefiniertes Element:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></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:
|
Attribute | |
---|---|
includedPrimaryTypes |
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
|
includedRegionCodes |
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
|
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
|
origin |
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
|
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
|
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
|
unitSystem |
Typ:
UnitSystem optional Das Einheitensystem, das zum Anzeigen von Entfernungen verwendet wird. Wenn nicht angegeben, wird das Einheitensystem durch „requestedRegion“ bestimmt.
HTML-Attribut
|
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(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
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:
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:
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. |
PlaceAutocompleteElementOptions Schnittstelle
google.maps.places.PlaceAutocompleteElementOptions
-Schnittstelle
Optionen zum Erstellen eines PlaceAutocompleteElement. Eine Beschreibung der einzelnen Attribute finden Sie im Attribut mit demselben Namen in der Klasse „PlaceAutocompleteElement“.
Attribute | |
---|---|
locationBias optional |
Typ:
LocationBias optional |
locationRestriction optional |
Typ:
LocationRestriction optional |
name optional |
Typ:
string optional |
requestedLanguage optional |
Typ:
string optional |
Klasse PlacePredictionSelectEvent
google.maps.places.PlacePredictionSelectEvent
Klasse
Dieses Ereignis wird erstellt, nachdem der Nutzer ein Vorschlagselement mit dem PlaceAutocompleteElement ausgewählt hat. Greifen Sie mit event.placePrediction
auf die Auswahl zu.
Konvertieren Sie „placePrediction“ in ein Place
, indem Sie PlacePrediction.toPlace
aufrufen.
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 Konvertieren Sie dies in ein Place , indem Sie PlacePrediction.toPlace aufrufen. |
PlaceAutocompleteRequestErrorEvent-Klasse
google.maps.places.PlaceAutocompleteRequestErrorEvent
Klasse
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.
Klasse PlaceContextualElement
google.maps.places.PlaceContextualElement
Klasse
Ein Widget, in dem mit dem Kontext-Token eine kontextbezogene Ansicht der Grounding-Antwort mit Google Maps angezeigt wird.
Benutzerdefiniertes Element:
<gmp-place-contextual context-token="string"></gmp-place-contextual>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceContextualElementOptions
.
Zugriff durch Anrufen von const {PlaceContextualElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Attribute | |
---|---|
contextToken |
Typ:
string optional Das Kontext-Token.
HTML-Attribut
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceContextualElementOptions Schnittstelle
google.maps.places.PlaceContextualElementOptions
-Schnittstelle
Optionen für PlaceContextualElement
.
Attribute | |
---|---|
contextToken optional |
Typ:
string optional Das Kontext-Token, das von der Antwort „Fundierung mit Google Maps“ bereitgestellt wird. |
PlaceContextualListConfigElement class
google.maps.places.PlaceContextualListConfigElement
Klasse
Ein HTML-Element, mit dem Optionen für die Listenansicht des kontextbezogenen Elements für Orte konfiguriert werden.
Benutzerdefiniertes Element:
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceContextualListConfigElementOptions
.
Zugriff durch Anrufen von const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Attribute | |
---|---|
layout |
Typ:
PlaceContextualListLayout optional Das Layout.
HTML-Attribut
|
mapHidden |
Typ:
boolean optional Gibt an, ob die Karte ausgeblendet ist.
HTML-Attribut
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceContextualListConfigElementOptions-Schnittstelle
google.maps.places.PlaceContextualListConfigElementOptions
-Schnittstelle
Optionen für PlaceContextualListConfigElement.
Attribute | |
---|---|
layout optional |
Typ:
PlaceContextualListLayout optional Das Layout. Standardwert ist PlaceContextualListLayout.VERTICAL . |
mapHidden optional |
Typ:
boolean optional Gibt an, ob die Karte ausgeblendet ist. Standardmäßig wird die Karte angezeigt (Wert „false“). |
PlaceContextualListLayout-Konstanten
google.maps.places.PlaceContextualListLayout
Konstanten
Die Liste der Layouts, die das kontextbezogene Element für Orte für die Listenansicht unterstützt.
Zugriff durch Anrufen von const {PlaceContextualListLayout} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
COMPACT |
Kompaktes Listenlayout: Listenelemente werden als Links in einer einzelnen Zeile gerendert. Überläufe werden in einer Drop-down-Liste angezeigt. |
VERTICAL |
Vertikales Listenlayout: Listenelemente werden als Karten in einer vertikalen Liste gerendert. |
PlaceDetailsElement-Klasse
google.maps.places.PlaceDetailsElement
Klasse
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:
|
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
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
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:
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:
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(type, listener[, options]) Parameter:
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:
Dieses Ereignis wird ausgelöst, wenn das Element geladen und sein Inhalt gerendert wird. Dieses Ereignis wird nicht weitergegeben. |
gmp-requesterror |
function(event) Argumente:
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
Optionen für PlaceDetailsElement
.
Attribute | |
---|---|
size optional |
Typ:
PlaceDetailsSize optional PlaceDetailsElement.size ansehen |
PlaceDetailsSize-Konstanten
google.maps.places.PlaceDetailsSize
Konstanten
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. |
PlaceDetailsCompactElement-Klasse
google.maps.places.PlaceDetailsCompactElement
Klasse
Zeigt Details zu einem Ort in einem kompakten Layout an. Hängen Sie ein PlaceDetailsPlaceRequestElement
an, um den Ort anzugeben, der gerendert werden soll. Hängen Sie ein PlaceContentConfigElement
, PlaceStandardContentElement
oder PlaceAllContentElement
an, um anzugeben, welche Inhalte gerendert werden sollen.
Wenn Sie dieses Element verwenden möchten, aktivieren Sie die Places UI Kit API für Ihr Projekt in der Google Cloud Console.
Benutzerdefiniertes Element:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceDetailsCompactElementOptions
.
Zugriff durch Anrufen von const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceDetailsCompactElement |
PlaceDetailsCompactElement([options]) Parameter:
|
Attribute | |
---|---|
orientation |
Typ:
PlaceDetailsOrientation optional Standard:
PlaceDetailsOrientation.VERTICAL Die Ausrichtungsvariante (vertikal oder horizontal) des Elements.
HTML-Attribut
|
place |
Typ:
Place optional Schreibgeschützt. Ortsbezogenes Objekt mit der ID, dem Standort und dem Darstellungsbereich des aktuell gerenderten Orts. |
truncationPreferred |
Typ:
boolean Standard:
false Wenn „true“ festgelegt ist, werden der Ortsname und die Adresse so gekürzt, dass sie in eine Zeile passen, anstatt umgebrochen zu werden.
HTML-Attribut
|
CSS-Properties | |
---|---|
--gmp-mat-color-info |
Farbe von UI-Elementen mit informativen Inhalten. Wird für das Rollstuhlsymbol verwendet. |
--gmp-mat-color-negative |
Farbe von UI-Elementen mit negativer Stimmung. Wird für den Text „Geschlossen“ im Status „Jetzt geöffnet“ verwendet. |
--gmp-mat-color-neutral-container |
Containerfarbe für neutral gefüllte UI-Elemente. Wird für Bildplatzhalter verwendet. |
--gmp-mat-color-on-secondary-container |
Farbe von Text und Symbolen im Verhältnis zur sekundären Containerfarbe. Wird für Text und Symbole auf der Schaltfläche „In Maps öffnen“ verwendet. |
--gmp-mat-color-on-surface |
Farbe für Text und Symbole vor einer beliebigen Oberflächenfarbe. Wird für normalen Text verwendet. |
--gmp-mat-color-on-surface-variant |
Farbe mit geringerer Gewichtung für Text und Symbole auf einer beliebigen Oberflächenfarbe. Wird für weniger betonte Texte verwendet. |
--gmp-mat-color-outline-decorative |
Konturfarbe nicht interaktiver Elemente. Wird für den Rahmen des Elements verwendet. |
--gmp-mat-color-positive |
Farbe von UI-Elementen mit positiver Stimmung. Wird für den Text „Geöffnet“ im Status „Jetzt geöffnet“ verwendet. |
--gmp-mat-color-primary |
Farbe von interaktivem Text und Symbolen im Verhältnis zur Oberflächenfarbe. Wird für die Anzahl der Rezensionen und Links im Attributionsdialogfeld verwendet. |
--gmp-mat-color-secondary-container |
Weniger auffällige Füllfarbe für untergeordnete Komponenten wie tonale Schaltflächen. Wird für den Hintergrund der Schaltfläche „In Maps öffnen“ verwendet. |
--gmp-mat-color-surface |
Farbe für Hintergründe. Wird für die Hintergründe des Elements und des Attributionsdialogfelds verwendet. |
--gmp-mat-font-body-medium |
Wird für den Haupttext im Attributionsdialogfeld verwendet. |
--gmp-mat-font-body-small |
Wird für die Adresse, Bewertung, Art, den Preis und den Status „Jetzt geöffnet“ des Orts verwendet. |
--gmp-mat-font-family |
Die für den gesamten Text verwendete Basisschriftfamilie. |
--gmp-mat-font-headline-medium |
Wird für Überschriften im Attributionsdialogfeld verwendet. |
--gmp-mat-font-label-large |
Wird für die Schaltfläche „In Maps öffnen“ und Links im Attributionsdialogfeld verwendet. |
--gmp-mat-font-title-small |
Wird für den Ortsnamen verwendet. |
background-color |
Überschreibt die Hintergrundfarbe des Elements. |
border |
Überschreibt den Rahmen des Elements. |
border-radius |
Überschreibt den Grenzradius des Elements. |
color-scheme |
Gibt an, in welchem Farbschema dieses Element gerendert werden kann. Weitere Informationen finden Sie in der color-scheme Dokumentation. Die Standardeinstellung ist color-scheme: light dark . |
font-size |
Skaliert den gesamten Text und alle Symbole im Element, die intern in „ems“ definiert sind. Die Standardeinstellung ist 16px . |
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
Ereignisse | |
---|---|
gmp-error |
function(event) Argumente:
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-load |
function(event) Argumente:
Dieses Ereignis wird ausgelöst, wenn das Element geladen und sein Inhalt gerendert wird. Dieses Ereignis wird nicht weitergegeben. |
PlaceDetailsCompactElementOptions-Schnittstelle
google.maps.places.PlaceDetailsCompactElementOptions
-Schnittstelle
Optionen für PlaceDetailsCompactElement
.
Attribute | |
---|---|
orientation optional |
Typ:
PlaceDetailsOrientation optional |
truncationPreferred optional |
Typ:
boolean optional |
PlaceDetailsOrientation-Konstanten
google.maps.places.PlaceDetailsOrientation
Konstanten
Ausrichtungsvarianten für PlaceDetailsCompactElement
.
Zugriff durch Anrufen von const {PlaceDetailsOrientation} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
HORIZONTAL |
Horizontale Ausrichtung. |
VERTICAL |
Vertikale Ausrichtung. |
PlaceDetailsPlaceRequestElement-Klasse
google.maps.places.PlaceDetailsPlaceRequestElement
Klasse
Konfiguriert ein kompaktes Element für Ortsdetails, um Daten basierend auf einem Ortsobjekt, einer ID oder einem Ressourcennamen zu laden. Hängen Sie dieses Element als untergeordnetes Element an ein PlaceDetailsCompactElement
an, um Daten für den angegebenen Ort zu laden.
Benutzerdefiniertes Element:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceDetailsPlaceRequestElementOptions
.
Zugriff durch Anrufen von const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceDetailsPlaceRequestElement |
PlaceDetailsPlaceRequestElement([options]) Parameter:
|
Attribute | |
---|---|
place |
Typ:
Place optional Das Ortsobjekt, die ID oder der Ressourcenname, für die Details im kompakten Element „Ortsdetails“ gerendert werden sollen. Dieses Attribut entspricht dem Attribut als Ressourcenname.
HTML-Attribut
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceDetailsPlaceRequestElementOptions Schnittstelle
google.maps.places.PlaceDetailsPlaceRequestElementOptions
-Schnittstelle
Optionen für PlaceDetailsPlaceRequestElement
.
Attribute | |
---|---|
place optional |
Typ:
Place|string optional |
PlaceContentConfigElement class
google.maps.places.PlaceContentConfigElement
Klasse
Konfiguriert den Inhalt, der in einem kompakten Element für Ortsdetails angezeigt werden soll. Hängen Sie dieses Element als untergeordnetes Element eines PlaceDetailsCompactElement
an, um es zu verwenden. Hängen Sie eines der folgenden Elemente an PlaceContentConfigElement
an, um den entsprechenden Inhalt anzuzeigen:
PlaceMediaElement
, PlaceAddressElement
, PlaceRatingElement
, PlaceTypeElement
, PlacePriceElement
, PlaceAccessibleEntranceIconElement
, PlaceOpenNowStatusElement
, PlaceAttributionElement
Die Reihenfolge der untergeordneten Elemente spielt keine Rolle. Das Element rendert Inhalte in einer Standardreihenfolge, die nicht angepasst werden kann.
Benutzerdefiniertes Element:
<gmp-place-content-config></gmp-place-content-config>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceContentConfigElementOptions
.
Zugriff durch Anrufen von const {PlaceContentConfigElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceContentConfigElement |
PlaceContentConfigElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceContentConfigElementOptions Schnittstelle
google.maps.places.PlaceContentConfigElementOptions
-Schnittstelle
Optionen für PlaceContentConfigElement
.
Klasse PlaceMediaElement
google.maps.places.PlaceMediaElement
Klasse
Konfiguriert ein kompaktes Element mit Ortsdetails, um Medien wie Fotos eines Orts anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-media lightbox-preferred></gmp-place-media>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceMediaElementOptions
.
Zugriff durch Anrufen von const {PlaceMediaElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceMediaElement |
PlaceMediaElement([options]) Parameter:
|
Attribute | |
---|---|
lightboxPreferred |
Typ:
boolean optional Standard:
false Gibt an, ob die Media-Lightbox aktiviert oder deaktiviert werden soll, wenn beide Optionen unterstützt werden.
HTML-Attribut
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceMediaElementOptions Schnittstelle
google.maps.places.PlaceMediaElementOptions
-Schnittstelle
Optionen für PlaceMediaElement
.
Attribute | |
---|---|
lightboxPreferred optional |
Typ:
boolean optional PlaceMediaElement.lightboxPreferred ansehen. |
Klasse PlaceAddressElement
google.maps.places.PlaceAddressElement
Klasse
Konfiguriert ein kompaktes Element für Ortsdetails, um die Adresse eines Orts anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-address></gmp-place-address>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceAddressElementOptions
.
Zugriff durch Anrufen von const {PlaceAddressElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceAddressElement |
PlaceAddressElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceAddressElementOptions Schnittstelle
google.maps.places.PlaceAddressElementOptions
-Schnittstelle
Optionen für PlaceAddressElement
.
Klasse PlaceRatingElement
google.maps.places.PlaceRatingElement
Klasse
Konfiguriert ein kompaktes Element mit Ortsdetails, um die Bewertung eines Orts anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-rating></gmp-place-rating>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceRatingElementOptions
.
Zugriff durch Anrufen von const {PlaceRatingElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceRatingElement |
PlaceRatingElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceRatingElementOptions Schnittstelle
google.maps.places.PlaceRatingElementOptions
-Schnittstelle
Optionen für PlaceRatingElement
.
Klasse PlaceTypeElement
google.maps.places.PlaceTypeElement
Klasse
Konfiguriert ein kompaktes Element für Ortsdetails, um den Typ eines Orts anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-type></gmp-place-type>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceTypeElementOptions
.
Zugriff durch Anrufen von const {PlaceTypeElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceTypeElement |
PlaceTypeElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceTypeElementOptions-Schnittstelle
google.maps.places.PlaceTypeElementOptions
-Schnittstelle
Optionen für PlaceTypeElement
.
PlacePriceElement-Klasse
google.maps.places.PlacePriceElement
Klasse
Konfiguriert ein kompaktes Element mit Ortsdetails, um das Preisniveau oder die Preisspanne eines Orts anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-price></gmp-place-price>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlacePriceElementOptions
.
Zugriff durch Anrufen von const {PlacePriceElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlacePriceElement |
PlacePriceElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlacePriceElementOptions-Schnittstelle
google.maps.places.PlacePriceElementOptions
-Schnittstelle
Optionen für PlacePriceElement
.
PlaceAccessibleEntranceIconElement-Klasse
google.maps.places.PlaceAccessibleEntranceIconElement
Klasse
Konfiguriert ein kompaktes Element für Ortsdetails so, dass ein Rollstuhlsymbol angezeigt wird, wenn der Ort einen barrierefreien Eingang hat. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceAccessibleEntranceIconElementOptions
.
Zugriff durch Anrufen von const {PlaceAccessibleEntranceIconElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceAccessibleEntranceIconElement |
PlaceAccessibleEntranceIconElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceAccessibleEntranceIconElementOptions Schnittstelle
google.maps.places.PlaceAccessibleEntranceIconElementOptions
-Schnittstelle
Optionen für PlaceAccessibleEntranceIconElement
.
PlaceOpenNowStatusElement-Klasse
google.maps.places.PlaceOpenNowStatusElement
Klasse
Konfiguriert ein kompaktes „Place Details“-Element, um den aktuellen Status (geöffnet oder geschlossen) eines Orts anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-open-now-status></gmp-place-open-now-status>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceOpenNowStatusElementOptions
.
Zugriff durch Anrufen von const {PlaceOpenNowStatusElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceOpenNowStatusElement |
PlaceOpenNowStatusElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceOpenNowStatusElementOptions Schnittstelle
google.maps.places.PlaceOpenNowStatusElementOptions
-Schnittstelle
Optionen für PlaceOpenNowStatusElement
.
Klasse PlaceAttributionElement
google.maps.places.PlaceAttributionElement
Klasse
Ermöglicht die Anpassung des Google Maps-Quellennachweises in einem kompakten Element mit Ortsdetails. Hängen Sie dieses Element als untergeordnetes Element eines PlaceContentConfigElement
an, um es zu verwenden. Wenn dieses Element weggelassen wird, wird die Quellenangabe weiterhin mit Standardfarben angezeigt.
Benutzerdefiniertes Element:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceAttributionElementOptions
.
Zugriff durch Anrufen von const {PlaceAttributionElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceAttributionElement |
PlaceAttributionElement([options]) Parameter:
|
Attribute | |
---|---|
darkSchemeColor |
Typ:
AttributionColor optional Standard:
AttributionColor.WHITE Die Farbe des Google Maps-Quellenverweises im dunklen Modus.
HTML-Attribut
|
lightSchemeColor |
Typ:
AttributionColor optional Standard:
AttributionColor.GRAY Die Farbe des Google Maps-Quellenverweises im hellen Modus.
HTML-Attribut
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceAttributionElementOptions Schnittstelle
google.maps.places.PlaceAttributionElementOptions
-Schnittstelle
Optionen für PlaceAttributionElement
.
Attribute | |
---|---|
darkSchemeColor optional |
Typ:
AttributionColor optional |
lightSchemeColor optional |
Typ:
AttributionColor optional |
AttributionColor-Konstanten
google.maps.places.AttributionColor
Konstanten
Farboptionen für den Google Maps-Quellenangabetext. Die Quellenangabe kann mit jeder dieser Farben angepasst werden.
Zugriff durch Anrufen von const {AttributionColor} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
BLACK |
Schwarzer Quellenangabetext. |
GRAY |
Grauer Quellenangabetext |
WHITE |
Weiße Quellenangabe. |
Klasse PlaceAllContentElement
google.maps.places.PlaceAllContentElement
Klasse
Konfiguriert ein kompaktes Element für Ortsdetails, um alle verfügbaren Inhalte anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceDetailsCompactElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-all-content></gmp-place-all-content>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceAllContentElementOptions
.
Zugriff durch Anrufen von const {PlaceAllContentElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceAllContentElement |
PlaceAllContentElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceAllContentElementOptions-Schnittstelle
google.maps.places.PlaceAllContentElementOptions
-Schnittstelle
Optionen für PlaceAllContentElement
.
PlaceStandardContentElement-Klasse
google.maps.places.PlaceStandardContentElement
Klasse
Konfiguriert ein kompaktes Element mit Ortsdetails, um eine Standardgruppe von Inhalten (Media, Bewertung, Typ, Preis, Symbol für barrierefreien Eingang und Status „Jetzt geöffnet“) anzuzeigen. Hängen Sie dieses Element als untergeordnetes Element eines PlaceDetailsCompactElement
an, um es zu verwenden.
Benutzerdefiniertes Element:
<gmp-place-standard-content></gmp-place-standard-content>
Diese Klasse erweitert HTMLElement
.
Diese Klasse implementiert PlaceStandardContentElementOptions
.
Zugriff durch Anrufen von const {PlaceStandardContentElement} = await google.maps.importLibrary("places")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
PlaceStandardContentElement |
PlaceStandardContentElement([options]) Parameter:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener. |
PlaceStandardContentElementOptions-Schnittstelle
google.maps.places.PlaceStandardContentElementOptions
-Schnittstelle
Optionen für PlaceStandardContentElement
.
Klasse PlaceListElement
google.maps.places.PlaceListElement
Klasse
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:
|
Attribute | |
---|---|
places |
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
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
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:
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:
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(type, listener[, options]) Parameter:
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:
Dieses Ereignis wird ausgelöst, wenn das Element geladen und sein Inhalt gerendert wird. Dieses Ereignis wird nicht weitergegeben. |
gmp-placeselect |
function(event) Argumente:
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:
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
Optionen für PlaceListElement
.
Attribute | |
---|---|
selectable optional |
Typ:
boolean optional PlaceListElement.selectable ansehen |
PlaceListPlaceSelectEvent-Klasse
google.maps.places.PlaceListPlaceSelectEvent
Klasse
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:
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:
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:
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:
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:
Rückgabewert:Keiner
|
setTypes |
setTypes(types) Parameter:
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'] . |
|
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:
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:
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. |