Maps

Map-Klasse

google.maps.Map Klasse

Diese Klasse erweitert MVCObject.

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

Konstruktor
Map	Map(mapDiv[, opts]) Parameter:  mapDiv:  HTMLElement Die Karte wird so gerendert, dass dieses Element ausgefüllt wird. opts:  MapOptions optional Optionen Erstellt eine neue Karte innerhalb des gegebenen HTML-Containers, bei dem es sich in der Regel um ein DIV-Element handelt.

Konstanten
DEMO_MAP_ID	Karten-ID, die für Codebeispiele verwendet werden kann, die eine Karten-ID erfordern. Diese Karten-ID ist nicht für Produktionsanwendungen vorgesehen und kann nicht für Funktionen verwendet werden, die eine Cloudkonfiguration erfordern (z. B. Cloud Styling).

Attribute
controls	Typ:Array<MVCArray<HTMLElement>> Fügt der Karte zusätzliche Steuerelemente hinzu. Wenn Sie der Karte ein Steuerelement hinzufügen möchten, fügen Sie das <div> des Steuerelements zum MVCArray entsprechend der ControlPosition hinzu, an der es gerendert werden soll.
data	Typ:Data Eine Instanz von Data, die an die Karte gebunden ist. Fügen Sie diesem Data-Objekt Elemente hinzu, um sie bequem auf dieser Karte darzustellen.
mapTypes	Typ:MapTypeRegistry Eine Registry mit MapType Instanzen nach String-ID.
overlayMapTypes	Typ:MVCArray<MapType optional> Zusätzliche Kartentypen für Overlays. Overlay-Kartentypen werden über der Basiskarte angezeigt, der sie zugeordnet sind, und zwar in der Reihenfolge, in der sie im overlayMapTypes-Array vorkommen. Overlays mit höheren Indexwerten werden vor Overlays mit niedrigeren Indexwerten angezeigt.

