Maps

MapElement-Klasse

google.maps.MapElement Klasse

MapElement ist eine HTMLElement-Unterklasse zum Rendern von Karten. Nach dem Laden der maps-Bibliothek kann eine Karte in HTML erstellt werden. Beispiel:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

Benutzerdefiniertes Element:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert MapElementOptions.

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

Methoden
addEventListener	addEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Die Groß-/Kleinschreibung muss beachtet werden. listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der Methode „handleEvent“ sein. options:  boolean|AddEventListenerOptions optional Optionen Benutzerdefinierte Ereignisse unterstützen nur capture und passive. Rückgabewert:void Richtet eine Funktion ein, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Siehe addEventListener.
removeEventListener	removeEventListener(type, listener[, options]) Parameter: type:  string Ein String, der den Typ des Ereignisses angibt, für das ein Event-Listener entfernt werden soll. listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der vom Event-Ziel entfernt werden soll. options:  boolean|EventListenerOptions optional Optionen Rückgabewert:void Entfernt einen Event-Listener, der zuvor mit addEventListener für das Ziel registriert wurde. Siehe removeEventListener.

MapElementOptions-Schnittstelle

google.maps.MapElementOptions-Schnittstelle

MapElementOptions-Objekt zum Definieren der Eigenschaften, die für ein MapElement festgelegt werden können.

Klasse ZoomChangeEvent

google.maps.ZoomChangeEvent Klasse

Dieses Ereignis wird durch die Überwachung von Zoom-Änderungen erstellt.

Diese Klasse erweitert Event.

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

Klasse Map

google.maps.Map Klasse

Diese Klasse erweitert MVCObject.

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

