Maps

Klasse Map

google.maps.Map-Klasse

Diese Klasse erweitert MVCObject.

Durch Aufrufen von 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 gerendert, damit dieses Element gefüllt wird.
  • optsMapOptions optional Optionen
Erstellt eine neue Karte innerhalb des angegebenen HTML-Containers. Dies ist normalerweise ein DIV-Element.
controls
Fügt der Karte zusätzliche Steuerelemente hinzu. Wenn Sie der Karte ein Steuerelement hinzufügen möchten, fügen Sie den <div> des Steuerelements zum MVCArray hinzu, der dem ControlPosition entspricht, in dem das Steuerelement gerendert werden soll.
data
Typ:Data
Eine an die Karte gebundene Instanz von Data. Fügen Sie diesem Data-Objekt Elemente hinzu, um sie bequem auf dieser Karte anzuzeigen.
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, der sie zugeordnet sind, und zwar in der Reihenfolge, in der sie im Array overlayMapTypes erscheinen. Overlays mit höheren Indexwerten werden vor Overlays mit niedrigeren Indexwerten angezeigt.
fitBounds
fitBounds(bounds[, padding])
Parameter:
  • boundsLatLngBounds|LatLngBoundsLiteral Wird angezeigt.
  • paddingnumber|Padding optional Abstand in Pixeln Die Grenzen passen in den Teil der Karte, der nach dem Entfernen des Innenrands erhalten bleibt. Ein Zahlenwert ergibt für alle vier Seiten denselben Abstand. Geben Sie hier 0 ein, um fitBounds idempotent für das Ergebnis von getBounds festzulegen.
