Places Widgets

PlaceAutocompleteElement-Klasse

Klasse google.maps.places.PlaceAutocompleteElement

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

AutocompleteSessionTokens werden von „PlaceAutocompleteElement“ automatisch intern verwendet, um die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu gruppieren.

Beim ersten Aufruf von Place.fetchFields für ein Place, das von PlacePrediction.toPlace zurückgegeben wurde, wird automatisch das Sitzungstoken verwendet, das zum Abrufen des PlacePrediction verwendet wurde.

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

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parameter: 
includedPrimaryTypes
Typ: Array<string> optional
Eingeschlossener primärer Ortstyp (z. B. „restaurant“ oder „gas_station“).

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
Typ: Array<string> optional
Nur Ergebnisse in den angegebenen Regionen einschließen, angegeben als bis zu 15 zweistellige CLDR-Regionscodes. Ein leerer Satz 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, um die Suchergebnisse einzuschränken.
name
Typ: string optional
Der Name, der für das Eingabeelement verwendet werden soll. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Folgt demselben Verhalten wie das Attribut „name“ für Eingaben. Dieser Name wird verwendet, wenn ein Formular gesendet wird. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
HTML-Attribut:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
Der Ursprung, von dem aus die Entfernung berechnet werden soll. Wenn keine Angabe erfolgt, wird die Entfernung nicht berechnet. Die Höhe wird, falls angegeben, nicht in die Berechnung einbezogen.
HTML-Attribut:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
placeholder
Typ: string
Der Platzhaltertext, der im Eingabeelement angezeigt werden soll.
requestedLanguage
Typ: string optional
Eine Sprachkennung 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, Vorschläge sind jedoch 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 Formatierung und Filterung der Ergebnisse verwendet wird. Die Vorschläge werden nicht auf dieses Land beschränkt. Für den Regionscode ist ein zweistelliger Wert für die ccTLD („Top-Level-Domain“) 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 gesehen für das Vereinigte Königreich Großbritannien und Nordirland).
HTML-Attribut:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
Typ: UnitSystem optional
Das Einheitensystem, das für die Anzeige von Entfernungen verwendet wird. Wenn nicht angegeben, wird das Einheitensystem durch „requestedRegion“ bestimmt.
HTML-Attribut:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
value
Typ: string
Der Wert des Eingabeelements.
prediction-item-icon
Dieser Slot akzeptiert genau ein <template>-Element, das als Symbol neben dem Vervollständigungselement gerendert wird.
input
Das Eingabeelement für das Autocomplete-Element.
prediction-item
Ein Element im Drop-down-Menü der Vorschläge, 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 Vorschlagselements, der den Haupttext des Vorschlags darstellt. Bei geografischen Standorten enthält es einen Ortsnamen wie "Sydney" oder einen Straßennamen und eine Hausnummer wie "Königsstraße 10". Standardmäßig ist der prediction-item-main-text schwarz. Wenn zusätzlicher Text in „prediction-item“ 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 auswählt. Hinweis: Die ausgewählten Elemente sind sowohl von diesen Teilestilen als auch von den Teilestilen 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.
background-color
Überschreibt die Hintergrundfarbe des Elements.
border
Überschreibt den Rahmen des Elements.
border-radius
Überschreibt den Rahmenradius des Elements.
color
Überschreibt die Schriftart 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
Überschreibt die Schriftart des Elements.
font-family
Überschreibt die Schriftart des Elements.
font-size
Überschreibt die Schriftart des Elements.
font-style
Überschreibt die Schriftart des Elements.
font-weight
Überschreibt die Schriftart des Elements.
line-height
Überschreibt die Schriftart des Elements.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.
gmp-error
function(errorEvent)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. falscher API-Schlüssel). 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.

Schnittstelle PlaceAutocompleteElementOptions

Schnittstelle google.maps.places.PlaceAutocompleteElementOptions

Optionen zum Erstellen eines PlaceAutocompleteElement. Eine Beschreibung der einzelnen Attribute finden Sie unter dem gleichnamigen Attribut in der Klasse „PlaceAutocompleteElement“.

includedPrimaryTypes optional
Typ: Array<string> optional
includedRegionCodes optional
Typ: Array<string> optional
locationBias optional
Typ: LocationBias optional
locationRestriction optional
Typ: LocationRestriction optional
name optional
Typ: string optional
origin optional
requestedLanguage optional
Typ: string optional
requestedRegion optional
Typ: string optional
unitSystem optional
Typ: UnitSystem optional
value optional
Typ: string optional
Der Wert des Eingabeelements.

PlacePredictionSelectEvent-Klasse

Klasse google.maps.places.PlacePredictionSelectEvent

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

Wandeln Sie „placePrediction“ in ein Place um, indem Sie PlacePrediction.toPlace aufrufen.

Diese Klasse erweitert Event.

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

placePrediction
Konvertieren Sie dies in ein Place, indem Sie PlacePrediction.toPlace aufrufen.

BasicPlaceAutocompleteElement-Klasse

Klasse google.maps.places.BasicPlaceAutocompleteElement

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

Benutzerdefiniertes Element:
<gmp-basic-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-basic-place-autocomplete>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert BasicPlaceAutocompleteElementOptions.

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

BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement(options)
Parameter: 
includedPrimaryTypes
Typ: Array<string> optional
Eingeschlossener primärer Ortstyp (z. B. „restaurant“ oder „gas_station“).

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-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
Typ: Array<string> optional
Nur Ergebnisse in den angegebenen Regionen einschließen, angegeben als bis zu 15 zweistellige CLDR-Regionscodes. Ein leerer Satz schränkt die Ergebnisse nicht ein. Wenn sowohl locationRestriction als auch includedRegionCodes festgelegt sind, befinden sich die Ergebnisse im Schnittbereich.
HTML-Attribut:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-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, um die Suchergebnisse einzuschränken.
name
Typ: string optional
Der Name, der für das Eingabeelement verwendet werden soll. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Folgt demselben Verhalten wie das Attribut „name“ für Eingaben. Dieser Name wird verwendet, wenn ein Formular gesendet wird. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
HTML-Attribut:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
Der Ursprung, von dem aus die Entfernung berechnet werden soll. Wenn keine Angabe erfolgt, wird die Entfernung nicht berechnet. Die Höhe wird, falls angegeben, nicht in die Berechnung einbezogen.
HTML-Attribut:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
Typ: string optional
Eine Sprachkennung 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, Vorschläge sind jedoch nicht auf diese Sprache beschränkt. Hier finden Sie eine Liste der unterstützten Sprachen.
HTML-Attribut:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
Typ: string optional
Ein Regionscode, der für die Formatierung und Filterung der Ergebnisse verwendet wird. Die Vorschläge werden nicht auf dieses Land beschränkt. Für den Regionscode ist ein zweistelliger Wert für die ccTLD („Top-Level-Domain“) 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 gesehen für das Vereinigte Königreich Großbritannien und Nordirland).
HTML-Attribut:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
Typ: UnitSystem optional
Das Einheitensystem, das für die Anzeige von Entfernungen verwendet wird. Wenn nicht angegeben, wird das Einheitensystem durch „requestedRegion“ bestimmt.
HTML-Attribut:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
Dieser Slot akzeptiert genau ein <template>-Element, das als Symbol neben dem Vervollständigungselement gerendert wird.
input
Das Eingabeelement für das Autocomplete-Element.
prediction-item
Ein Element im Drop-down-Menü der Vorschläge, 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 Vorschlagselements, der den Haupttext des Vorschlags darstellt. Bei geografischen Standorten enthält es einen Ortsnamen wie "Sydney" oder einen Straßennamen und eine Hausnummer wie "Königsstraße 10". Standardmäßig ist der prediction-item-main-text schwarz. Wenn zusätzlicher Text in „prediction-item“ 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 auswählt. Hinweis: Die ausgewählten Elemente sind sowohl von diesen Teilestilen als auch von den Teilestilen 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.
background-color
Überschreibt die Hintergrundfarbe des Elements.
border
Überschreibt den Rahmen des Elements.
border-radius
Überschreibt den Rahmenradius des Elements.
color
Überschreibt die Schriftart 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
Überschreibt die Schriftart des Elements.
font-family
Überschreibt die Schriftart des Elements.
font-size
Überschreibt die Schriftart des Elements.
font-style
Überschreibt die Schriftart des Elements.
font-weight
Überschreibt die Schriftart des Elements.
line-height
Überschreibt die Schriftart des Elements.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.
gmp-error
function(errorEvent)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. falscher API-Schlüssel). Dieses Ereignis wird nicht weitergegeben.
gmp-select
function(placeSelectEvent)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen Ortsvorschlag auswählt. Enthält ein Place-Objekt.

BasicPlaceAutocompleteElementOptions-Schnittstelle

Schnittstelle google.maps.places.BasicPlaceAutocompleteElementOptions

Optionen zum Erstellen eines BasicPlaceAutocompleteElement.

includedPrimaryTypes optional
Typ: Array<string> optional
includedRegionCodes optional
Typ: Array<string> optional
locationBias optional
Typ: LocationBias optional
locationRestriction optional
Typ: LocationRestriction optional
name optional
Typ: string optional
origin optional
requestedLanguage optional
Typ: string optional
requestedRegion optional
Typ: string optional
unitSystem optional
Typ: UnitSystem optional

Klasse PlaceDetailsElement

Klasse google.maps.places.PlaceDetailsElement

Zeigt Details zu einem Ort in einem vollständigen Layout an. Hängen Sie entweder PlaceDetailsPlaceRequestElement oder PlaceDetailsLocationRequestElement an, um den Ort anzugeben, der gerendert werden soll. Hängen Sie PlaceContentConfigElement, PlaceStandardContentElement oder PlaceAllContentElement an, um anzugeben, welche Inhalte gerendert werden sollen.

Beispiel:

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details>

Wenn Sie dieses Element 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></gmp-place-details>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceDetailsElementOptions.

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