Methoden
fitBounds	fitBounds(bounds[, padding]) Parameter:  bounds:  LatLngBounds|LatLngBoundsLiteral Anzuzeigende Grenzen. padding:  number|Padding optional Abstand in Pixeln Die Grenzen passen in den Teil der Karte, der verbleibt, nachdem die Auffüllung entfernt wurde. Ein Zahlenwert liefert auf allen vier Seiten das gleiche Padding. Geben Sie hier 0 an, um ein fitBounds-Ergebnis für das Ergebnis von getBounds idempotent zu machen. Rückgabewert:Keine Legt fest, dass die angegebenen Grenzen für den Darstellungsbereich gelten. Hinweis:Wenn für die Karte display: none festgelegt ist, liest die Funktion fitBounds die Kartengröße als 0 x 0 und führt daher keine Aktion aus. Wenn Sie den Darstellungsbereich ändern möchten, während die Karte ausgeblendet ist, legen Sie für die Karte visibility: hidden fest. Dadurch muss das div-Element der Karte die tatsächliche Größe haben. Bei Vektorkarten setzt diese Methode die Neigung und Ausrichtung der Karte auf ihre Standardwerte null ein. Das Aufrufen dieser Methode kann zu einer flüssigen Animation führen, wenn die Karte geschwenkt und gezoomt wird, damit sie in die Grenzen passt. Ob diese Methode animiert wird, hängt von einer internen Heuristik ab.
getBounds	getBounds() Parameter:Keine Rückgabewert:  LatLngBounds|undefined Die Breiten-/Längengrenzen des aktuellen Darstellungsbereichs. Gibt die Breite-/Länge-Grenzen des aktuellen Darstellungsbereichs zurück. Wenn mehr als eine Kopie der Welt sichtbar ist, reichen die Längenwerte von -180 bis einschließlich 180 Grad. Wenn die Karte noch nicht initialisiert oder zentriert und der Zoom nicht festgelegt wurde, ist das Ergebnis undefined. Bei Vektorkarten mit Neigung oder Ausrichtung ungleich null stellen die zurückgegebenen Breiten-/Längengrenzen den kleinsten Markierungsrahmen 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 kein Zentrum oder keine Grenzen festgelegt wurden, lautet das Ergebnis undefined.
getClickableIcons	getClickableIcons() Parameter:Keine Rückgabewert:  boolean|undefined Gibt die Anklickbarkeit der Kartensymbole zurück. Ein Kartensymbol repräsentiert einen POI, der auch als POI bezeichnet wird. Wenn der zurückgegebene Wert true ist, sind die Symbole auf der Karte anklickbar.
getDatasetFeatureLayer	Hinweis:Nur im v=beta-Kanal verfügbar. getDatasetFeatureLayer(datasetId) Parameter:  datasetId:  string Rückgabewert:  FeatureLayer Gibt den FeatureLayer für den angegebenen datasetId-Wert 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 keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln, keine Featureebenen mit datengestützten Stilen oder im Kartenstil konfigurierte Datasets), wird ein Fehler protokolliert und der resultierende FeatureLayer.isAvailable ist „false“.
getDiv	getDiv() Parameter:Keine Rückgabewert:HTMLElement Die „mapDiv“-Funktion der Karte.
getFeatureLayer	getFeatureLayer(featureType) Parameter:  featureType:  FeatureType Rückgabewert:  FeatureLayer Gibt den FeatureLayer des spezifischen FeatureType zurück. In der Google Cloud Console muss ein FeatureLayer aktiviert sein. Wenn ein FeatureLayer der angegebenen FeatureType auf dieser Karte nicht vorhanden ist oder keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln und kein FeatureLayer im Kartenstil aktiviert), wird ein Fehler protokolliert und der 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 ist, ist das Ergebnis undefined.
getMapCapabilities	getMapCapabilities() Parameter:Keine Rückgabewert:  MapCapabilities Informiert den Aufrufer über die derzeit für die Karte verfügbaren Funktionen basierend auf der angegebenen Karten-ID.
getMapTypeId	getMapTypeId() Parameter:Keine Rückgabewert:  MapTypeId|string|undefined
getProjection	getProjection() Parameter:Keine Rückgabewert:  Projection|undefined Gibt den aktuellen Projection zurück. Wenn die Karte noch nicht initialisiert ist, ist das Ergebnis undefined. Prüfen Sie das projection_changed-Ereignis und prüfen Sie seinen Wert, um sicherzustellen, dass es 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 das mit der Karte gebundene Standard-StreetViewPanorama zurück. Dabei kann es sich um ein in die Karte eingebettetes Standardpanorama handeln oder um das Panorama, das mit setStreetView() festgelegt wurde. Änderungen an streetViewControl der Karte werden in der Anzeige eines solchen verknüpften Panoramas widergespiegelt.
getTilt	getTilt() Parameter:Keine Rückgabewert:  number|undefined Gibt den aktuellen Einfallswinkel der Karte in Grad von der Ebene des Darstellungsbereichs zur Kartenebene zurück. Bei Rasterkarten lautet das Ergebnis 0 für Bilder, die direkt über dem Kopf aufgenommen wurden, oder 45 für 45°-Bilder. Diese Methode gibt nicht den von setTilt festgelegten Wert zurück. Weitere Informationen findest du unter setTilt.
getZoom	getZoom() Parameter:Keine Rückgabewert:  number|undefined Gibt die Zoomstufe der Karte zurück. Wenn kein Zoom festgelegt wurde, lautet das Ergebnis undefined.
moveCamera	moveCamera(cameraOptions) Parameter:  cameraOptions:  CameraOptions Rückgabewert:Keine Setzt die Kamera der Karte sofort auf die Zielkameraoptionen ohne Animation.
panBy	panBy(x, y) Parameter:  x:  number Anzahl der Pixel, mit der die Karte in x-Richtung verschoben wird. y:  number Anzahl der Pixel, mit der die Karte in y-Richtung verschoben wird. Rückgabewert:Keine 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 mittlere Breiten- und Längengrad der Karte. Rückgabewert:Keine Ändert die Mitte der Karte in den angegebenen 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 Zahlenwert liefert auf allen vier Seiten das gleiche Padding. Der Standardwert ist 0. Rückgabewert:Keine Schwenkt die Karte um das geringstnötige Stück, sodass sie den angegebenen LatLngBounds enthält. Es gibt keine Garantie dafür, wo sich die Grenzen auf der Karte befinden. Der einzige Unterschied besteht darin, dass die Karte so geschwenkt wird, dass so viel von den Grenzen wie möglich innerhalb von {currentMapSizeInPx} - {padding} angezeigt wird. Sowohl bei Raster- als auch bei Vektorkarten werden Zoom, Neigung und Ausrichtung der Karte nicht geändert.
setCenter	setCenter(latlng) Parameter:  latlng:  LatLng|LatLngLiteral Rückgabewert:Keine
setClickableIcons	setClickableIcons(value) Parameter:  value:  boolean Rückgabewert:Keine Steuert, ob die Kartensymbole anklickbar sind oder nicht. Ein Kartensymbol repräsentiert einen POI, der auch als POI bezeichnet wird. Übergeben Sie den Wert false an diese Methode, um die Anklickbarkeit von Kartensymbolen zu deaktivieren.
setHeading	setHeading(heading) Parameter:  heading:  number Rückgabewert:Keine Legt die Kompassausrichtung der Karte fest, gemessen in Grad ausgehend von der Himmelsrichtung Norden. Bei Rasterkarten gilt diese Methode nur für Luftbilder.
setMapTypeId	setMapTypeId(mapTypeId) Parameter:  mapTypeId:  MapTypeId|string Rückgabewert:Keine
setOptions	setOptions(options) Parameter:  options:  MapOptions optional Rückgabewert:Keine
setStreetView	setStreetView(panorama) Parameter:  panorama:  StreetViewPanorama optional Das Panorama, das an die Karte gebunden werden soll Rückgabewert:Keine Verknüpft einen StreetViewPanorama mit der Karte. Dieses Panorama überschreibt den standardmäßigen StreetViewPanorama, sodass die Karte an ein externes Panorama außerhalb der Karte gebunden werden kann. Wenn Sie das Panorama auf null setzen, wird das standardmäßig eingebettete Panorama wieder mit der Karte verknüpft.
setTilt	setTilt(tilt) Parameter:  tilt:  number Rückgabewert:Keine Legt für Vektorkarten den Einfallswinkel der Karte fest. Die zulässigen Werte sind abhängig von der Zoomstufe der Karte beschränkt. Steuert bei Rasterkarten das Verhalten beim automatischen Wechsel für den Einfallswinkel der Karte. Die einzigen zulässigen Werte sind 0 und 45. setTilt(0) bewirkt, dass die Karte unabhängig von Zoomstufe und Darstellungsbereich immer eine Draufsicht von 0° verwendet. setTilt(45) bewirkt, dass der Neigungswinkel automatisch auf 45 wechselt, wenn 45°-Bilder für die aktuelle Zoomstufe und den aktuellen Darstellungsbereich verfügbar sind. Wenn keine 45°-Bilder verfügbar sind, wechselt der Wert wieder zurück zu 0 (Standardeinstellung). 45°-Bilder sind nur für die Kartentypen satellite und hybrid an einigen Standorten und bei bestimmten Zoomstufen verfügbar. Hinweis: getTilt gibt den aktuellen Neigungswinkel zurück und nicht den durch setTilt festgelegten Wert. Da sich getTilt und setTilt auf unterschiedliche Dinge beziehen, verwenden Sie für die tilt-Property nicht bind(). Das kann unvorhersehbare Auswirkungen haben.
setZoom	setZoom(zoom) Parameter:  zoom:  number Größere Zoomwerte entsprechen einer höheren Auflösung. Rückgabewert:Keine Legt die Zoomstufe der Karte fest.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Veranstaltungen
bounds_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die Darstellungsbereichsgrenzen geändert haben.
center_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die center-Eigenschaft der Karte ändert.
click	function(event) Argumente:  event:  MapMouseEvent|IconMouseEvent Dieses Ereignis wird ausgelöst, wenn der Nutzer auf die Karte klickt. Ein MapMouseEvent mit Eigenschaften für den angeklickten Standort wird zurückgegeben, sofern nicht auf ein Ortssymbol geklickt wurde. In diesem Fall wird ein IconMouseEvent mit einer Orts-ID zurückgegeben. IconMouseEvent und MapMouseEvent sind identisch, abgesehen davon, dass IconMouseEvent das Feld für die Orts-ID aufweist. Das Ereignis kann immer als MapMouseEvent behandelt werden, wenn die Orts-ID nicht wichtig ist. Das Klickereignis wird nicht ausgelöst, wenn auf eine Markierung oder ein Infofenster geklickt wurde.
contextmenu	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis tritt ein, wenn das DOM-Kontextmenüereignis für den Kartencontainer ausgelöst wird.
dblclick	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn der Nutzer auf die Karte doppelklickt. Das Klickereignis wird manchmal einmal und manchmal zweimal direkt vor diesem ausgelöst.
drag	function() Argumente:Keine Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer die Karte verschiebt.
dragend	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn der Nutzer das Verschieben der Karte beendet.
dragstart	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, die Karte zu verschieben.
heading_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft "Richtung" der Karte ändert.
idle	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn die Karte nach dem Schwenken oder Zoomen inaktiv wird.
isfractionalzoomenabled_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft isFractionalZoomEnabled geändert hat.
mapcapabilities_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die Kartenfunktionen ändern.
maptypeid_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die mapTypeId-Eigenschaft ändert.
mousemove	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird immer dann ausgelöst, wenn der Nutzer den Mauszeiger über dem Kartencontainer bewegt.
mouseout	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn der Nutzer mit dem Mauszeiger den Kartencontainer verlässt.
mouseover	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn der Nutzer den Mauszeiger in den Kartencontainer hineinbewegt.
projection_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die "projection" geändert hat.
renderingtype_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich der RenderingType geändert hat.
tilesloaded	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn die sichtbaren Kacheln vollständig geladen sind.
tilt_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft "Neigen" der Karte ändert.
zoom_changed	function() Argumente:Keine Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft "Zoom" der Karte ändert.
rightclick	Verworfen:Verwenden Sie stattdessen das Ereignis Map.contextmenu, um Nutzungsmuster wie „Strg + Klick“ unter macOS zu unterstützen. function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn der Nutzer mit der rechten Maustaste auf die Karte klickt.