Rückgabewert: Keine
Legt fest, dass die angegebenen Grenzen für den Darstellungsbereich gelten.
Hinweis:Wenn die Karte auf display: none gesetzt ist, wird die Größe der Karte mithilfe der Funktion fitBounds als 0 x 0 gelesen. Sie hat daher keine Funktion. Wenn Sie den Darstellungsbereich ändern möchten, während die Karte ausgeblendet ist, setzen Sie die Karte auf visibility: hidden. Dadurch wird sichergestellt, dass das Kartendiv-Element eine tatsächliche Größe hat. Bei Vektorkarten wird bei dieser Methode die Neigung und Ausrichtung der Karte auf die standardmäßigen Nullwerte festgelegt. Das Aufrufen dieser Methode kann zu einer gleichmäßigen Animation führen, da die Karte geschwenkt und vergrößert oder verkleinert wird. 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, können sie mit einem Längengrad zwischen -180 und 180 Grad angegeben werden. Wenn die Karte noch nicht initialisiert oder zentriert ist und kein Zoom festgelegt wurde, ist das Ergebnis undefined. Bei Vektorkarten, deren Neigung oder Ausrichtung nicht null ist, entsprechen die zurückgegebenen Breiten-/Längengrenzen dem kleinsten Begrenzungsrahmen, 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 können.
getCenter
getCenter()
Parameter:Keine
Rückgabewert:  LatLng|undefined
Gibt die Position in der Mitte der Karte zurück Das LatLng-Objekt ist nicht umschlossen. Weitere Informationen findest du in den LatLng. Wenn der Mittelpunkt bzw. die Grenzen nicht festgelegt sind, lautet das Ergebnis undefined.
getClickableIcons
getClickableIcons()
Parameter:Keine
Rückgabewert:  boolean|undefined
Gibt die Anklickbarkeit der Kartensymbole zurück Ein Kartensymbol steht für einen POI. Wenn der zurückgegebene Wert true ist, sind die Symbole auf der Karte anklickbar.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parameter:
  • datasetIdstring
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 keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln, keine datengestützten Stilebenen oder im Kartenstil konfigurierte Datasets), wird ein Fehler protokolliert und das sich ergebende FeatureLayer.isAvailable ist falsch.
getDiv
getDiv()
Parameter:Keine
Rückgabewert: HTMLElement: „divDiv“-Wert der Karte.
getFeatureLayer
getFeatureLayer(featureType)
Parameter:
Rückgabewert:  FeatureLayer
Gibt die FeatureLayer der spezifischen FeatureType zurück. In der Google Cloud Console muss eine FeatureLayer aktiviert sein. Wenn keine FeatureLayer der angegebenen FeatureType auf dieser Karte vorhanden ist oder keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln und keine FeatureLayer im Kartenstil), wird ein Fehler protokolliert und das sich ergebende FeatureLayer.isAvailable ist falsch.
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.
getMapCapabilities
getMapCapabilities()
Parameter:Keine
Rückgabewert:  MapCapabilities
Der Anrufer wird basierend auf der angegebenen Karten-ID über die aktuellen verfügbaren Funktionen für die Karte informiert.
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. Warten Sie auf das Ereignis projection_changed und prüfen Sie, ob der Wert nicht undefined ist.
getRenderingType
getRenderingType()
Parameter:Keine
Rückgabewert:  RenderingType
Gibt den aktuellen Renderingtyp der Karte zurück.
getStreetView
getStreetView()
Parameter:Keine
Rückgabewert:StreetViewPanorama das an die Karte gebundene Panorama.
Gibt das standardmäßige StreetViewPanorama zurück, das an die Karte gebunden ist. Dies kann ein in der Karte eingebettetes Standardpanorama oder das mit setStreetView() festgelegte Panorama sein. Änderungen an der streetViewControl der Karte werden in der Anzeige eines solchen gebundenen Panoramas widergespiegelt.
getTilt
getTilt()
Parameter:Keine
Rückgabewert:  number|undefined
Gibt den aktuellen Einfallswinkel der Karte in Grad von der Darstellungsbereichebene zur Kartenebene zurück. Bei Rasterkarten ist das Ergebnis 0, wenn das Bild direkt über dem Kopf aufgenommen wurde, oder 45 für 45°-Bilder. Diese Methode gibt nicht den von setTilt festgelegten Wert zurück. Weitere Informationen: setTilt.
getZoom
getZoom()
Parameter:Keine
Rückgabewert:  number|undefined
Gibt den Zoom der Karte zurück Wenn der Zoom nicht festgelegt wurde, ist das Ergebnis undefined.
moveCamera
moveCamera(cameraOptions)
Parameter:
Rückgabewert: Keine
Die Karte wird auf der Karte sofort auf die Zielkameraoptionen festgelegt – ohne Animation.
panBy
panBy(x, y)
Parameter:
  • xnumber Die Anzahl der Pixel, die die Karte in x-Richtung verschoben werden soll.
  • ynumber Die Anzahl der Pixel, die die Karte in y-Richtung verschoben werden.
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 ergibt für alle vier Seiten denselben Abstand. Der Standardwert ist 0.
Rückgabewert: Keine
Schwenkt die Karte um den Mindestbetrag, der für die angegebene LatLngBounds erforderlich ist. Es ist nicht garantiert, wo sich die Grenzen auf der Karte befinden, außer dass die Karte so geschwenkt wird, dass so viele der Grenzen wie möglich in {currentMapSizeInPx} - {padding} zu sehen sind. Sowohl für Raster- als auch für 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. Ein Kartensymbol steht für einen POI. Wenn Sie die Anklickbarkeit der Kartensymbole deaktivieren möchten, übergeben Sie den Wert false an diese Methode.
setHeading
setHeading(heading)
Parameter:
  • headingnumber
Rückgabewert: Keine
Legt die Kompassausrichtung der Karte in Grad von der Himmelsrichtung Norden fest. Bei Rasterkarten gilt diese Methode nur für Luftbilder.
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
Verknüpft ein StreetViewPanorama mit der Karte. Dieses Panorama überschreibt das standardmäßige StreetViewPanorama, sodass die Karte an ein externes Panorama außerhalb der Karte gebunden werden kann. Wenn für das Panorama der Wert null festgelegt wird, wird das standardmäßige eingebettete Panorama an die Karte gebunden.
setTilt
setTilt(tilt)
Parameter:
  • tiltnumber