Methoden
fitBounds	fitBounds(bounds[, padding]) Parameter: bounds:  LatLngBounds|LatLngBoundsLiteral anzuzeigende Grenzen. padding:  number|Padding optional Abstand in Pixeln. Die Begrenzungen werden an den Teil der Karte angepasst, der nach dem Entfernen des Abstands übrig bleibt. Ein numerischer Wert führt zu demselben Abstand auf allen vier Seiten. Geben Sie hier 0 an, damit „fitBounds“ für das Ergebnis von „getBounds“ idempotent ist. Rückgabewert:Keiner Legt fest, dass die angegebenen Grenzen für den Darstellungsbereich gelten. Hinweis:Wenn die Karte auf display: none festgelegt ist, wird die Größe der Karte von der Funktion fitBounds als 0 × 0 gelesen. Daher wird nichts ausgeführt. Wenn Sie den Darstellungsbereich ändern möchten, während die Karte ausgeblendet ist, legen Sie die Karte auf visibility: hidden fest. So wird dafür gesorgt, dass das „div“-Element der Karte eine tatsächliche Größe hat. Bei Vektorkarten werden mit dieser Methode die Neigung und Ausrichtung der Karte auf die Standardwerte 0 gesetzt. Wenn Sie diese Methode aufrufen, kann es zu einer flüssigen Animation kommen, da die Karte geschwenkt und gezoomt wird, um die Grenzen zu berücksichtigen. Ob diese Methode animiert wird, hängt von einer internen Heuristik ab.
getBounds	getBounds() Parameter:Keine Rückgabewert:LatLngBounds|undefined Die Breiten-/Längengradgrenzen des aktuellen Darstellungsbereichs. Gibt die Breite-/Länge-Grenzen des aktuellen Darstellungsbereichs zurück. Wenn mehr als eine Kopie der Welt sichtbar ist, liegt der Bereich der Grenzen im Längengrad zwischen -180 und 180 Grad (einschließlich). Wenn die Karte noch nicht initialisiert wurde oder die Mitte und der Zoom nicht festgelegt wurden, ist das Ergebnis undefined. Bei Vektorkarten mit einer Neigung oder einem Kurs ungleich null stellen die zurückgegebenen Breiten-/Längengradgrenzen den kleinsten Begrenzungsrahmen dar, der den sichtbaren Bereich des Darstellungsbereichs der Karte enthält. Unter MapCanvasProjection.getVisibleRegion erfahren Sie, wie Sie den genauen sichtbaren Bereich des Darstellungsbereichs der Karte abrufen.
getCenter	getCenter() Parameter:Keine Rückgabewert:LatLng|undefined Gibt die Position zurück, die in der Mitte der Karte angezeigt wird. Beachten Sie, dass dieses LatLng-Objekt nicht umschlossen ist. Weitere Informationen findest du in den LatLng. Wenn der Mittelpunkt oder die Grenzen nicht festgelegt wurden, ist das Ergebnis undefined.
getClickableIcons	getClickableIcons() Parameter:Keine Rückgabewert:boolean|undefined Gibt zurück, ob die Kartensymbole anklickbar sind. Ein Kartensymbol stellt einen Point of Interest (POI) dar. Wenn der zurückgegebene Wert true ist, sind die Symbole auf der Karte anklickbar.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) Parameter: datasetId:  string Rückgabewert:FeatureLayer Gibt die FeatureLayer für die angegebene datasetId zurück. Dataset-IDs müssen in der Google Cloud Console konfiguriert werden. Wenn die Dataset-ID nicht mit dem Kartenstil der Karte verknüpft ist oder wenn datengestützte Stile nicht verfügbar sind (keine Karten-ID, keine Vektorkacheln, keine Feature-Ebenen oder Datasets für datengestützte Stile, die im Kartenstil konfiguriert sind), wird ein Fehler protokolliert und das Ergebnis von FeatureLayer.isAvailable ist „false“.
getDiv	getDiv() Parameter:Keine Rückgabewert:HTMLElement Das mapDiv-Element der Karte.
getFeatureLayer	getFeatureLayer(featureType) Parameter: featureType:  FeatureType Rückgabewert:FeatureLayer Gibt die FeatureLayer der angegebenen FeatureType zurück. Ein FeatureLayer muss in der Google Cloud Console aktiviert sein. Wenn auf dieser Karte kein FeatureLayer des angegebenen FeatureType vorhanden ist oder wenn die datengesteuerte Formatierung nicht verfügbar ist (keine Karten-ID, keine Vektorkacheln und kein FeatureLayer im Kartenstil aktiviert), wird ein Fehler protokolliert und das resultierende FeatureLayer.isAvailable ist „false“.
getHeading	getHeading() Parameter:Keine Rückgabewert:number|undefined Gibt die Kompassausrichtung der Karte zurück. Der Richtungswert wird in Grad (im Uhrzeigersinn) ausgehend von der Himmelsrichtung Norden gemessen. Wenn die Karte noch nicht initialisiert wurde, ist das Ergebnis undefined.
getHeadingInteractionEnabled	getHeadingInteractionEnabled() Parameter:Keine Rückgabewert:boolean|null Gibt zurück, ob Interaktionen mit Überschriften aktiviert sind. Diese Option ist nur wirksam, wenn es sich bei der Karte um eine Vektorkarte handelt. Wenn sie nicht im Code festgelegt ist, wird die Cloud-Konfiguration für die Karten-ID verwendet (falls verfügbar).
getInternalUsageAttributionIds	getInternalUsageAttributionIds() Parameter:Keine Rückgabewert:Iterable<string>|null Gibt die Liste der IDs für die Nutzungszuordnung zurück, mit denen Google nachvollziehen kann, welche Bibliotheken und Beispiele für Entwickler hilfreich sind, z. B. die Verwendung einer Markierungs-Clustering-Bibliothek.
getMapCapabilities	getMapCapabilities() Parameter:Keine Rückgabewert:MapCapabilities Informiert den Anrufer über die aktuellen Funktionen, die für die Karte basierend auf der bereitgestellten Karten-ID verfügbar sind.
getMapTypeId	getMapTypeId() Parameter:Keine Rückgabewert:MapTypeId|string|undefined
getProjection	getProjection() Parameter:Keine Rückgabewert:Projection|undefined Gibt die aktuelle Projection zurück. Wenn die Karte noch nicht initialisiert wurde, ist das Ergebnis undefined. Achten Sie auf das projection_changed-Ereignis und prüfen Sie seinen Wert, um sicherzustellen, dass er nicht undefined ist.
getRenderingType	getRenderingType() Parameter:Keine Rückgabewert:RenderingType Gibt den aktuellen RenderingType der Karte zurück.
getStreetView	getStreetView() Parameter:Keine Rückgabewert:StreetViewPanorama Das an die Karte gebundene Panorama. Gibt die Standard-StreetViewPanorama zurück, die an die Karte gebunden ist. Das kann ein Standardpanorama sein, das in die Karte eingebettet ist, oder das mit setStreetView() festgelegte Panorama. Änderungen an der streetViewControl der Karte werden in der Anzeige eines solchen gebundenen Panoramas berücksichtigt.
getTilt	getTilt() Parameter:Keine Rückgabewert:number|undefined Gibt den aktuellen Einfallswinkel der Karte in Grad von der Darstellungsbereichsebene zur Kartenebene zurück. Bei Rasterkarten ist das Ergebnis 0 für Bilder, die direkt von oben aufgenommen wurden, oder 45 für 45°-Bilder. Diese Methode gibt nicht den von setTilt festgelegten Wert zurück. Weitere Informationen finden Sie unter setTilt.
getTiltInteractionEnabled	getTiltInteractionEnabled() Parameter:Keine Rückgabewert:boolean|null Gibt zurück, ob Neigungsinteraktionen aktiviert sind. Diese Option ist nur wirksam, wenn es sich bei der Karte um eine Vektorkarte handelt. Wenn sie nicht im Code festgelegt ist, wird die Cloud-Konfiguration für die Karten-ID verwendet (falls verfügbar).
getZoom	getZoom() Parameter:Keine Rückgabewert:number|undefined Gibt den Zoomfaktor der Karte zurück. Wenn der Zoom nicht festgelegt wurde, ist das Ergebnis undefined.
moveCamera	moveCamera(cameraOptions) Parameter: cameraOptions:  CameraOptions Rückgabewert:Keiner Legt die Kameraposition der Karte sofort und ohne Animation auf die Zielkameraoptionen fest.
panBy	panBy(x, y) Parameter: x:  number Anzahl der Pixel, um die Karte in X-Richtung zu verschieben. y:  number Anzahl der Pixel, um die Karte in Y-Richtung zu verschieben. Rückgabewert:Keiner Verschiebt den Mittelpunkt der Karte um die in Pixeln angegebene Entfernung. Wenn die Entfernung geringer ist als sowohl die Breite als auch die Höhe der Karte, wird der Übergang gleitend animiert. Beachten Sie, dass die Koordinaten der Karte von Westen nach Osten (x-Werte) und von Norden nach Süden (y-Werte) größer werden.
panTo	panTo(latLng) Parameter: latLng:  LatLng|LatLngLiteral Der neue Mittelpunkt der Karte (Breiten- und Längengrad). Rückgabewert:Keiner Ändert den Mittelpunkt der Karte in die angegebene LatLng. Wenn die Verschiebung geringer ist als sowohl die Breite als auch die Höhe der Karte, wird der Übergang gleitend animiert.
panToBounds	panToBounds(latLngBounds[, padding]) Parameter: latLngBounds:  LatLngBounds|LatLngBoundsLiteral Die Grenzen, zu denen die Karte geschwenkt werden soll. padding:  number|Padding optional Abstand in Pixeln. Ein numerischer Wert führt zu demselben Abstand auf allen vier Seiten. Der Standardwert ist 0. Rückgabewert:Keiner Die Karte wird so geschwenkt, dass die angegebene LatLngBounds gerade noch sichtbar ist. Es wird nicht garantiert, wo auf der Karte die Grenzen angezeigt werden, außer dass die Karte so geschwenkt wird, dass möglichst viele Grenzen innerhalb von {currentMapSizeInPx} - {padding} angezeigt werden. Bei Raster- und Vektorkarten werden Zoom, Neigung und Ausrichtung der Karte nicht geändert.
setCenter	setCenter(latlng) Parameter: latlng:  LatLng|LatLngLiteral Rückgabewert:Keiner
setClickableIcons	setClickableIcons(value) Parameter: value:  boolean Rückgabewert:Keiner Legt fest, ob die Kartensymbole anklickbar sind oder nicht. Ein Kartensymbol stellt einen Point of Interest (POI) dar. Wenn Sie die Klickbarkeit von Kartensymbolen deaktivieren möchten, übergeben Sie den Wert false an diese Methode.
setHeading	setHeading(heading) Parameter: heading:  number Rückgabewert:Keiner Legt die Kompassrichtung für die Karte fest, gemessen in Grad von der Himmelsrichtung Norden aus. Bei Rasterkarten gilt diese Methode nur für Luftbilder.
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) Parameter: headingInteractionEnabled:  boolean Rückgabewert:Keiner Legt fest, ob Überschrifteninteraktionen aktiviert sind. Diese Option ist nur wirksam, wenn es sich bei der Karte um eine Vektorkarte handelt. Wenn sie nicht im Code festgelegt ist, wird die Cloud-Konfiguration für die Karten-ID verwendet (falls verfügbar).
setMapTypeId	setMapTypeId(mapTypeId) Parameter: mapTypeId:  MapTypeId|string Rückgabewert:Keiner
setOptions	setOptions(options) Parameter: options:  MapOptions optional Rückgabewert:Keiner
setRenderingType	setRenderingType(renderingType) Parameter: renderingType:  RenderingType Rückgabewert:Keiner Legt den aktuellen RenderingType der Karte fest.
setStreetView	setStreetView(panorama) Parameter: panorama:  StreetViewPanorama optional Das Panorama, das an die Karte gebunden werden soll. Rückgabewert:Keiner Bindet ein StreetViewPanorama an die Karte. Dieses Panorama überschreibt das Standard-StreetViewPanorama-Objekt, sodass die Karte an ein externes Panorama außerhalb der Karte gebunden werden kann. Wenn Sie das Panorama auf null festlegen, wird das standardmäßige eingebettete Panorama wieder an die Karte gebunden.
setTilt	setTilt(tilt) Parameter: tilt:  number Rückgabewert:Keiner Legt für Vektorkarten den Einfallswinkel der Karte fest. Die zulässigen Werte sind von der Zoomstufe der Karte abhängig.  Steuert bei Rasterkarten das automatische Umschalten des Einfallswinkels der Karte. Die einzigen zulässigen Werte sind 0 und 45. Mit setTilt(0) wird für die Karte immer eine 0°-Ansicht von oben verwendet, unabhängig von der Zoomstufe und dem Darstellungsbereich. Mit setTilt(45) wird der Neigungswinkel automatisch auf 45 ° gesetzt, wenn für die aktuelle Zoomstufe und den aktuellen Darstellungsbereich 45°-Bilder verfügbar sind. Wenn keine 45°-Bilder verfügbar sind, wird der Neigungswinkel wieder auf 0 ° gesetzt. Das ist das Standardverhalten. 45°-Bilder sind nur für die Kartentypen satellite und hybrid, an bestimmten Orten und bei bestimmten Zoomstufen verfügbar. Hinweis:getTilt gibt den aktuellen Neigungswinkel zurück, nicht den von setTilt festgelegten Wert. Da sich getTilt und setTilt auf unterschiedliche Dinge beziehen, sollten Sie das Attribut tilt nicht bind(). Andernfalls kann es zu unvorhersehbaren Auswirkungen kommen.
setTiltInteractionEnabled	setTiltInteractionEnabled(tiltInteractionEnabled) Parameter: tiltInteractionEnabled:  boolean Rückgabewert:Keiner Legt fest, ob Neigungsinteraktionen aktiviert sind. Diese Option ist nur wirksam, wenn es sich bei der Karte um eine Vektorkarte handelt. Wenn sie nicht im Code festgelegt ist, wird die Cloud-Konfiguration für die Karten-ID verwendet (falls verfügbar).
setZoom	setZoom(zoom) Parameter: zoom:  number Größere Zoomwerte entsprechen einer höheren Auflösung. Rückgabewert:Keiner Legt den Zoom der Karte fest.
Geerbt:addListener, bindTo,