MapOptions-Schnittstelle

google.maps.MapOptions-Schnittstelle

MapOptions-Objekt zum Definieren der Eigenschaften, die für eine Map festgelegt werden können.

Attribute
backgroundColor optional	Typ:string optional Für den Hintergrund der Karten-Div verwendete Farbe. Diese Farbe ist sichtbar, wenn noch keine Kacheln geladen wurden, wenn der Nutzer schwenkt. Diese Option kann nur festgelegt werden, wenn die Karte initiiert ist.
center optional	Typ:LatLng|LatLngLiteral optional Anfängliches Kartenzentrum.
clickableIcons optional	Typ:boolean optional Standard: true Wenn false, sind Kartensymbole nicht anklickbar. Ein Kartensymbol repräsentiert einen POI, der auch als POI bezeichnet wird.
controlSize optional	Typ:number optional Größe der auf der Karte angezeigten Steuerelemente in Pixeln. Dieser Wert muss direkt beim Erstellen der Karte angegeben werden. Wenn Sie diesen Wert später aktualisieren, können die Steuerelemente in den Status undefined versetzt werden. Regelt nur die Steuerelemente, die vom Google Maps-API selbst vorgenommen werden. Skaliert keine vom Entwickler erstellten benutzerdefinierten Steuerelemente.
disableDefaultUI optional	Typ:boolean optional Aktiviert/deaktiviert alle Schaltflächen der Standardbenutzeroberfläche. Kann im Einzelfall außer Kraft gesetzt werden. Die Tastatursteuerungen, die separat über die Option MapOptions.keyboardShortcuts gesteuert werden, werden nicht deaktiviert. Touch-Gesten, die separat über die Option „MapOptions.gestureHandling“ gesteuert werden, werden nicht deaktiviert.
disableDoubleClickZoom optional	Typ:boolean optional Aktiviert/deaktiviert das Zoomen und Zentrieren durch Doppelklick. Standardmäßig aktiviert. Hinweis: Diese Eigenschaft wird nicht empfohlen. Um das Zoomen beim Doppelklicken zu deaktivieren, können Sie die Eigenschaft gestureHandling verwenden und auf "none" setzen.
draggable optional	Eingestellt: 2017 verworfen. Wenn Sie das Ziehen auf der Karte deaktivieren möchten, können Sie die Eigenschaft gestureHandling verwenden und auf "none" setzen. Typ:boolean optional Wenn false, wird verhindert, dass die Karte gezogen wird. Verschieben ist standardmäßig aktiviert.
draggableCursor optional	Typ:string optional Der Name oder die URL des Cursors, der angezeigt werden soll, wenn die Maus über eine verschiebbare Karte bewegt wird. Diese Property verwendet das CSS-Attribut cursor, um das Symbol zu ändern. Wie bei der CSS-Property müssen Sie mindestens einen Fallback-Cursor angeben, der keine URL ist. Beispiel: draggableCursor: 'url(http://www.example.com/icon.png), auto;'
draggingCursor optional	Typ:string optional Der Name oder die URL des Cursors, der angezeigt werden soll, wenn die Karte gezogen wird. Diese Property verwendet das CSS-Attribut cursor, um das Symbol zu ändern. Wie bei der CSS-Property müssen Sie mindestens einen Fallback-Cursor angeben, der keine URL ist. Beispiel: draggingCursor: 'url(http://www.example.com/icon.png), auto;'
fullscreenControl optional	Typ:boolean optional Der Aktivierungs-/Deaktivierungsstatus des Vollbildsteuerelements.
fullscreenControlOptions optional	Typ:FullscreenControlOptions optional Die Anzeigeoptionen für das Vollbildsteuerelement.
gestureHandling optional	Typ:string optional Diese Einstellung steuert, wie die API Touch-Gesten auf der Karte verarbeitet. Zulässige Werte: "cooperative": Mit Scroll-Ereignissen und Touch-Gesten mit einem Finger lässt sich die Seite scrollen. Die Karte wird nicht gezoomt oder geschwenkt. Touch-Gesten mit zwei Fingern schwenken und zoomen die Karte. Scroll-Ereignisse mit gedrückter Strg- oder ⌘-Taste und Zoomen der Karte. In diesem Modus funktioniert die Karte mit der Seite zusammen. "greedy": Mit allen Touch-Gesten und Scroll-Ereignissen lässt sich die Karte schwenken oder zoomen. "none": Die Karte kann nicht durch Nutzergesten geschwenkt oder gezoomt werden. "auto": (Standardeinstellung) Die Gestenhandhabung erfolgt entweder kooperativ oder gierig, je nachdem, ob die Seite scrollbar ist oder sich in einem iFrame befindet.
heading optional	Typ:number optional Die Richtung von Luftbildern in Grad, gemessen im Uhrzeigersinn ausgehend von der Himmelsrichtung Norden. Richtungen rasten im nächsten verfügbaren Winkel ein, für den Bildmaterial zur Verfügung steht.
isFractionalZoomEnabled optional	Typ:boolean optional Standardeinstellung:true für Vektorkarten und false für Rasterkarten Legt fest, ob die Karte Zoomstufen für Bruchwerte zulassen soll. Hören Sie sich isfractionalzoomenabled_changed an, um zu erfahren, wann die Standardeinstellung festgelegt wurde.
keyboardShortcuts optional	Typ:boolean optional Bei false kann die Karte nicht über die Tastatur gesteuert werden. Tastaturkürzel sind standardmäßig aktiviert.
mapId optional	Typ:string optional Die Karten-ID der Karte. Dieser Parameter kann nach der Instanziierung einer Karte nicht mehr festgelegt oder geändert werden.
mapTypeControl optional	Typ:boolean optional Anfänglicher Aktivierungs-/Inaktivierungsstatus der Kartentypsteuerung.
mapTypeControlOptions optional	Typ:MapTypeControlOptions optional Anfängliche Anzeigeoptionen für die Kartentypsteuerung.
mapTypeId optional	Typ:MapTypeId|string optional Anfängliche mapTypeId der Karte. Die Standardeinstellung ist ROADMAP.
maxZoom optional	Typ:number optional Die maximale Zoomstufe, die auf der Karte angezeigt wird. Wenn das Feld auf null gesetzt oder weggelassen wird, wird stattdessen die maximale Zoomstufe des aktuellen Kartentyps verwendet. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe.
minZoom optional	Typ:number optional Die minimale Zoomstufe, die auf der Karte angezeigt wird. Wenn das Feld auf null gesetzt oder weggelassen wird, wird stattdessen die minimale Zoomstufe des aktuellen Kartentyps verwendet. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe.
noClear optional	Typ:boolean optional Wenn true, den Inhalt des Map-div-Elements nicht löschen.
panControl optional	Eingestellt:Das Schwenksteuerelement wurde im September 2015 eingestellt. Typ:boolean optional Der Aktivierungs-/Deaktivierungsstatus der Schwenksteuerung.
panControlOptions optional	Eingestellt:Das Schwenksteuerelement wurde im September 2015 eingestellt. Typ:PanControlOptions optional Die Anzeigeoptionen für die Schwenksteuerung.
restriction optional	Typ:MapRestriction optional Definiert eine Grenze, die den für Nutzer zugänglichen Bereich der Karte einschränkt. Wenn die Richtlinie konfiguriert ist, können Nutzer nur schwenken und zoomen, während die Kameraansicht innerhalb der Begrenzungen bleibt.
rotateControl optional	Typ:boolean optional Der Aktivierungs-/Deaktivierungsstatus der Drehsteuerung.
rotateControlOptions optional	Typ:RotateControlOptions optional Die Anzeigeoptionen für die Drehsteuerung.
scaleControl optional	Typ:boolean optional Anfänglicher Aktivierungs-/Deaktivierungsstatus der Maßstabssteuerung.
scaleControlOptions optional	Typ:ScaleControlOptions optional Anfängliche Anzeigeoptionen für die Maßstabssteuerung.
scrollwheel optional	Typ:boolean optional Bei false wird das Zoomen der Karte mit dem Mausrad deaktiviert. Das Scrollrad ist standardmäßig aktiviert. Hinweis: Diese Eigenschaft wird nicht empfohlen. Wenn Sie das Zoomen mit dem Mausrad deaktivieren möchten, können Sie die Eigenschaft gestureHandling verwenden und entweder auf "cooperative" oder "none" festlegen.
streetView optional	Typ:StreetViewPanorama optional Ein StreetViewPanorama, das angezeigt wird, wenn der Street View-Pegman auf die Karte gezogen wird. Wenn kein Panorama angegeben ist, wird ein Standard-StreetViewPanorama in der div der Karte angezeigt, wenn der Pegman gezogen wird.
streetViewControl optional	Typ:boolean optional Der anfängliche Status (aktiviert/deaktiviert) des Street View-Männchen-Steuerelements. Dieses Steuerelement ist Teil der Standardbenutzeroberfläche und sollte auf false festgelegt werden, wenn ein Kartentyp angezeigt wird, für den das Street View-Straßen-Overlay nicht angezeigt werden soll (z.B. ein Kartentyp, der nicht mit Google Earth übereinstimmt).
streetViewControlOptions optional	Typ:StreetViewControlOptions optional Anfängliche Anzeigeoptionen für das Steuerelement des Street View-Männchens.
styles optional	Typ:Array<MapTypeStyle> optional Stile, die auf die einzelnen Standardkartentypen angewendet werden sollen. Bei den Modi satellite/hybrid und terrain gelten diese Stile nur für Labels und Geometrie.
tilt optional	Typ:number optional Legt für Vektorkarten den Einfallswinkel der Karte fest. Die zulässigen Werte sind abhängig von der Zoomstufe der Karte beschränkt. Steuert bei Rasterkarten das Verhalten beim automatischen Wechsel für den Einfallswinkel der Karte. Die einzigen zulässigen Werte sind 0 und 45. Der Wert 0 bewirkt, dass die Karte unabhängig von Zoomstufe und Darstellungsbereich immer eine Draufsicht von 0° verwendet. Der Wert 45 bewirkt, dass der Neigungswinkel automatisch auf 45 wechselt, wenn für die aktuelle Zoomstufe und den aktuellen Darstellungsbereich 45°-Bilder verfügbar sind. Wenn keine 45°-Bilder verfügbar sind, wechselt der Wert wieder zurück zu 0 (Standardeinstellung). 45°-Bilder sind nur für die Kartentypen satellite und hybrid an einigen Standorten und bei bestimmten Zoomstufen verfügbar. Hinweis: getTilt gibt den aktuellen Neigungswinkel und nicht den durch diese Option angegebenen Wert zurück. Da sich getTilt und diese Option auf unterschiedliche Dinge beziehen, sollten Sie das Attribut tilt nicht bind() verwenden. Das kann zu unvorhersehbaren Auswirkungen führen.
zoom optional	Typ:number optional Anfängliche Zoomstufe der Karte. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe. Größere Zoomwerte entsprechen einer höheren Auflösung.
zoomControl optional	Typ:boolean optional Der Aktivierungs-/Deaktivierungsstatus der Zoomsteuerung.
zoomControlOptions optional	Typ:ZoomControlOptions optional Die Anzeigeoptionen für die Zoomsteuerung.