PlaceDetailsElement
PlaceDetailsElement([options])
Parameter: 
place
Typ: Place optional
Schreibgeschützt. Place-Objekt mit der ID, dem Standort und dem Darstellungsbereich des aktuell gerenderten Orts.
--gmp-button-border-color
Rahmenfarbe der Schaltfläche „In Maps öffnen“.
--gmp-button-border-radius
Rahmenradius des Buttons „In Maps öffnen“.
--gmp-button-border-width
Rahmenbreite der Schaltfläche „In Maps öffnen“.
--gmp-collage-border-radius-outer
Rahmenradius der äußeren Ecken der Mediencollage.
--gmp-dialog-border-radius
Rahmenradius des Offenlegungsdialogs von Google Maps.
--gmp-mat-color-disabled-surface
Oberflächenfarbe, die deaktivierte Zustände oder Nichtvorhandensein vermitteln soll. Wird für leere Rezensionssterne verwendet.
--gmp-mat-color-info
Farbe von UI-Elementen mit informativer Bedeutung. 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 neutrale gefüllte UI-Elemente. Wird für Bildplatzhalter und das Badge für das Veröffentlichungsdatum der Rezension verwendet.
--gmp-mat-color-on-neutral-container
Farbe von Text und Symbolen im Vergleich zur neutralen Containerfarbe. Wird für das Badge mit dem Veröffentlichungsdatum der Rezension und das Badge für die Verfügbarkeit von Ladestationen für Elektrofahrzeuge verwendet, wenn diese nicht verfügbar sind.
--gmp-mat-color-on-positive-container
Farbe von Texten und Symbolen vor der positiven Containerfarbe. Wird für das Badge zur Verfügbarkeit von Ladestationen für Elektrofahrzeuge verwendet, sofern verfügbar.
--gmp-mat-color-on-secondary-container
Farbe von Text und Symbolen im Vergleich zur Farbe des sekundären Containers. 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 Betonung für Text und Symbole vor einer beliebigen Oberflächenfarbe. Wird für weniger hervorgehobenen Text 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-positive-container
Containerfarbe für UI-Elemente, die eine positive Stimmung vermitteln. Wird für das Badge zur Verfügbarkeit von Ladestationen für Elektrofahrzeuge verwendet, sofern verfügbar.
--gmp-mat-color-primary
Farbe von interaktivem Text und Symbolen im Vergleich zur Oberflächenfarbe. Wird für die Anzahl der Rezensionen, Links im Dialogfeld für Offenlegungen in Google Maps, Website-Links, Symbole auf dem Tab „Übersicht“ und (beim Bewegen des Mauszeigers/Fokus/Textfarbe) für Titel in der Tableiste verwendet.
--gmp-mat-color-secondary-container
Weniger auffällige Füllfarbe im Vergleich zur Oberfläche, für zurückhaltende 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 den Hintergrund des Elements und des Dialogfelds mit den Google Maps-Offenlegungen verwendet.
--gmp-mat-font-body-medium
Wird für die Adresse, die Bewertung, den Typ, den Preis, den Status „Jetzt geöffnet“, die Öffnungszeiten, die Rezension, die Telefonnummer, die Website, den Plus Code, die wichtigsten Funktionen und den Text im Dialogfeld für die Offenlegung von Google Maps verwendet.
--gmp-mat-font-body-small
Wird für den Text in der Funktionsliste auf dem Tab „Info“ verwendet.
--gmp-mat-font-display-small
Wird für den Ortsnamen und den Text für jede Überschrift auf dem Tab „Info“ verwendet.
--gmp-mat-font-family
Basisschriftfamilie, die für den gesamten Text verwendet wird.
--gmp-mat-font-headline-medium
Wird für den Überschriftentext im Dialogfeld für die Offenlegung von Google Maps verwendet.
--gmp-mat-font-label-large
Wird für die Tabtitel, die Schaltfläche „In Maps öffnen“, den Text der Quellenangabe für Rezensenten in der Fotogalerie, den Text der Quellenangabe für Rezensenten im Bereich „Rezensionen“ und Links im Dialogfeld für Google Maps-Offenlegungen verwendet.
--gmp-mat-font-label-medium
Wird für das Badge mit der Anzahl der Fotos und das Badge mit dem Veröffentlichungsdatum der Rezension verwendet.
--gmp-mat-font-title-small
Wird für den Titel der einzelnen Abschnitte auf dem Tab „Info“ verwendet.
--gmp-mat-spacing-extra-large
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-extra-small
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-large
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-medium
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-small
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-two-extra-large
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-star-rating-color
Farbe der ausgefüllten Sterne in der Bewertung.
background-color
Überschreibt die Hintergrundfarbe des Elements.
border
Überschreibt den Rahmen des Elements.
border-radius
Überschreibt den Rahmenradius 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.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.
gmp-error
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. falscher API-Schlüssel). Dieses Ereignis wird nicht weitergegeben.
gmp-load
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn das Element geladen wird und seinen Inhalt rendert. Dieses Ereignis wird nicht weitergegeben.

Schnittstelle PlaceDetailsElementOptions

Schnittstelle google.maps.places.PlaceDetailsElementOptions

Optionen für PlaceDetailsElement.

Klasse PlaceDetailsCompactElement

Klasse google.maps.places.PlaceDetailsCompactElement

Zeigt Details zu einem Ort in einem kompakten Layout an. Hängen Sie PlaceDetailsPlaceRequestElement oder PlaceDetailsLocationRequestElement an, um den Ort anzugeben, der gerendert werden soll. Hängen Sie PlaceContentConfigElement, PlaceStandardContentElement oder PlaceAllContentElement an, um anzugeben, welche Inhalte gerendert werden sollen.

Beispiel:

 <gmp-place-details-compact>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details-compact>

Wenn Sie dieses Element 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-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceDetailsCompactElementOptions.

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

PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Parameter: 
orientation
Standard: PlaceDetailsOrientation.VERTICAL
Die Ausrichtungsvariante (vertikal oder horizontal) des Elements.
HTML-Attribut:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Typ: Place optional
Schreibgeschützt. Place-Objekt mit der ID, dem Standort und dem Darstellungsbereich des aktuell gerenderten Orts.
truncationPreferred
Typ: boolean
Standard: false
Wenn „true“, werden der Name und die Adresse des Ortes gekürzt, damit sie in eine Zeile passen, anstatt umgebrochen zu werden.
HTML-Attribut:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
Rahmenfarbe der Schaltfläche „In Maps öffnen“.
--gmp-button-border-radius
Rahmenradius des Buttons „In Maps öffnen“.
--gmp-button-border-width
Rahmenbreite der Schaltfläche „In Maps öffnen“.
--gmp-dialog-border-radius
Rahmenradius des Offenlegungsdialogs von Google Maps.
--gmp-mat-color-info
Farbe von UI-Elementen mit informativer Bedeutung. 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 neutrale gefüllte UI-Elemente. Wird für Bildplatzhalter verwendet.
--gmp-mat-color-on-secondary-container
Farbe von Text und Symbolen im Vergleich zur Farbe des sekundären Containers. 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 Betonung für Text und Symbole vor einer beliebigen Oberflächenfarbe. Wird für weniger hervorgehobenen Text 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 Vergleich zur Oberflächenfarbe. Wird für die Anzahl der Rezensionen sowie für Links im Dialogfeld für Offenlegungen in Google Maps verwendet.
--gmp-mat-color-secondary-container
Weniger auffällige Füllfarbe im Vergleich zur Oberfläche, für zurückhaltende 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 den Hintergrund des Elements und des Dialogfelds mit den Google Maps-Offenlegungen verwendet.
--gmp-mat-font-body-medium
Wird für den Text im Dialogfeld für die Offenlegung von Google Maps verwendet.
--gmp-mat-font-body-small
Wird für die Adresse, die Bewertung, den Typ, den Preis und den Status „Jetzt geöffnet“ des Ortes verwendet.
--gmp-mat-font-family
Basisschriftfamilie, die für den gesamten Text verwendet wird.
--gmp-mat-font-headline-medium
Wird für den Überschriftentext im Dialogfeld für die Offenlegung von Google Maps verwendet.
--gmp-mat-font-label-large
Wird für die Schaltfläche „In Maps öffnen“ sowie für Links im Dialogfeld für Google Maps-Offenlegungen und für den Text der Quellenangabe des Rezensenten in der Fotogalerie verwendet.
--gmp-mat-font-label-medium
Wird für das Badge mit der Anzahl der Fotos verwendet.
--gmp-mat-font-title-small
Wird für den Ortsnamen verwendet.
--gmp-mat-spacing-extra-small
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-large
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-medium
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-small
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-star-rating-color
Farbe der ausgefüllten Sterne in der Bewertung.
--gmp-thumbnail-border-radius
Rahmenradius des Miniaturbilds des Ortes.
background-color
Überschreibt die Hintergrundfarbe des Elements.
border
Überschreibt den Rahmen des Elements.
border-radius
Überschreibt den Rahmenradius 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.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.
gmp-error
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. falscher API-Schlüssel). Dieses Ereignis wird nicht weitergegeben.
gmp-load
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn das Element geladen wird und seinen Inhalt rendert. Dieses Ereignis wird nicht weitergegeben.

PlaceDetailsCompactElementOptions-Schnittstelle

Schnittstelle google.maps.places.PlaceDetailsCompactElementOptions

Optionen für PlaceDetailsCompactElement.

orientation optional
truncationPreferred optional
Typ: boolean optional

PlaceDetailsOrientation-Konstanten

google.maps.places.PlaceDetailsOrientation-Konstanten

Ausrichtungsvarianten für PlaceDetailsCompactElement.

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

HORIZONTAL Horizontale Ausrichtung.
VERTICAL Vertikale Ausrichtung.

PlaceDetailsPlaceRequestElement-Klasse

Klasse google.maps.places.PlaceDetailsPlaceRequestElement

Konfiguriert ein PlaceDetailsCompactElement- oder PlaceDetailsElement-Objekt, um Daten basierend auf einem Ortsobjekt, einer ID oder einem Ressourcennamen zu laden. Hängen Sie dieses Element als untergeordnetes Element von PlaceDetailsCompactElement oder PlaceDetailsElement an, um Daten für den angegebenen Ort zu laden. Beispiel:

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
</gmp-place-details>

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

PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Parameter: 
place
Typ: Place optional
Standard: null
Das Ortsobjekt, die ID oder der Ressourcenname, für den Details im kompakten Element „Place Details“ gerendert werden sollen. Diese Property wird als Ressourcenname auf das Attribut übertragen.
HTML-Attribut:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.

PlaceDetailsPlaceRequestElementOptions-Schnittstelle

Schnittstelle google.maps.places.PlaceDetailsPlaceRequestElementOptions

Optionen für PlaceDetailsPlaceRequestElement.

place optional
Typ: Place|string optional

PlaceDetailsLocationRequestElement-Klasse

Klasse google.maps.places.PlaceDetailsLocationRequestElement

Konfiguriert einen PlaceDetailsCompactElement oder PlaceDetailsElement, um Daten basierend auf einem Standort zu laden. Hängen Sie dieses Element als untergeordnetes Element von PlaceDetailsCompactElement oder PlaceDetailsElement an, um Daten für den angegebenen Standort zu laden. Beispiel:

 <gmp-place-details>
  <gmp-place-details-location-request
    location="37.6207665,-122.4284806"
  ></gmp-place-details-location-request>
</gmp-place-details>

Benutzerdefiniertes Element:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceDetailsLocationRequestElementOptions.

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

PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
Parameter: 
location
Standard: null
Der Ort, für den Details im Place Details-Element gerendert werden sollen. Normalisiert in ein LatLngAltitude-Format.
HTML-Attribut:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.

PlaceDetailsLocationRequestElementOptions-Schnittstelle

Schnittstelle google.maps.places.PlaceDetailsLocationRequestElementOptions

Optionen für PlaceDetailsLocationRequestElement.

location optional
Der Ort, für den der Ort gerendert werden soll.

Klasse PlaceSearchElement

Klasse google.maps.places.PlaceSearchElement

Zeigt die Ergebnisse einer Ortssuche in einer Liste an. Hängen Sie PlaceTextSearchRequestElement oder PlaceNearbySearchRequestElement an, um die Anfrage anzugeben, für die Ergebnisse gerendert werden sollen. Hängen Sie PlaceContentConfigElement, PlaceStandardContentElement oder PlaceAllContentElement an, um anzugeben, welche Inhalte gerendert werden sollen.

Beispiel:

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

Wenn Sie das Element „Place Search“ 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-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceSearchElementOptions.

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