Rückgabewert: Keine
Bei Vektorkarten wird der Einfallswinkel der Karte festgelegt. Die zulässigen Werte sind je nach Zoomstufe der Karte eingeschränkt. Steuert bei Rasterkarten das automatische Schalterverhalten für den Einfallswinkel der Karte. Die einzigen zulässigen Werte sind 0 und 45. setTilt(0) sorgt dafür, dass auf der Karte immer eine Draufsicht von 0 Grad verwendet wird, unabhängig von der Zoomstufe und vom Darstellungsbereich. setTilt(45) führt dazu, dass der Neigungswinkel automatisch auf 45 wechselt, wenn 45°-Bilder für die aktuelle Zoomstufe und den aktuellen Darstellungsbereich verfügbar sind, und auf 0 zurückkehrt, wenn 45°-Bilder nicht verfügbar sind (Standardeinstellung). 45°-Bilder sind nur für die Kartentypen satellite und hybrid, an einigen Standorten und für einige 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, verwenden Sie nicht die bind()-Property tilt. Das kann unvorhersehbare Auswirkungen haben.
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
DEMO_MAP_ID Karten-ID, die für Codebeispiele verwendet werden kann, für die eine Karten-ID erforderlich ist. Die Karten-ID ist nicht für Produktionsanwendungen bestimmt und kann nicht für Funktionen verwendet werden, die eine Cloud-Konfiguration erfordern (z. B. Cloud Styling).
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 den angeklickten Standort wird zurückgegeben, es sei denn, es wurde ein Ortssymbol angeklickt. In diesem Fall wird ein IconMouseEvent mit einer Orts-ID zurückgegeben. IconMouseEvent und MapMouseEvent sind identisch, nur dass IconMouseEvent das Feld für die Orts-ID enthält. Das Ereignis kann immer als MapMouseEvent-Ereignis behandelt werden, wenn die Orts-ID nicht wichtig ist. Das Klickereignis wird nicht ausgelöst, wenn auf eine Markierung oder ein Infofenster geklickt wird.
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. Das Klickereignis wird manchmal einmal, manchmal zweimal, direkt vor diesem Ereignis 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: 
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 Renderingtyp 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

Schnittstelle google.maps.MapOptions

MapOptions-Objekt, mit dem die Attribute definiert werden, die auf einer Karte festgelegt werden können.

backgroundColor optional
Typ:string optional
Die Farbe für den Hintergrund des Map-Divs. Diese Farbe ist sichtbar, wenn noch keine Kacheln geladen wurden und 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, können die Kartensymbole nicht angeklickt werden. Ein Kartensymbol steht für einen POI.
controlSize optional
Typ:number optional
Größe der Steuerelemente, die auf der Karte angezeigt werden, in Pixeln Dieser Wert muss beim Erstellen der Karte direkt angegeben werden. Eine Aktualisierung des Werts kann die Steuerelemente auf undefined setzen. Nur die Steuerelemente der Maps API selbst werden gesteuert. Skaliert keine vom Entwickler erstellten benutzerdefinierten Steuerelemente.
disableDefaultUI optional
Typ:boolean optional
Aktiviert bzw. deaktiviert alle Schaltflächen der Standardbenutzeroberfläche. Kann im Einzelfall außer Kraft gesetzt werden. Deaktiviert keine Tastatursteuerelemente, die separat durch die Option MapOptions.keyboardShortcuts gesteuert werden. Gesten werden nicht deaktiviert. Diese werden separat mit der Option MapOptions.gestureHandling gesteuert.
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" festlegen.

draggable optional
Typ:boolean optional
Mit 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 wird, wenn der Mauszeiger auf eine ziehbare Karte bewegt wird. Bei dieser Eigenschaft wird das CSS-Attribut cursor verwendet, um das Symbol zu ändern. Wie bei der CSS-Eigenschaft 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 wird. Bei dieser Eigenschaft wird das CSS-Attribut cursor verwendet, um das Symbol zu ändern. Wie bei der CSS-Eigenschaft 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
Aktivierung/Deaktivierung der Vollbildsteuerung
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": Scrollen Sie auf der Seite mit Ereignissen und Touch-Gesten mit einem Finger und zoomen oder schwenken Sie die Karte nicht. Touch-Gesten mit zwei Fingern schwenken und zoomen Scrollen Sie mit der Strg-Taste oder der ⌘-Taste, um die Karte zu vergrößern oder zu verkleinern.
    In diesem Modus kooperiert die Karte mit der Seite.
  • "greedy": Bei allen Touch-Gesten und Scrollen wird die Karte geschwenkt oder gezoomt.
  • "none": Die Karte kann nicht durch Nutzerbewegungen geschwenkt oder gezoomt werden.
  • "auto" (Standardeinstellung): Die Gestenhandhabung ist entweder kooperativ oder gierig, je nachdem, ob die Seite scrollbar ist oder in einem iFrame.
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 nur anteilige Zoomstufen zulassen soll. Höre dir isfractionalzoomenabled_changed an, um zu erfahren, wann die Standardeinstellung festgelegt wurde.
keyboardShortcuts optional
Typ:boolean optional
Mit 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. Wird er weggelassen oder auf null gesetzt, wird stattdessen die maximale Zoomstufe des aktuellen Kartentyps verwendet. Gültige Zoomwerte sind Zahlen von null bis zur unterstützten maximalen Zoomstufe.
minZoom optional
Typ:number optional
Die minimale Zoomstufe, die auf der Karte angezeigt wird. Wenn die Markierung weggelassen wird oder auf null gesetzt wird, wird stattdessen die minimale Zoomstufe des aktuellen Kartentyps verwendet. Gültige Zoomwerte sind Zahlen von null bis zur unterstützten maximalen Zoomstufe.
noClear optional
Typ:boolean optional
Wenn true gelöscht wird, löschen Sie nicht den Inhalt des „div“-Elements der Karte.
panControl optional
Typ:boolean optional
Der Aktivierungs-/Deaktivierungsstatus der Schwenksteuerung.