MapElement-Klasse

google.maps.MapElement Klasse

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

MapElement ist eine abgeleitete HTMLElement-Klasse zum Rendern von Karten. Nachdem die maps-Bibliothek geladen wurde, 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>

Intern wird Map verwendet, auf das mit der Property innerMap zugegriffen werden kann.

Benutzerdefiniertes Element:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Diese Klasse erweitert HTMLElement.

Mit dieser Klasse wird MapElementOptions implementiert.

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

Attribute
center	Typ:LatLng|LatLngLiteral optional Der mittlere Breiten- und Längengrad der Karte. HTML-Attribut: <gmp-map center="lat,lng"></gmp-map>
innerMap	Typ:Map Ein Verweis auf die Map, die das MapElement intern verwendet.
mapId	Typ:string optional Die Karten-ID der Karte. Weitere Informationen finden Sie in der Dokumentation zu Karten-IDs. HTML-Attribut: <gmp-map map-id="string"></gmp-map>
zoom	Typ:number optional Die Zoomstufe der Karte. HTML-Attribut: <gmp-map zoom="number"></gmp-map>

Slots
control-block-end-inline-center	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start	Platziert das Element mit der Anzeigenfläche an der Position ControlPosition.INLINE_START_BLOCK_START.

Methoden
addEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. addEventListener(type, listener[, options]) Parameter:  type:  string Ein String mit Groß- und Kleinschreibung, der den Ereignistyp darstellt, auf den gewartet werden soll. listener:  EventListener|EventListenerObject Das Objekt, das eine Benachrichtigung empfängt. Dies muss eine Funktion oder ein Objekt mit der Methode handleEvent 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 geliefert wird. Siehe addEventListener.
removeEventListener	Hinweis:Nur im v=beta-Kanal verfügbar. removeEventListener(type, listener[, options]) Parameter:  type:  string Ein String, der den Typ des Ereignisses angibt, für das ein Event-Listener entfernt werden soll. listener:  EventListener|EventListenerObject Der Event-Listener des Event-Handlers, der aus dem Ereignisziel entfernt werden soll. options:  boolean|EventListenerOptions optional Siehe Optionen Rückgabewert:  void Entfernt einen Event-Listener, der zuvor mit addEventListener registriert wurde, aus dem Ziel. Siehe removeEventListener.