PlaceSearchElement
PlaceSearchElement([options])
Parameter: 
attributionPosition
Standard: PlaceSearchAttributionPosition.TOP
Die Position des Attributionslogos und der Schaltfläche für rechtliche Hinweise.
HTML-Attribut:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
Standard: PlaceSearchOrientation.VERTICAL
Die Ausrichtungsvariante (vertikal oder horizontal) des Elements.
HTML-Attribut:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
Typ: Array<Place>
Schreibgeschützt. Array von Place-Objekten, die die IDs, Standorte und Darstellungsbereiche der aktuell gerenderten Orte enthalten.
selectable
Typ: boolean optional
Standard: false
Gibt an, ob die Listenelemente auswählbar sind. Wenn „true“, sind die Listenelemente Schaltflächen, die beim Klicken das Ereignis gmp-select auslösen. Die barrierefreie Tastaturnavigation und -auswahl wird ebenfalls unterstützt.
HTML-Attribut:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
Typ: boolean optional
Standard: false
Wenn „true“, werden bestimmte Inhaltszeilen gekürzt, damit sie in eine Zeile passen, anstatt umgebrochen zu werden.
HTML-Attribut:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
Rahmenfarbe für den Button „In Maps öffnen“.
--gmp-button-border-radius
Rahmenradius für die Schaltfläche „In Maps öffnen“.
--gmp-button-border-width
Rahmenbreite für die Schaltfläche „In Maps öffnen“.
--gmp-card-border-radius
Rahmenradius für Ortskarten.
--gmp-dialog-border-radius
Rahmenradius für das Dialogfeld zur Offenlegung von Google Maps.
--gmp-mat-color-info
Farbe von UI-Elementen mit informativer Bedeutung. Wird für das Symbol für barrierefreie Eingänge verwendet.
--gmp-mat-color-negative
Farbe von UI-Elementen mit negativer Stimmung. Wird für das Label „Geschlossen“ für die Öffnungszeiten eines Orts verwendet.
--gmp-mat-color-neutral-container
Containerfarbe für neutrale gefüllte UI-Elemente. Wird für Badges mit dem Datum der Rezension und zum Laden von Platzhalterformen verwendet.
--gmp-mat-color-on-neutral-container
Farbe von Text und Symbolen in einem neutralen Container. Wird für den Text des Überprüfungsdatums und den Text des Ladefehlers verwendet.
--gmp-mat-color-on-secondary-container
Farbe von Text und Symbolen vor einer sekundären Containerfarbe. Wird für Buttontext und Symbole verwendet.
--gmp-mat-color-on-surface
Farbe für Text und Symbole vor einer Oberflächenfarbe. Wird für Überschriften und Dialoginhalte verwendet.
--gmp-mat-color-on-surface-variant
Farbe mit geringerer Betonung für Text und Symbole vor einer Oberflächenfarbe. Wird für Ortsinformationen verwendet.
--gmp-mat-color-outline-decorative
Konturfarbe nicht interaktiver Elemente. Wird für den Containerrahmen verwendet.
--gmp-mat-color-positive
Farbe von UI-Elementen mit positiver Stimmung. Wird für das Label „Geöffnet“ für die Öffnungszeiten eines Ortes verwendet.
--gmp-mat-color-primary
Farbe von interaktivem Text und Symbolen im Vergleich zur Oberflächenfarbe. Wird für Links, die Fortschrittsanzeige und Übersichtssymbole verwendet.
--gmp-mat-color-secondary-container
Weniger auffällige Füllfarbe auf einer Oberfläche. Wird für Schaltflächenhintergründe verwendet.
--gmp-mat-color-surface
Farbe für Hintergründe. Wird für Container- und Dialoghintergründe verwendet.
--gmp-mat-font-body-small
Wird für Ortsinformationen verwendet.
--gmp-mat-font-family
Basisschriftfamilie für den gesamten Text.
--gmp-mat-font-headline-medium
Wird für Dialogüberschriften verwendet.
--gmp-mat-font-label-large
Wird für Schaltflächeninhalte verwendet.
--gmp-mat-font-title-medium
Wird für den Ortsnamen verwendet.
--gmp-mat-spacing-extra-small
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-large
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-medium
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-mat-spacing-small
Wird für Abstände innerhalb des Elements verwendet, z. B. für den Rand und den Abstand um Text.
--gmp-star-rating-color
Farbe der ausgefüllten Sterne in einer Sternebewertung.
--gmp-thumbnail-border-radius
Rahmenradius für die Miniaturansicht des Ortes.
background-color
Überschreibt die Hintergrundfarbe des Elements.
border
Überschreibt den Rahmen des Elements.
border-radius
Überschreibt den Rahmenradius 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 Standardeinstellung ist 16px.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.
gmp-error
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn eine Anfrage an das Backend abgelehnt wurde (z.B. falscher API-Schlüssel). Dieses Ereignis wird nicht weitergegeben.
gmp-load
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn das Element geladen wird und seinen Inhalt rendert. Dieses Ereignis wird nicht weitergegeben.
gmp-select
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Ort aus der Liste ausgewählt wird. Enthält ein Place-Objekt mit der ID, dem Standort und dem Darstellungsbereich des ausgewählten Orts.

Schnittstelle PlaceSearchElementOptions

Schnittstelle google.maps.places.PlaceSearchElementOptions

Optionen für PlaceSearchElement.

attributionPosition optional
orientation optional
selectable optional
Typ: boolean optional
truncationPreferred optional
Typ: boolean optional

PlaceSearchAttributionPosition-Konstanten

google.maps.places.PlaceSearchAttributionPosition-Konstanten

Attributionspositionen für PlaceSearchElement.

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

BOTTOM Quellenangabe am unteren Rand des PlaceSearchElement
TOP Quellenangabe oben im PlaceSearchElement

PlaceSearchOrientation-Konstanten

google.maps.places.PlaceSearchOrientation-Konstanten

