Maps

Map-Klasse

google.maps.Map Klasse

Diese Klasse erweitert MVCObject.

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

Map
Map(mapDiv[, opts])
Parameter:
  • mapDivHTMLElement Die Karte wird so gerendert, dass dieses Element ausgefüllt wird.
  • optsMapOptions optional Optionen
Erstellt eine neue Karte innerhalb des angegebenen HTML-Containers, bei dem es sich in der Regel um ein DIV-Element handelt.
DEMO_MAP_ID Karten-ID, die für Codebeispiele verwendet werden kann, in denen eine Karten-ID erforderlich ist Die Karten-ID ist nicht für Produktionsanwendungen vorgesehen und kann nicht für Funktionen verwendet werden, die eine Cloud-Konfiguration erfordern, z. B. das cloudbasierte Gestalten von Karteninhalten.
controls
Fügt der Karte zusätzliche Steuerelemente hinzu. Um der Karte ein Steuerelement hinzuzufügen, fügen Sie die <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üge diesem Data-Objekt Elemente hinzu, damit sie bequem auf der Karte angezeigt werden können.
mapTypes
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, mit der sie verknüpft sind, und zwar in der Reihenfolge, in der sie im overlayMapTypes-Array erscheinen. Overlays mit höheren Indexwerten werden vor Overlays mit niedrigeren Indexwerten angezeigt.
fitBounds
fitBounds(bounds[, padding])
Parameter:
  • boundsLatLngBounds|LatLngBoundsLiteral Anzuzeigende Grenzen.
  • paddingnumber|Padding optional Abstand in Pixeln. Die Grenzen werden in den Teil der Karte eingepasst, der nach dem Entfernen des Innenrands verbleibt. Ein Zahlenwert hat auf allen vier Seiten den gleichen Abstand. Geben Sie hier 0 an, damit ein fitBounds-Objekt aufgrund von getBounds idempotent wird.
Rückgabewert:Keine
Legt fest, dass die angegebenen Grenzen für den Darstellungsbereich gelten.
Hinweis:Wenn für die Karte display: none festgelegt ist, wird die Größe der Karte mit der fitBounds-Funktion als 0 x 0 gelesen und daher nichts ausgeführt. Wenn Sie den Darstellungsbereich ändern möchten, während die Karte ausgeblendet ist, legen Sie für die Karte visibility: hidden fest. So muss das „div“-Element der Karte eine tatsächliche Größe haben. Bei Vektorkarten werden mit dieser Methode Neigung und Ausrichtung der Karte auf den Standardwert null gesetzt. Das Aufrufen dieser Methode kann zu einer flüssigen Animation führen, wenn die Karte geschwenkt und gezoomt wird, damit sie in die Begrenzungen passt. Ob diese Methode animiert wird, hängt von einer internen Heuristik ab.
getBounds
getBounds()
Parameter:Keine
Rückgabewert:  LatLngBounds|undefined Die Breiten- und 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ängengrenzen von -180 bis einschließlich 180 Grad. Wenn die Karte noch nicht initialisiert oder der Mittelpunkt und der Zoom nicht festgelegt wurde, ist das Ergebnis undefined. Bei Vektorkarten mit Neigung oder Ausrichtung ungleich null stellen die zurückgegebenen Breiten- und 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 Kartenmitte angezeigt wird. Beachten Sie, dass dieses LatLng-Objekt nicht umschlossen ist. Weitere Informationen findest du in den LatLng. Wenn kein Mittelpunkt oder keine Grenzen festgelegt wurden, ist 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. Wird der Wert true zurückgegeben, sind die Symbole auf der Karte anklickbar.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parameter:
  • datasetIdstring