Veranstaltungen
gmp-zoomchange	function(event) Argumente:  event:  ZoomChangeEvent Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft "Zoom" der Karte ändert.

MapElementOptions-Schnittstelle

google.maps.MapElementOptions-Schnittstelle

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

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

Attribute
center optional	Typ:LatLng|LatLngLiteral optional Anfängliches Kartenzentrum.
mapId optional	Typ:string optional Die Karten-ID der Karte. Dieser Parameter kann nach der Instanziierung einer Karte nicht mehr festgelegt oder geändert werden.
zoom optional	Typ:number optional Anfängliche Zoomstufe der Karte. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe. Größere Zoomwerte entsprechen einer höheren Auflösung.

ZoomChangeEvent-Klasse

google.maps.ZoomChangeEvent Klasse

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

Dieses Ereignis wurde aufgrund einer Monitoring-Zoomänderung erstellt.

Diese Klasse erweitert Event.

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

MapTypeStyle-Schnittstelle

google.maps.MapTypeStyle-Schnittstelle

Das MapTypeStyle ist eine Sammlung von Selektoren und Stylern, die den Stil der Karte definieren. Selektoren geben die Kartenelemente und/oder -elemente an, die betroffen sein sollen, und Styler geben an, wie diese Merkmale und Elemente geändert werden sollen. Weitere Informationen finden Sie in der Stilreferenz.