Ausrichtungsvarianten für PlaceSearchElement.

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

HORIZONTAL Horizontale Ausrichtung.
VERTICAL Vertikale Ausrichtung.

PlaceSelectEvent-Klasse

Klasse google.maps.places.PlaceSelectEvent

Dieses Ereignis wird ausgelöst, wenn ein Ort aus einer Liste von Orten ausgewählt wird. Greifen Sie mit event.place auf die Auswahl zu.

Diese Klasse erweitert Event.

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

place
Typ: Place
Der ausgewählte Ort.

PlaceNearbySearchRequestElement-Klasse

Klasse google.maps.places.PlaceNearbySearchRequestElement

Konfiguriert einen PlaceSearchElement, um Ergebnisse basierend auf einer Nearby Search-Anfrage zu laden. Das Attribut locationRestriction ist erforderlich, damit das Suchelement geladen werden kann. Alle anderen konfigurierten Attribute werden ignoriert, wenn locationRestriction nicht festgelegt ist. Hängen Sie dieses Element als untergeordnetes Element eines PlaceSearchElement an, um Ergebnisse zu laden. Beispiel:

 <gmp-place-search>
  <gmp-place-nearby-search-request
    location-restriction="RADIUS@LAT,LNG"
  ></gmp-place-nearby-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

Benutzerdefiniertes Element:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceNearbySearchRequestElementOptions.

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

PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
Parameter: 
excludedPrimaryTypes
Typ: Array<string> optional
Standard: null
Ausgeschlossene primäre Ortstypen.
HTML-Attribut:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
Typ: Array<string> optional
Standard: null
Ausgeschlossene Ortstypen.
HTML-Attribut:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
Typ: Array<string> optional
Standard: null
Eingeschlossener primärer Ortstyp.
HTML-Attribut:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
Typ: Array<string> optional
Standard: null
Eingeschlossener Ortstyp.
HTML-Attribut:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
Typ: Circle|CircleLiteral optional
Standard: null
Die Region, in der gesucht werden soll. Normalisiert in ein Circle-Format.
HTML-Attribut:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
Typ: number optional
Standard: null
Maximale Anzahl der zurückzugebenden Ergebnisse.
HTML-Attribut:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
Standard: null
Wie Ergebnisse in der Antwort sortiert werden.
HTML-Attribut:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.

PlaceNearbySearchRequestElementOptions-Schnittstelle

Schnittstelle google.maps.places.PlaceNearbySearchRequestElementOptions

Optionen für PlaceNearbySearchRequestElement.

excludedPrimaryTypes optional
Typ: Array<string> optional
Ausgeschlossene primäre Ortstypen. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.excludedPrimaryTypes und SearchNearbyRequest.excludedPrimaryTypes.
excludedTypes optional
Typ: Array<string> optional
Ausgeschlossene Ortstypen. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.excludedTypes und SearchNearbyRequest.excludedTypes.
includedPrimaryTypes optional
Typ: Array<string> optional
Eingeschlossene primäre Ortstypen. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.includedPrimaryTypes und SearchNearbyRequest.includedPrimaryTypes.
includedTypes optional
Typ: Array<string> optional
Eingeschlossene Ortstypen. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.includedTypes und SearchNearbyRequest.includedTypes.
locationRestriction optional
Typ: Circle|CircleLiteral optional
Die Region, in der gesucht werden soll. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.locationRestriction und SearchNearbyRequest.locationRestriction.
maxResultCount optional
Typ: number optional
Maximale Anzahl der zurückzugebenden Ergebnisse. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.maxResultCount und SearchNearbyRequest.maxResultCount.
rankPreference optional
Wie Ergebnisse in der Antwort sortiert werden. Weitere Informationen findest du unter PlaceNearbySearchRequestElement.rankPreference und SearchNearbyRankPreference.

PlaceTextSearchRequestElement-Klasse

Klasse google.maps.places.PlaceTextSearchRequestElement

Konfiguriert einen PlaceSearchElement, um Ergebnisse basierend auf einer Textsuchanfrage zu laden. Das Attribut textQuery ist erforderlich, damit das Suchelement geladen werden kann. Alle anderen konfigurierten Attribute werden ignoriert, wenn textQuery nicht festgelegt ist. Hängen Sie dieses Element als untergeordnetes Element eines PlaceSearchElement an, um Ergebnisse zu laden. Beispiel:

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

Benutzerdefiniertes Element:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceTextSearchRequestElementOptions.

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

PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
Parameter: 
evConnectorTypes
Typ: Array<EVConnectorType> optional
Standard: null
Die Liste der bevorzugten Ladesteckertypen für Elektrofahrzeuge.
HTML-Attribut:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
Typ: number optional
Standard: null
Erforderliche Mindestladeleistung in Kilowatt.
HTML-Attribut:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
Typ: string optional
Standard: null
Der angeforderte Ortstyp.
HTML-Attribut:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
Typ: boolean optional
Standard: null
Wird verwendet, um die Suche auf Orte zu beschränken, die derzeit geöffnet sind.
HTML-Attribut:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
Typ: LocationBias optional
Standard: null
Standortgewichtung für die Suche. Normalisiert in ein LatLngAltitude | LatLngBounds | Circle | string-Format.
HTML-Attribut:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
Standard: null
Standortbeschränkung für die Suche. Normalisiert in ein LatLngBounds-Format.
HTML-Attribut:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
Typ: number optional
Standard: null
Maximale Anzahl der zurückzugebenden Ergebnisse.
HTML-Attribut:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
Typ: number optional
Standard: null
Ergebnisse herausfiltern, deren durchschnittliche Nutzerbewertung unter diesem Grenzwert liegt.
HTML-Attribut:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
Typ: Array<PriceLevel> optional
Standard: null
Wird verwendet, um die Suche auf Orte zu beschränken, die mit bestimmten Preisstufen gekennzeichnet sind.
HTML-Attribut:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
Standard: null
Wie Ergebnisse in der Antwort sortiert werden.
HTML-Attribut:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
Typ: string optional
Standard: null
Die Textanfrage für die Textsuche.
HTML-Attribut:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
Typ: boolean optional
Standard: null
Wird verwendet, um eine strenge Typfilterung für „includedType“ festzulegen.
HTML-Attribut:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.