Hinweis: Das Steuerelement zum Schwenken ist in der neuen Version der Steuerelemente, die in Version 3.22 der Google Maps JavaScript API eingeführt wurden, nicht verfügbar. Wenn Sie Version 3.22 und 3.23 verwenden, können Sie das ältere Steuerelement anstelle der neuen verwenden. Dadurch steht das Schwenksteuerelement als Teil des alten Steuerelements zur Verfügung. Weitere Informationen finden Sie unter Neuerungen in der Version 3.22 – Kartensteuerelemente.

panControlOptions optional
Typ:PanControlOptions optional
Die Anzeigeoptionen für die Schwenksteuerung.

Hinweis: Das Steuerelement zum Schwenken ist in der neuen Version der Steuerelemente, die in Version 3.22 der Google Maps JavaScript API eingeführt wurden, nicht verfügbar. Wenn Sie Version 3.22 und 3.23 verwenden, können Sie das ältere Steuerelement anstelle der neuen verwenden. Dadurch steht das Schwenksteuerelement als Teil des alten Steuerelements zur Verfügung. Weitere Informationen finden Sie unter Neuerungen in der Version 3.22 – Kartensteuerelemente.

restriction optional
Typ:MapRestriction optional
Definiert eine Grenze, durch die der Kartenbereich eingeschränkt wird. Wenn sie festgelegt ist, können Nutzer nur schwenken und zoomen, während die Kameraansicht innerhalb der Grenzen der Grenze 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
Wenn false, wird das Zoomen auf der Karte mithilfe des Mausrads deaktiviert. Das Scrollrad ist standardmäßig aktiviert.

Hinweis: Diese Property wird nicht empfohlen. Wenn Sie das Zoomen mit dem Scrollrad deaktivieren möchten, können Sie die Eigenschaft gestureHandling verwenden und entweder "cooperative" oder "none" festlegen.

streetView optional
Typ:StreetViewPanorama optional
Ein StreetViewPanorama, das angezeigt werden soll, wenn das Street View-Pegmanbild auf der Karte verworfen wird. Wenn kein Panorama angegeben ist, wird ein Standard-StreetViewPanorama in der div der Karte angezeigt, wenn Pegman verworfen 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 gesetzt werden, wenn ein Kartentyp angezeigt wird, für den das Street View-Straßen-Overlay nicht angezeigt werden soll (z.B. ein anderer Kartentyp).
streetViewControlOptions optional
Anfängliche Anzeigeoptionen für das Steuerelement des Street View-Männchens.
styles optional
Typ:Array<MapTypeStyle> optional
Stile, die auf jeden der Standardkartentypen angewendet werden sollen. Im satellite-/hybrid- und terrain-Modus werden diese Stile nur auf Labels und Geometrie angewendet.
tilt optional
Typ:number optional
Bei Vektorkarten wird der Einfallswinkel der Karte festgelegt. Die zulässigen Werte sind je nach Zoomstufe der Karte eingeschränkt. Steuert bei Rasterkarten das automatische Schalterverhalten 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 sorgt dafür, dass der Neigungswinkel automatisch auf 45 wechselt, wenn 45°-Bilder für die aktuelle Zoomstufe und den Darstellungsbereich verfügbar sind, und auf 0 zurückkehrt, wenn 45°-Bilder nicht verfügbar sind (Standardeinstellung). 45°-Bilder sind nur für die Kartentypen satellite und hybrid, an einigen Standorten und für einige Zoomstufen verfügbar. Hinweis:getTilt gibt den aktuellen Neigungswinkel zurück, nicht den durch diese Option angegebenen Wert. Da sich getTilt und diese Option auf unterschiedliche Dinge beziehen, dürfen Sie nicht die bind()-Property tilt verwenden, weil das unvorhersehbare Auswirkungen haben kann.
zoom optional
Typ:number optional
Anfängliche Zoomstufe der Karte. Gültige Zoomwerte sind Zahlen von null 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"></gmp-map>

