Maps

Klasse Map

google.maps.Map Klasse

Diese Klasse erweitert MVCObject.

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

 Steuert bei Rasterkarten das automatische Umschalten des Einfallswinkels der Karte. Die einzigen zulässigen Werte sind 0 und 45. Mit setTilt(0) wird für die Karte immer eine 0°-Ansicht von oben verwendet, unabhängig von der Zoomstufe und dem Darstellungsbereich. Mit setTilt(45) wird der Neigungswinkel automatisch auf 45 ° gesetzt, wenn für die aktuelle Zoomstufe und den aktuellen Darstellungsbereich 45°-Bilder verfügbar sind. Wenn keine 45°-Bilder verfügbar sind, wird der Neigungswinkel wieder auf 0 ° gesetzt. Das ist das Standardverhalten. 45°-Bilder sind nur für die Kartentypen satellite und hybrid, an bestimmten Orten und bei bestimmten Zoomstufen verfügbar. Hinweis:getTilt gibt den aktuellen Neigungswinkel zurück, nicht den von setTilt festgelegten Wert. Da sich getTilt und setTilt auf unterschiedliche Dinge beziehen, sollten Sie das Attribut tilt nicht bind(). Andernfalls kann es zu unvorhersehbaren Auswirkungen kommen.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Parameter:
  • tiltInteractionEnabled:  boolean
Rückgabewert:Keiner
Legt fest, ob Neigungsinteraktionen aktiviert sind. Diese Option ist nur wirksam, wenn es sich bei der Karte um eine Vektorkarte handelt. Wenn sie nicht im Code festgelegt ist, wird die Cloud-Konfiguration für die Karten-ID verwendet (falls verfügbar).
setZoom
setZoom(zoom)
Parameter:
  • zoom:  number Größere Zoomwerte entsprechen einer höheren Auflösung.
Rückgabewert:Keiner
Legt den Zoom der Karte fest.
Geerbt:addListener, bindTo, 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 den angeklickten Ort wird zurückgegeben, sofern nicht auf ein Orts-Symbol geklickt wurde. In diesem Fall wird ein IconMouseEvent mit einer Orts-ID zurückgegeben. IconMouseEvent und MapMouseEvent sind identisch, mit Ausnahme des Felds „placeId“ in IconMouseEvent. Das Ereignis kann immer als MapMouseEvent behandelt werden, wenn die Orts-ID nicht wichtig ist. Das Click-Event 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. Das Klickereignis wird manchmal einmal und 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. Hinweis: „dragend“ wird NICHT ausgelöst, wenn der Nutzer das Schwenken der Karte über die Tastatur beendet. Verwenden Sie stattdessen das Map.idle-Ereignis, um zu ermitteln, wann der Nutzer das Schwenken oder Ziehen der Karte beendet hat.
dragstart
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, die Karte zu verschieben.