Attribute
stylers	Typ:Array<Object> Die Stilregeln, die auf die ausgewählten Kartenelemente und -elemente angewendet werden sollen. Die Regeln werden in der Reihenfolge angewendet, die Sie in diesem Array angeben. Richtlinien zur Verwendung und zu zulässigen Werten finden Sie in der Stilreferenz.
elementType optional	Typ:string optional Das Element, auf das ein Styler angewendet werden soll. Ein -Element ist ein visueller Aspekt eines Elements auf der Karte. Beispiele: eine Beschriftung, ein Symbol, die auf die Geometrie angewendete Kontur oder Füllung usw. Optional. Wenn elementType nicht angegeben ist, wird angenommen, dass der Wert 'all' ist. Weitere Informationen zur Verwendung und zu zulässigen Werten finden Sie in der Stilreferenz.
featureType optional	Typ:string optional Die Funktion oder Gruppe von Merkmalen, auf die ein Styler angewendet werden soll. Optional. Wenn featureType nicht angegeben ist, wird angenommen, dass der Wert 'all' ist. Weitere Informationen zur Verwendung und zu zulässigen Werten finden Sie in der Stilreferenz.

MapMouseEvent-Schnittstelle

google.maps.MapMouseEvent-Schnittstelle

Dieses Objekt wird von verschiedenen Mausereignissen auf der Karte und auf Overlays zurückgegeben und enthält alle unten gezeigten Felder.