Rückgabewert:  FeatureLayer
Gibt das 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 keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln, keine Featureebenen oder Datasets mit datengestützten Stilen, die im Kartenstil konfiguriert sind), wird ein Fehler protokolliert und der resultierende FeatureLayer.isAvailable ist „false“.
getDiv
getDiv()
Parameter:Keine
Rückgabewert:HTMLElement Die Markierung „mapDiv“ der Karte.
getFeatureLayer
getFeatureLayer(featureType)
Parameter:
Rückgabewert:  FeatureLayer
Gibt den FeatureLayer der angegebenen FeatureType zurück. Ein FeatureLayer muss in der Google Cloud Console aktiviert sein. Wenn eine FeatureLayer der angegebenen FeatureType auf dieser Karte nicht vorhanden ist oder wenn keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln oder keine FeatureLayer im Kartenstil aktiviert), wird ein Fehler protokolliert und die 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 aktuellen Funktionen, die basierend auf der bereitgestellten Karten-ID für die Karte verfügbar sind.
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 Ereignis projection_changed 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 die an die Karte gebundene Standard-StreetViewPanorama zurück, bei der es sich um ein in die Karte eingebettetes Standardpanorama handeln oder um das Panorama, das mit setStreetView() festgelegt wurde. Änderungen an streetViewControl der Karte spiegeln sich in der Anzeige eines solchen verknüpften Panoramas wider.
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. Für Rasterkarten ist das Ergebnis 0 für Bilder, die direkt über der Erde 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. Wurde der Zoom nicht festgelegt, ist das Ergebnis undefined.
moveCamera
moveCamera(cameraOptions)
Parameter:
Rückgabewert:Keine
Setzt die Kamera der Karte sofort auf die Zielkameraoptionen ohne Animation.
panBy
panBy(x, y)
Parameter:
  • xnumber Anzahl der Pixel, mit der die Karte in x-Richtung verschoben wird.
  • ynumber 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:
Rückgabewert:Keine
Ändert den Mittelpunkt 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:
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral Die Grenzen, zu denen die Karte geschwenkt werden soll.
  • paddingnumber|Padding optional Abstand in Pixeln. Ein Zahlenwert hat auf allen vier Seiten den gleichen Abstand. Der Standardwert ist 0.
Rückgabewert:Keine
Schwenkt die Karte um das geringstnötige Stück, sodass sie das angegebene LatLngBounds-Objekt enthält. Es wird nicht garantiert, wo sich die Grenzen auf der Karte befinden, sondern nur, dass die Karte so geschwenkt wird, dass so viel 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:
Rückgabewert:Keine
setClickableIcons
setClickableIcons(value)
Parameter:
  • valueboolean
Rückgabewert:Keine
Steuert, ob die Kartensymbole anklickbar sind oder nicht. Ein Kartensymbol repräsentiert einen POI, der auch als POI bezeichnet wird. Wenn Sie die Anklickbarkeit von Kartensymbolen deaktivieren möchten, übergeben Sie einen Wert von false an diese Methode.
setHeading
setHeading(heading)
Parameter:
  • headingnumber
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 Flugaufnahmen.
setMapTypeId
setMapTypeId(mapTypeId)
Parameter:
Rückgabewert:Keine
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keine
setStreetView
setStreetView(panorama)
Parameter:
  • panoramaStreetViewPanorama optional Das Panorama, das an die Karte gebunden werden soll.
Rückgabewert:Keine
Bindet einen StreetViewPanorama an die 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:
  • tiltnumber