Intern wird Map verwendet, auf das Sie mit der Property innerMap zugreifen können.

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

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert MapElementOptions.

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

center
Typ:LatLng|LatLngLiteral optional
HTML-Attribut:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Typ:Map
Ein Verweis auf das Map-Element, das MapElement intern verwendet.
mapId
Typ:string optional
HTML-Attribut:
  • <gmp-map map-id="string"></gmp-map>
zoom
Typ:number optional
HTML-Attribut:
  • <gmp-map zoom="number"></gmp-map>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter:
  • typestring Ein Groß- und Kleinschreibung, der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit derhandleEvent-Methode sein
  • optionsboolean|AddEventListenerOptions optional Optionen ansehen 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 übergeben wird. Weitere Informationen findest du im Abschnitt Optionen.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter:
Rückgabewert:  void
Entfernt einen zuvor mit ASPMX registrierten Event-Listener aus dem Ziel. Siehe removeEventListener

Schnittstelle MapElementOptions

Schnittstelle google.maps.MapElementOptions

MapElementOptions-Objekt, mit dem die Attribute 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 null bis zur unterstützten maximalen Zoomstufe. Größere Zoomwerte entsprechen einer höheren Auflösung.

Schnittstelle hreflangStyle

Schnittstelle google.maps.MapTypeStyle

MapTypeStyle ist eine Sammlung von Selektoren und Stylern, die definieren, wie die Karte gestaltet werden soll. Mit Selektoren geben Sie die betroffenen Kartenelemente und/oder Elemente an und Styler geben an, wie diese Elemente und Elemente geändert werden sollen. Weitere Informationen finden Sie in der Stilreferenz.

stylers
Die Stilregeln, die auf die ausgewählten Kartenmerkmale und -elemente angewendet werden sollen. Die Regeln werden in der Reihenfolge angewendet, die Sie in diesem Array angeben. Richtlinien zur Nutzung und 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. Beispiel: ein Label, ein Symbol, der auf die Geometrie angewendete Strich oder Füllung. Optional. Wenn elementType nicht angegeben ist, wird der Wert 'all' angenommen. Weitere Informationen zur Verwendung und zu den zulässigen Werten finden Sie in der Stilreferenz.
featureType optional
Typ:string optional
Das Element oder die Gruppe von Features, auf die ein Styler angewendet werden soll. Optional. Wenn featureType nicht angegeben ist, wird der Wert 'all' angenommen. Weitere Informationen zur Verwendung und zu den zulässigen Werten finden Sie in der Stilreferenz.

Schnittstelle MapMouseEvent