PlaceTextSearchRequestElementOptions-Schnittstelle

Schnittstelle google.maps.places.PlaceTextSearchRequestElementOptions

Optionen für PlaceTextSearchRequestElement.

evConnectorTypes optional
Typ: Array<EVConnectorType> optional
Die Liste der bevorzugten Ladesteckertypen für Elektrofahrzeuge. Weitere Informationen findest du unter SearchByTextRequest.evSearchOptions und PlaceTextSearchRequestElement.evConnectorTypes.
evMinimumChargingRateKw optional
Typ: number optional
Erforderliche Mindestladeleistung in Kilowatt. Weitere Informationen findest du unter SearchByTextRequest.evSearchOptions und PlaceTextSearchRequestElement.evMinimumChargingRateKw.
includedType optional
Typ: string optional
Der angeforderte Ortstyp. Weitere Informationen findest du unter SearchByTextRequest.includedType und PlaceTextSearchRequestElement.includedType.
isOpenNow optional
Typ: boolean optional
Wird verwendet, um die Suche auf Orte zu beschränken, die derzeit geöffnet sind. Weitere Informationen findest du unter SearchByTextRequest.isOpenNow und PlaceTextSearchRequestElement.isOpenNow.
locationBias optional
Typ: LocationBias optional
Standortgewichtung für die Suche. Weitere Informationen findest du unter SearchByTextRequest.locationBias und PlaceTextSearchRequestElement.locationBias.
locationRestriction optional
Standortbeschränkung für die Suche. Weitere Informationen findest du unter SearchByTextRequest.locationRestriction und PlaceTextSearchRequestElement.locationRestriction.
maxResultCount optional
Typ: number optional
Maximale Anzahl der zurückzugebenden Ergebnisse. Weitere Informationen findest du unter SearchByTextRequest.maxResultCount und PlaceTextSearchRequestElement.maxResultCount.
minRating optional
Typ: number optional
Ergebnisse herausfiltern, deren durchschnittliche Nutzerbewertung unter diesem Grenzwert liegt. Weitere Informationen findest du unter SearchByTextRequest.minRating und PlaceTextSearchRequestElement.minRating.
priceLevels optional
Typ: Array<PriceLevel> optional
Wird verwendet, um die Suche auf Orte zu beschränken, die mit bestimmten Preisstufen gekennzeichnet sind. Weitere Informationen findest du unter SearchByTextRequest.priceLevels und PlaceTextSearchRequestElement.priceLevels.
rankPreference optional
Wie Ergebnisse in der Antwort sortiert werden. Weitere Informationen findest du unter SearchByTextRequest.rankPreference und PlaceTextSearchRequestElement.rankPreference.
textQuery optional
Typ: string optional
Die Textanfrage für die Textsuche. Weitere Informationen findest du unter SearchByTextRequest.textQuery und PlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering optional
Typ: boolean optional
Wird verwendet, um eine strenge Typfilterung für SearchByTextRequest.includedType festzulegen. Weitere Informationen findest du unter SearchByTextRequest.useStrictTypeFiltering und PlaceTextSearchRequestElement.useStrictTypeFiltering.

Autocomplete-Klasse

Klasse google.maps.places.Autocomplete

Ein Widget, das Ortsvorschläge basierend auf der Texteingabe eines Nutzers liefert. Es wird an ein Eingabeelement vom Typ text angehängt und überwacht die Texteingabe in diesem Feld. Die Liste der Vervollständigungen wird als Drop-down-Liste angezeigt und während der Texteingabe aktualisiert.

Diese Klasse erweitert MVCObject.

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

Autocomplete
Autocomplete(inputField[, opts])
Parameter: 
Erstellt eine neue Instanz von Autocomplete, die mit den angegebenen Optionen an das angegebene Eingabetextfeld angehängt wird.
getBounds
getBounds()
Parameter: Keine
Rückgabewert:  LatLngBounds|undefined Die Biasing-Grenzen.
Gibt die Grenzen zurück, auf die die Vervollständigungen ausgerichtet sind.
getFields
getFields()
Parameter: Keine
Rückgabewert: Array<string>|undefined
Gibt die Felder zurück, die für den Ort in der Antwort mit den Details 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 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: Keiner
Legt den bevorzugten Bereich fest, für den Ortsergebnisse zurückgegeben werden sollen. Bei den Ergebnissen werden Orte innerhalb dieses Gebiets bevorzugt, sind aber nicht auf sie beschränkt.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parameter: 
Rückgabewert: Keiner
Legt die Komponentenbeschränkungen fest. Mit Komponentenbeschränkungen werden Vervollständigungen auf die übergeordnete Komponente beschränkt. 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 Antwort mit den Details 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: 
  • types:  Array<string> optional Die Typen von Vervollständigungen, die einbezogen werden sollen.
Rückgabewert: Keiner
Legt die Typen der zurückzugebenden Vervollständigungen fest. 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 vom Nutzer ausgewählten Ort verfügbar gemacht wird.
Wenn der Nutzer den Namen eines Ortes eingibt, der nicht vom Steuerelement vorgeschlagen wurde, und die Eingabetaste drückt, oder wenn eine Place Details-Anfrage fehlschlägt, enthält PlaceResult die Nutzereingabe in der Property name. Es sind keine anderen Properties definiert.