Rückgabewert:Keine
Legt für Vektorkarten den Einfallswinkel der Karte fest. Die zulässigen Werte sind abhängig von der Zoomstufe der Karte eingeschränkt. Bei Rasterkarten wird damit das Verhalten beim automatischen Wechsel für den Einfallswinkel der Karte gesteuert. Die einzigen zulässigen Werte sind 0 und 45. setTilt(0) führt dazu, dass die Karte unabhängig von Zoomstufe und Darstellungsbereich immer eine Draufsicht von 0° verwendet. setTilt(45) bewirkt, dass der Neigungswinkel automatisch auf 45 umgestellt wird, sobald 45°-Bilder für die aktuelle Zoomstufe und den Darstellungsbereich verfügbar sind, und wieder auf 0, wenn keine 45°-Bilder verfügbar sind (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, nicht den durch setTilt festgelegten Wert. Da sich getTilt und setTilt auf unterschiedliche Dinge beziehen, solltest du die tilt-Eigenschaft nicht bind() verwenden. Dies kann zu unvorhersehbaren Auswirkungen führen.
setZoom
setZoom(zoom)
Parameter:
  • zoomnumber Größere Zoomwerte entsprechen einer höheren Auflösung.
Rückgabewert:Keine
Legt den Zoom der Karte fest.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer auf die Karte klickt. Ein MapMouseEvent mit Eigenschaften für die angeklickte Position 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 über das Feld für die Orts-ID verfügt. 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: 
Dieses Ereignis tritt ein, wenn das DOM-Kontextmenüereignis für den Kartencontainer ausgelöst wird.
dblclick
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer auf die Karte doppelklickt. Beachten Sie, dass das Klickereignis manchmal einmal und manchmal zweimal direkt vor diesem ausgelöst wird.
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: 
Dieses Ereignis wird immer dann ausgelöst, wenn der Nutzer den Mauszeiger über dem Kartencontainer bewegt.
mouseout
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer mit dem Mauszeiger den Kartencontainer verlässt.
mouseover
function(event)
Argumente: 
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
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer mit der rechten Maustaste auf die Karte klickt.

MapOptions-Schnittstelle

google.maps.MapOptions-Schnittstelle

MapOptions-Objekt, mit dem die Eigenschaften definiert werden, die für eine Karte festgelegt werden können.

backgroundColor optional
Typ:string optional
Für den Hintergrund der Karten-div verwendete Farbe. Diese Farbe ist sichtbar, wenn beim Schwenken noch keine Kacheln geladen wurden. 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
Standardwert: 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 ihn später aktualisieren, werden die Steuerelemente möglicherweise in den Status undefined versetzt. Steuert nur die Steuerelemente der Google Maps API selbst. Skaliert nicht vom Entwickler erstellte benutzerdefinierte Steuerelemente.
disableDefaultUI optional
Typ:boolean optional
Aktiviert/deaktiviert alle UI-Standardschaltflächen. Kann im Einzelfall außer Kraft gesetzt werden. Die Tastatursteuerung, die separat über die Option MapOptions.keyboardShortcuts gesteuert wird, wird nicht deaktiviert. Die Gestensteuerung wird nicht deaktiviert, die separat über die Option MapOptions.gestureHandling gesteuert wird.
disableDoubleClickZoom optional
Typ:boolean optional
Aktiviert/deaktiviert das Zoomen und Zentrieren durch Doppelklick. Standardmäßig aktiviert.

Hinweis: Diese Property wird nicht empfohlen. Um das Zoomen beim Doppelklicken zu deaktivieren, können Sie die Eigenschaft gestureHandling verwenden und auf "none" setzen.

draggable optional
Typ:boolean optional
Bei 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 der Mauszeiger über eine verschiebbare Karte bewegt wird. Bei dieser Eigenschaft wird das CSS-Attribut cursor verwendet, 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 beim Ziehen der Karte angezeigt werden soll. Bei dieser Eigenschaft wird das CSS-Attribut cursor verwendet, 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
Die Anzeigeoptionen für das Steuerelement für den Vollbildmodus.
gestureHandling optional
Typ:string optional
Mit dieser Einstellung wird festgelegt, wie die API Touch-Gesten auf der Karte verarbeitet. Zulässige Werte:
  • "cooperative": Scroll-Ereignisse und Touch-Gesten mit einem Finger lassen sich auf der Seite scrollen. Die Karte wird weder gezoomt noch geschwenkt. Mit zwei Fingern wird die Karte geschwenkt und gezoomt. Scroll-Ereignisse bei gedrückter Strg- oder ⌘-Taste zum Zoomen der Karte.
    In diesem Modus kooperiert die Karte mit der Seite.
  • "greedy": Bei allen Touch-Gesten und Scroll-Ereignissen wird die Karte geschwenkt oder gezoomt.
  • "none": Die Karte kann nicht durch Nutzergesten geschwenkt oder gezoomt werden.
  • "auto": (Standardeinstellung) Die Gestenhandhabung erfolgt entweder kooperative 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
Gibt an, ob die Karte Zoomstufen nach Bruchwerten zulassen soll. Höre dir isfractionalzoomenabled_changed an, um zu erfahren, wann die Standardeinstellung festgelegt wurde.
keyboardShortcuts optional
Typ:boolean optional
Bei false wird verhindert, dass die Karte über die Tastatur gesteuert wird. 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
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 er weggelassen oder auf null gesetzt ist, 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 der Wert true lautet, löschen Sie nicht den Inhalt des Karten-div-Elements.
panControl optional
Typ:boolean optional
Der Aktivierungs-/Deaktivierungsstatus der Schwenksteuerung.

panControlOptions optional
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 diese Richtlinie aktiviert ist, kann der Nutzer nur schwenken und zoomen, solange die Kameraansicht innerhalb der Begrenzungen liegt.
rotateControl optional
Typ:boolean optional
Der Aktivierungs-/Deaktivierungsstatus der Drehsteuerung.
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 Scrollrad der Maus deaktiviert. Das Scrollrad ist standardmäßig aktiviert.

Hinweis: Diese Property wird nicht empfohlen. Wenn du das Zoomen mit dem Scrollrad deaktivieren möchtest, kannst du die Eigenschaft gestureHandling verwenden und entweder auf "cooperative" oder "none" setzen.

streetView optional
Typ:StreetViewPanorama optional
Ein StreetViewPanorama, das angezeigt wird, wenn das Street View-Pegman auf die Karte gezogen wird. Wenn kein Panorama angegeben ist, wird beim Auflegen des Pegman ein standardmäßiges StreetViewPanorama im div der Karte angezeigt.
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 gesetzt werden, wenn ein Kartentyp angezeigt wird, in dem das Street View-Straßen-Overlay nicht erscheinen soll (z.B. bei Kartentypen, die keine Google Earth-Karten sind).
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 werden diese Stile nur auf Labels und Geometrie angewendet.
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 eingeschränkt. Bei Rasterkarten wird damit das Verhalten beim automatischen Wechsel für den Einfallswinkel der Karte gesteuert. Die einzigen zulässigen Werte sind 0 und 45. Der Wert 0 führt dazu, dass die Karte unabhängig von Zoomstufe und Darstellungsbereich immer eine Draufsicht von 0° verwendet. Der Wert 45 sorgt dafür, dass der Neigungswinkel automatisch auf 45 umgestellt wird, sobald 45°-Bilder für die aktuelle Zoomstufe und den Darstellungsbereich verfügbar sind, und wieder auf 0, wenn keine 45°-Bilder verfügbar sind (dies ist die 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 die Eigenschaft tilt nicht bind() verwenden, da dies unvorhersehbare Auswirkungen haben kann.
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

MapElement ist eine HTMLElement-Unterklasse 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 über const {MapElement} = await google.maps.importLibrary("maps") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

MapElement
MapElement([options])
Parameter:
center
Typ:LatLng|LatLngLiteral optional
Der Breiten-/Längengrad der Mitte 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 zur Karten-ID.
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>
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.
default
Mithilfe von benutzerdefinierten Elementen können Sie wiederverwendbare Komponenten wie AdvancedMarkerElement um die Maps JavaScript-Webkomponenten herum erstellen. Standardmäßig werden alle benutzerdefinierten Elemente, die direkt zu MapElement hinzugefügt werden, auf einer Anzeigenfläche eingefügt und in MapPanes.overlayMouseTarget gerendert. Die Maps JavaScript API-Webkomponenten können jedoch wieder in die internen Slots des MapElement verschoben werden.
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter:
  • typestring Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Dabei wird die Groß- und Kleinschreibung berücksichtigt.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung empfängt. Dies muss eine Funktion oder ein Objekt mit der Methode "handleEvent" sein
  • optionsboolean|AddEventListenerOptions optional Weitere Informationen finden Sie unter 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.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter:
  • typestring Ein String, der die Art des Ereignisses angibt, für das ein Ereignis-Listener entfernt werden soll.
  • listenerEventListener|EventListenerObject Der Event-Listener des Event-Handlers, der aus dem Ereignisziel entfernt werden soll.
  • optionsboolean|EventListenerOptions optional Siehe Optionen
Rückgabewert:  void
Entfernt einen Event-Listener, der zuvor mit addEventListener registriert wurde, aus dem Ziel. Siehe removeEventListener.
gmp-zoomchange
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft "Zoom" der Karte ändert.

MapElementOptions-Schnittstelle

google.maps.MapElementOptions-Schnittstelle

MapElementOptions-Objekt, mit dem die Eigenschaften definiert werden, die für ein MapElement festgelegt werden können.

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

Dieses Ereignis wurde nach dem Monitoring der Zoomänderung erstellt.

Diese Klasse erweitert Event.

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

MapTypeStyle-Schnittstelle

google.maps.MapTypeStyle-Schnittstelle

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 Elemente und Unterelemente geändert werden sollen. Weitere Informationen finden Sie in der Stilreferenz.

stylers
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 zulässigen Werte 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 Kartenelements. Beispiele: ein Label, ein Symbol, der auf die Geometrie angewendete Strich oder die Füllung und mehr. Optional. Ist elementType nicht angegeben, wird 'all' als Wert angenommen. Details zur Verwendung und zu zulässigen Werten finden Sie in der Stilreferenz.
featureType optional
Typ:string optional
Die Funktion oder Gruppe von Funktionen, auf die ein Styler angewendet werden soll. Optional. Ist featureType nicht angegeben, wird 'all' als Wert angenommen. Details 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.

domEvent
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 außerdem nicht auf die DOM-Struktur der internen Implementierung der Google Maps API verlassen. Aufgrund der internen Ereigniszuordnung kann das domEvent eine andere Semantik von der MapMouseEvent haben (z.B. kann ein MapMouseEvent-„Klick“ eine 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.
stop
stop()
Parameter:Keine
Rückgabewert:  void
Verhindert, dass dieses Ereignis weiter verbreitet wird.

IconMouseEvent-Oberfläche

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 Entwicklerleitfaden für die Places API.

Diese Schnittstelle erweitert MapMouseEvent.

placeId optional
Typ:string optional
Die Orts-ID des Orts, auf den geklickt wurde. Mit dieser Orts-ID können weitere Informationen zum angeklickten Element abgefragt werden.

Weitere Informationen zu Orts-IDs finden Sie im Entwicklerleitfaden für die Places API.

Übernommen: domEvent, latLng
Übernommen: stop

MapTypeId-Konstanten

google.maps.MapTypeId-Konstanten

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

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

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 aufgeschlüsselt sind.

Diese Klasse erweitert MVCObject.

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

MapTypeRegistry
MapTypeRegistry()
Parameter:Keine
Das MapTypeRegistry enthält die Sammlung benutzerdefinierter Kartentypen, die der Karte für ihre Verwendung zur Verfügung stehen. Die API greift beispielsweise auf diese Registry zurück, wenn sie die Liste der verfügbaren Kartentypen in Steuerelementen bereitstellt.
set
set(id, mapType)
Parameter:
  • idstring Kennung des Kartentyps, der der Registry hinzugefügt werden soll.
  • mapTypeMapType|*-Kartentyp-Objekt, das 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.

latLngBounds
Wenn diese Richtlinie festgelegt ist, kann der Nutzer nur innerhalb der vorgegebenen Grenzen schwenken und zoomen. Grenzen können sowohl den Längen- als auch den Breitengrad oder nur den Breitengrad einschränken. Verwenden Sie für reine Breitengradgrenzen 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 weiter eingeschränkt werden, indem Sie das Flag strictBounds auf true setzen. Dadurch wird der Zoomfaktor reduziert, sodass alles jenseits der eingeschränkten Begrenzungen verborgen bleibt. Die Standardeinstellung ist false, was 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 über const {TrafficLayer} = await google.maps.importLibrary("maps") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

TrafficLayer
TrafficLayer([opts])
Parameter:
Eine Ebene, auf der der aktuelle Straßenverkehr angezeigt wird.
getMap
getMap()
Parameter:Keine
Rückgabewert:  Map
Gibt die Karte zurück, auf der diese Ebene angezeigt wird.
setMap
setMap(map)
Parameter:
Rückgabewert:Keine
Gibt die Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt ist, wird die Ebene entfernt.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keine
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

TrafficLayerOptions-Schnittstelle.

google.maps.TrafficLayerOptions-Schnittstelle

TrafficLayerOptions-Objekt, das zum Definieren der Eigenschaften für ein TrafficLayer-Objekt verwendet wird.

autoRefresh optional
Typ:boolean optional
Standardwert: true
Legt fest, 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

Eine Ebene für öffentliche Verkehrsmittel.

Diese Klasse erweitert MVCObject.

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

TransitLayer
TransitLayer()
Parameter:Keine
Eine Ebene, auf der ÖPNV-Linien angezeigt werden.
getMap
getMap()
Parameter:Keine
Rückgabewert:  Map
Gibt die Karte zurück, auf der diese Ebene angezeigt wird.
setMap
setMap(map)
Parameter:
Rückgabewert:Keine
Gibt die Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt ist, 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 über const {BicyclingLayer} = await google.maps.importLibrary("maps") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

BicyclingLayer
BicyclingLayer()
Parameter:Keine
Eine Ebene, auf der Fahrradwege und Fahrradspuren angezeigt und große Straßen zurückgestuft werden.
getMap
getMap()
Parameter:Keine
Rückgabewert:  Map
Gibt die Karte zurück, auf der diese Ebene angezeigt wird.
setMap
setMap(map)
Parameter:
Rückgabewert:Keine
Gibt die Ebene auf der angegebenen Karte wieder. Wenn für die Karte null festgelegt ist, wird die Ebene entfernt.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

CameraOptions-Schnittstelle

google.maps.CameraOptions-Schnittstelle

Wird zum Festlegen der Kameraoptionen der Karte verwendet.

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, durch die das vierseitige Polygon definiert wird, das den sichtbaren Bereich der Karte darstellt. Auf einer Vektorkarte kann dieses Polygon ein Trapez statt eines Rechtecks sein, wenn eine Vektorkarte geneigt ist.

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

RenderingType-Konstanten

google.maps.RenderingType-Konstanten

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

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 mit einem Snapshot der aktuell für die Karte verfügbaren Funktionen. Dies bedeutet nicht unbedingt, dass die relevanten 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 unter den Attributen.

isAdvancedMarkersAvailable optional
Typ:boolean optional
Falls wahr, ist diese Karte ordnungsgemäß konfiguriert und ermöglicht die Verwendung erweiterter Markierungen. Die marker-Bibliothek muss weiterhin importiert werden, um erweiterte Markierungen verwenden zu können. Weitere Informationen finden Sie unter https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Typ:boolean optional
Wenn „true“ festgelegt ist, ist diese Karte so konfiguriert, dass für mindestens eine FeatureLayer datengestützte Stile verwendet werden können. Weitere Informationen finden Sie unter https://goo.gle/gmp-data-driven-styling und https://goo.gle/gmp-FeatureLayerIsAvailable.