Attribute
domEvent	Typ:MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event Das entsprechende native DOM-Ereignis. Entwickler sollten sich nicht darauf verlassen, dass die Properties target, currentTarget, relatedTarget und path definiert und einheitlich sind. Entwickler sollten sich nicht auf die DOM-Struktur der internen Implementierung der Maps API verlassen. Aufgrund der internen Ereigniszuordnung kann domEvent eine andere Semantik als MapMouseEvent haben (z.B. kann ein MapMouseEvent-Klick ein domEvent vom Typ KeyboardEvent haben).
latLng optional	Typ:LatLng optional Die geografische Breite/Länge, die sich unter dem Cursor befand, als das Ereignis eintrat.

Methoden
stop	stop() Parameter:Keine Rückgabewert:  void Verhindert, dass dieses Ereignis weiter verbreitet wird.

IconMouseEvent-Schnittstelle

google.maps.IconMouseEvent-Schnittstelle

Dieses Objekt wird in einem Ereignis gesendet, wenn ein Nutzer auf ein Symbol auf der Karte klickt. Die Orts-ID dieses Ortes wird im „placeId“-Mitglied gespeichert. Um zu verhindern, dass das Standardinfofenster angezeigt wird, rufen Sie die Methode stop() für dieses Ereignis auf, damit es nicht weitergegeben wird. Weitere Informationen zu Orts-IDs finden Sie im Places API-Entwicklerhandbuch.

Diese Schnittstelle erweitert MapMouseEvent.

Attribute
placeId optional	Typ:string optional Die Orts-ID des Orts, auf den geklickt wurde. Diese Orts-ID kann verwendet werden, um weitere Informationen zu dem angeklickten Element abzufragen. Weitere Informationen zu Orts-IDs finden Sie im Places API-Entwicklerhandbuch.
Übernommen: domEvent, latLng

Methoden
Übernommen: stop

MapTypeId-Konstanten an.

google.maps.MapTypeId-Konstanten

Kennungen für gebräuchliche MapTypes Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'satellite' oder google.maps.MapTypeId.SATELLITE.

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

Konstanten
HYBRID	Bei diesem Kartentyp wird eine transparente Ebene mit den Hauptstraßen auf Satellitenbildern angezeigt.
ROADMAP	Bei diesem Kartentyp wird eine normale Straßenkarte angezeigt.
SATELLITE	Bei diesem Kartentyp werden Satellitenbilder angezeigt.
TERRAIN	Bei diesem Kartentyp werden Karten mit physischen Merkmalen wie Gelände und Vegetation angezeigt.

MapTypeRegistry-Klasse.

google.maps.MapTypeRegistry Klasse

Eine Registrierung für MapType-Instanzen, die nach MapType-ID benannt ist.

Diese Klasse erweitert MVCObject.

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

Konstruktor
MapTypeRegistry	MapTypeRegistry() Parameter:Keine MapTypeRegistry enthält die benutzerdefinierten Kartentypen, die für die Karte verfügbar sind. Die API konsultiert diese Registry, wenn sie beispielsweise die Liste der verfügbaren Kartentypen innerhalb von Steuerelementen bereitstellt.

Methoden
set	set(id, mapType) Parameter:  id:  string ID des Kartentyps, der der Registrierung hinzugefügt werden soll mapType:  MapType|*-Kartentyp, der der Registrierung hinzugefügt werden soll Rückgabewert:Keine Legt fest, dass in der Registrierung der übergebene Zeichenfolgen-Kennzeichner dem übergebenen MapType zugewiesen werden soll.
Übernommen: addListener, bindTo, get, notify, setValues, unbind, unbindAll

MapRestriction-Schnittstelle

google.maps.MapRestriction-Schnittstelle

Eine Einschränkung, die auf die Karte angewendet werden kann. Der Darstellungsbereich der Karte überschreitet diese Einschränkungen nicht.

Attribute
latLngBounds	Typ:LatLngBounds|LatLngBoundsLiteral Wenn die Richtlinie festgelegt ist, kann ein Nutzer nur innerhalb der angegebenen Grenzen schwenken und zoomen. Grenzen können sowohl Längen- als auch Breitengrad oder nur den Breitengrad einschränken. Verwenden Sie für reine Breitengrenzen die westlichen bzw. östlichen Längengrade von -180 bzw. 180, z. B. latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional	Typ:boolean optional Die Grenzen können durch Festlegen des Flags strictBounds auf true weiter eingeschränkt werden. Dadurch wird verhindert, wie weit ein Nutzer herauszoomen kann, und alles, was außerhalb der eingeschränkten Grenzen liegt, bleibt verborgen. Die Standardeinstellung ist false. Das bedeutet, dass ein Nutzer herauszoomen kann, bis der gesamte begrenzte Bereich sichtbar ist, möglicherweise auch Bereiche außerhalb des begrenzten Bereichs.

TrafficLayer-Klasse