AutocompleteOptions-Schnittstelle

Schnittstelle google.maps.places.AutocompleteOptions

Die Optionen, die für ein Autocomplete-Objekt festgelegt werden können.

bounds optional
Das Gebiet, in dem nach Orten gesucht werden soll.
componentRestrictions optional
Typ: ComponentRestrictions optional
Die Einschränkungen der Komponente. Mit Komponentenbeschränkungen werden Vervollständigungen auf die übergeordnete Komponente beschränkt. Beispiel: das Land.
fields optional
Typ: Array<string> optional
Felder, die für den Ort in der Antwort mit den Details enthalten sein sollen, wenn die Details erfolgreich abgerufen wurden. Diese Felder 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
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“. „place_id“, „types“ und „description“ werden vom Autocomplete-Dienst zurückgegeben. 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 zum Zeitpunkt des Sendens der Anfrage innerhalb der Grenzen des Autocomplete-Widgets befinden. Wenn Sie „strictBounds“ auf false setzen (Standardeinstellung), werden bei den Ergebnissen Orte innerhalb des Gebiets bevorzugt, sind aber nicht auf sie beschränkt.
types optional
Typ: Array<string> optional
Die Typen von Vervollständigungen, die zurückgegeben werden sollen. Informationen zu unterstützten Typen finden Sie im Entwicklerhandbuch. Wenn keine Typen angegeben sind, werden alle Typen zurückgegeben.

Klasse google.maps.places.SearchBox

Ein Widget, das Vervollständigungen für Suchanfragen basierend auf der Texteingabe eines Nutzers liefert. Es wird an ein Eingabeelement vom Typ text angehängt und überwacht die Texteingabe in diesem Feld. Die Liste der Vervollständigungen wird als Drop-down-Liste angezeigt und während der Texteingabe aktualisiert.

Diese Klasse erweitert MVCObject.

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

SearchBox
SearchBox(inputField[, opts])
Parameter: 
Erstellt eine neue Instanz von SearchBox, die mit den angegebenen Optionen an das angegebene Eingabetextfeld angehängt wird.
getBounds
getBounds()
Parameter: Keine
Rückgabewert: LatLngBounds|undefined
Gibt die Grenzen zurück, auf die Suchvorschläge ausgerichtet sind.
getPlaces
getPlaces()
Parameter: Keine
Rückgabewert: Array<PlaceResult>|undefined
Gibt die vom Nutzer ausgewählte Abfrage zurück, die mit dem Ereignis places_changed verwendet werden soll.
setBounds
setBounds(bounds)
Parameter: 
Rückgabewert: Keiner
Legt die Region fest, die für die Gewichtung von Abfragevorhersagen verwendet werden soll. Die Ergebnisse werden nur auf diesen Bereich ausgerichtet und nicht vollständig darauf beschränkt.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn der Nutzer eine Suchanfrage auswählt. getPlaces sollte verwendet werden, um neue Orte abzurufen.

SearchBoxOptions-Schnittstelle

Schnittstelle google.maps.places.SearchBoxOptions

Die Optionen, die für ein SearchBox-Objekt festgelegt werden können.

bounds optional
Das Gebiet, auf das die Vervollständigungen von Suchanfragen ausgerichtet werden sollen. Bei den Vervollständigungen werden Suchanfragen innerhalb dieses Gebiets bevorzugt, sind aber nicht auf sie beschränkt.

Klasse PlaceContextualElement

Klasse google.maps.places.PlaceContextualElement

Ein Widget, das das Kontext-Token verwendet, um eine kontextbezogene Ansicht der Antwort der Fundierung mit Google Maps anzuzeigen.

Benutzerdefiniertes Element:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PlaceContextualElementOptions.

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

PlaceContextualElement
PlaceContextualElement([options])
Parameter: 
contextToken
Typ: string optional
Das Kontext-Token.
HTML-Attribut:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.

PlaceContextualElementOptions-Schnittstelle

Schnittstelle google.maps.places.PlaceContextualElementOptions

Optionen für PlaceContextualElement.

contextToken optional
Typ: string optional
Das Kontext-Token, das von der Antwort der Fundierung mit Google Maps bereitgestellt wird.

PlaceContextualListConfigElement-Klasse

Klasse google.maps.places.PlaceContextualListConfigElement

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

PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
Parameter: 
layout
Das Layout.
HTML-Attribut:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Typ: boolean optional
Gibt an, ob die Karte ausgeblendet ist.
HTML-Attribut:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, bei dem die Groß-/Kleinschreibung berücksichtigt wird und der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der handleEvent-Methode sein
  • options:  boolean|AddEventListenerOptions optional Siehe 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 übermittelt wird. Weitere Informationen finden Sie unter addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string Ein String, der den Ereignistyp angibt, für den ein Ereignis-Listener entfernt werden soll.
  • listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Ereignisziel entfernt werden soll.
  • options:  boolean|EventListenerOptions optional Siehe Optionen.
Rückgabewert: void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener vom Ziel. Weitere Informationen finden Sie unter removeEventListener.

Schnittstelle PlaceContextualListConfigElementOptions

Schnittstelle google.maps.places.PlaceContextualListConfigElementOptions

Optionen für PlaceContextualListConfigElement.

layout optional
Das Layout.
mapHidden optional
Typ: boolean optional
Standard: false
„True“, wenn die Karte ausgeblendet werden soll.

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

COMPACT Kompaktes Listenlayout: Listenelemente werden als Links in einer einzigen Zeile dargestellt, wobei Überläufe in einer Drop-down-Liste angezeigt werden.
VERTICAL Vertikales Listenlayout: Listenelemente werden als Karten in einer vertikalen Liste gerendert.