Schnittstelle google.maps.MapMouseEvent

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 Attribute target, currentTarget, relatedTarget und path definiert und konsistent sind. Entwickler sollten sich auch nicht auf die DOM-Struktur der internen Implementierung der Google Maps API verlassen. Aufgrund der internen Ereigniszuordnung kann die domEvent von der MapMouseEvent abweichen (z.B. kann ein MapMouseEvent-Klick vom Typ domEvent den 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.

Schnittstelle IconMouseEvent

Schnittstelle google.maps.IconMouseEvent

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

Diese Schnittstelle erstreckt sich zu MapMouseEvent.

placeId optional
Typ:string optional
Die Orts-ID des Ortes, auf den geklickt wurde Mit dieser Orts-ID können Sie weitere Informationen zu dem angeklickten Merkmal abfragen.

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

Übernommen: domEvent, latLng
Übernommen: stop

hreflangId-Konstanten

google.maps.MapTypeId Konstanten

Kennungen für gebräuchliche MapTypes Verwenden Sie hierfür den Wert oder den Namen der Konstante. Beispiel: 'satellite' oder google.maps.MapTypeId.SATELLITE.

Durch Aufrufen von 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.

AdManagerRegistry-Klasse

google.maps.MapTypeRegistry-Klasse

Eine Registry für hreflang-Instanzen, die nach der MapType-ID eingegeben werden.

Diese Klasse erweitert MVCObject.

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

MapTypeRegistry
MapTypeRegistry()
Parameter:Keine
MapTypeRegistry enthält die Sammlung der benutzerdefinierten Kartentypen, die der Karte zur Verfügung stehen. Die API konsultiert diese Registry beispielsweise, wenn in den Steuerelementen eine Liste der verfügbaren Kartentypen angegeben ist.
set
set(id, mapType)
Parameter:
  • idstring ID des weder für die Registrierung.
  • mapTypeMapType|* hreflang-Objekt, das in die Registry aufgenommen wird.
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

Schnittstelle MapRestriction

Schnittstelle google.maps.MapRestriction

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

latLngBounds
Wenn diese Einstellung festgelegt ist, können Nutzer nur innerhalb der angegebenen Grenzen schwenken und zoomen. Mit Grenzen können sowohl der Längengrad als auch der Breitengrad oder nur der Breitengrad begrenzt werden. Verwenden Sie für reine Breitengradgrenzen die westlichen und Längengradlängen -180 bzw. 180, z. B. latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Typ:boolean optional
Grenzen können stärker eingeschränkt werden, indem das Flag strictBounds auf true gesetzt wird. Dadurch wird festgelegt, wie weit der Nutzer herauszoomt, sodass alles außerhalb des Rahmens ausgeblendet wird. Die Standardeinstellung ist false, was bedeutet, dass ein Nutzer herauszoomen kann, bis der gesamte begrenzte Bereich sichtbar ist, möglicherweise einschließlich der Bereiche außerhalb des begrenzten Bereichs.

TrafficLayer-Klasse

google.maps.TrafficLayer-Klasse

Eine Verkehrsebene.

Diese Klasse erweitert MVCObject.

Durch Aufrufen von 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 die Karte auf null gesetzt ist, wird die Ebene entfernt.
setOptions
setOptions(options)
Parameter:
Rückgabewert: Keine
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Schnittstelle TrafficLayerOptions

Schnittstelle google.maps.TrafficLayerOptions

TrafficLayerOptions-Objekt, mit dem die Attribute definiert werden, die für eine TrafficLayer festgelegt werden können.

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.

Klasse TransitLayer

google.maps.TransitLayer-Klasse

Eine Ebene der öffentlichen Verkehrsmittel.

Diese Klasse erweitert MVCObject.

Durch Aufrufen von 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 mit Linien für öffentliche Verkehrsmittel.
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 die Karte auf null gesetzt 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.

Durch Aufrufen von 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 die Karte auf null gesetzt ist, wird die Ebene entfernt.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Schnittstelle CameraOptions

Schnittstelle google.maps.CameraOptions

Wird zum Einstellen 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

Schnittstelle visibleRegion

Schnittstelle google.maps.VisibleRegion

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 anstelle eines Rechtecks sein, wenn eine Vektorkarte neigt.

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

Durch Aufrufen von 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 Zeigt an, dass sie noch nicht bekannt ist, ob die Karte ein Vektor- oder Rasterdiagramm ist, da die Initialisierung der Karte noch nicht abgeschlossen ist.
VECTOR Gibt an, dass die Karte eine Vektorkarte ist.

Schnittstelle MapFeatures

Schnittstelle google.maps.MapCapabilities

Objekt, das eine Übersicht der derzeit für die Karte verfügbaren Funktionen enthält. Dies bedeutet nicht unbedingt, dass relevante Module geladen oder initialisiert werden, sondern dass die aktuelle Karte die Berechtigung zur Verwendung dieser APIs hat. In den Eigenschaften finden Sie eine Liste möglicher Funktionen.

isAdvancedMarkersAvailable optional
Typ:boolean optional
Bei Einstellung auf "true" ist diese Karte richtig konfiguriert, um die Verwendung erweiterter Markierungen zu ermöglichen. Beachten Sie, dass Sie trotzdem die Bibliothek marker importieren müssen, um erweiterte Markierungen verwenden zu können. Weitere Informationen finden Sie unter https://goo.gle/gmp-isAdvancedMarkersVerfügbar.
isDataDrivenStylingAvailable optional
Typ:boolean optional
Wenn für „true“ festgelegt, ist die Karte korrekt konfiguriert, um die Verwendung datengestützter Stile für mindestens eine FeatureLayer zu ermöglichen. Weitere Informationen finden Sie unter https://goo.gle/gmp-data-driven-styling und https://goo.gle/gmp-FeatureLayerIsAvailable.