google.maps.TrafficLayer Klasse

Eine Verkehrsebene.

Diese Klasse erweitert MVCObject.

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

Konstruktor
TrafficLayer	TrafficLayer([opts]) Parameter:  opts:  TrafficLayerOptions optional Eine Ebene, auf der der aktuelle Straßenverkehr angezeigt wird.

Methoden
getMap	getMap() Parameter:Keine Rückgabewert:  Map Gibt die Karte zurück, auf der diese Ebene angezeigt wird.
setMap	setMap(map) Parameter:  map:  Map Rückgabewert:Keine Gibt die Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt wurde, wird die Ebene entfernt.
setOptions	setOptions(options) Parameter:  options:  TrafficLayerOptions Rückgabewert:Keine
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

TrafficLayerOptions-Schnittstelle

google.maps.TrafficLayerOptions-Schnittstelle

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

Attribute
autoRefresh optional	Typ:boolean optional Standard: true Gibt an, ob die Verkehrsebene automatisch mit aktualisierten Informationen aktualisiert wird.
map optional	Typ:Map optional Karte, auf der die Verkehrslagenebene angezeigt werden soll.

TransitLayer-Klasse

google.maps.TransitLayer Klasse

Ebene für öffentliche Verkehrsmittel.

Diese Klasse erweitert MVCObject.

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

Konstruktor
TransitLayer	TransitLayer() Parameter:Keine Eine Ebene, auf der ÖPNV-Linien angezeigt werden.

Methoden
getMap	getMap() Parameter:Keine Rückgabewert:  Map Gibt die Karte zurück, auf der diese Ebene angezeigt wird.
setMap	setMap(map) Parameter:  map:  Map Rückgabewert:Keine Gibt die Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt wurde, wird die Ebene entfernt.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

BicyclingLayer-Klasse

google.maps.BicyclingLayer Klasse

Eine Ebene, auf der Fahrradwege und Fahrradspuren angezeigt werden.

Diese Klasse erweitert MVCObject.

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

Konstruktor
BicyclingLayer	BicyclingLayer() Parameter:Keine Eine Ebene, auf der Fahrradwege und Fahrradspuren angezeigt und große Straßen zurückgestuft werden.

Methoden
getMap	getMap() Parameter:Keine Rückgabewert:  Map Gibt die Karte zurück, auf der diese Ebene angezeigt wird.
setMap	setMap(map) Parameter:  map:  Map Rückgabewert:Keine Gibt die Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt wurde, wird die Ebene entfernt.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

CameraOptions-Schnittstelle

google.maps.CameraOptions-Schnittstelle

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

Wird zum Festlegen der Kameraoptionen der Karte verwendet.

Attribute
center optional	Typ:LatLngLiteral|LatLng optional
heading optional	Typ:number optional
tilt optional	Typ:number optional
zoom optional	Typ:number optional

VisibleRegion-Schnittstelle

google.maps.VisibleRegion-Schnittstelle

Enthält die vier Punkte, die das vierseitige Polygon definieren, das den sichtbaren Bereich der Karte darstellt. Auf einer Vektorkarte kann dieses Polygon ein Trapez statt eines Rechtecks sein, wenn eine Vektorkarte geneigt ist.

Attribute
farLeft	Typ:LatLng
farRight	Typ:LatLng
latLngBounds	Typ:LatLngBounds Der kleinste Begrenzungsrahmen, der den sichtbaren Bereich enthält.
nearLeft	Typ:LatLng
nearRight	Typ:LatLng

RenderingType-Konstanten

google.maps.RenderingType-Konstanten

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

Konstanten
RASTER	Gibt an, dass die Karte eine Rasterkarte ist.
UNINITIALIZED	Gibt an, dass noch nicht bekannt ist, ob es sich um eine Vektor- oder Rasterkarte handelt, da die Initialisierung der Karte noch nicht abgeschlossen ist.
VECTOR	Gibt an, dass die Karte eine Vektorkarte ist.

MapCapabilities-Schnittstelle

google.maps.MapCapabilities-Schnittstelle

Objekt, das einen Snapshot der aktuell für die Karte verfügbaren Funktionen enthält. Beachten Sie, dass dies nicht unbedingt bedeutet, dass relevante Module geladen oder initialisiert werden, sondern dass die aktuelle Karte über die Berechtigung zur Verwendung dieser APIs verfügt. Eine Liste der möglichen Funktionen finden Sie in den Eigenschaften.

Attribute
isAdvancedMarkersAvailable optional	Typ:boolean optional Bei Einstellung auf "true" ist diese Karte ordnungsgemäß konfiguriert und ermöglicht die Verwendung erweiterter Markierungen. Beachten Sie, dass Sie die marker-Bibliothek trotzdem importieren müssen, um erweiterte Markierungen verwenden zu können. Weitere Informationen finden Sie unter https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional	Typ:boolean optional Bei Einstellung auf „true“ ist diese Karte so konfiguriert, dass datengestützte Stile für mindestens ein FeatureLayer verwendet werden können. Weitere Informationen finden Sie unter https://goo.gle/gmp-data-driven-styling und https://goo.gle/gmp-FeatureLayerIsAvailable.