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.
Konstruktor | |
---|---|
Map |
Map(mapDiv[, opts]) Parameter:
Erstellt eine neue Karte innerhalb des angegebenen HTML-Containers. Dies ist normalerweise ein DIV -Element. |
Attribute | |
---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>> Fügt der Karte zusätzliche Steuerelemente hinzu. Wenn Sie der Karte ein Steuerelement hinzufügen möchten, fügen Sie 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 |
Typ:
MapTypeRegistry Eine Registry mit MapType Instanzen nach String-ID. |
overlayMapTypes |
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. |
Methoden | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parameter:
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 |
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. |
|
getDatasetFeatureLayer(datasetId) Parameter:
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:
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:
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:
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:
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:
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:
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:
Rückgabewert: Keine
Legt den Zoom der Karte fest. |
Übernommen:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Konstanten | |
---|---|
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). |
Veranstaltungen | |
---|---|
bounds_changed |
function() Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Darstellungsbereichsgrenzen geändert haben. |
center_changed |
function() Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die center-Eigenschaft der Karte ändert. |
click |
function(event) Argumente:
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. Beachten Sie, dass das Klick-Ereignis auch zum Auslösen führt, genau vor diesem. |
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. |
|
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.
Attribute | |
---|---|
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 |
|
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 |
Typ:
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:
|
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 RasterkartenGibt 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 |
Typ:
MapTypeControlOptions optional Anfängliche Anzeigeoptionen für die Kartentypsteuerung. |
mapTypeId optional |
Typ:
MapTypeId|string optional Anfängliche mapTypeId der Karte. Die Standardeinstellung ist ROADMAP . |
maxZoom optional |
Typ:
number optional Die maximale Zoomstufe, die auf der Karte angezeigt wird. 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 |
Typ:
RotateControlOptions optional Die Anzeigeoptionen für die Drehsteuerung. |
scaleControl optional |
Typ:
boolean optional Anfänglicher Aktivierungs-/Deaktivierungsstatus der Maßstabssteuerung. |
scaleControlOptions optional |
Typ:
ScaleControlOptions optional Anfängliche Anzeigeoptionen für die Maßstabssteuerung. |
scrollwheel optional |
Typ:
boolean optional 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 |
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 |
Typ:
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.
Attribute | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional HTML-Attribut:
|
innerMap |
Typ:
Map Ein Verweis auf das Map -Element, das MapElement intern verwendet. |
mapId |
Typ:
string optional HTML-Attribut:
|
zoom |
Typ:
number optional HTML-Attribut:
|
Methoden | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
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. |
|
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.
Attribute | |
---|---|
center optional |
Typ:
LatLng|LatLngLiteral optional Anfängliches Kartenzentrum. |
mapId optional |
Typ:
string optional Die Karten-ID der Karte. Dieser Parameter kann nach der Instanziierung einer Karte nicht mehr festgelegt oder geändert werden. |
zoom optional |
Typ:
number optional Anfängliche Zoomstufe der Karte. Gültige Zoomwerte sind Zahlen von 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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
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. |
Methoden | |
---|---|
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
.
Attribute | |
---|---|
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
|
Methoden | |
---|---|
Ü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.
Konstanten | |
---|---|
HYBRID |
Bei diesem Kartentyp wird eine transparente Ebene mit den Hauptstraßen auf Satellitenbildern angezeigt. |
ROADMAP |
Bei diesem Kartentyp wird eine normale Straßenkarte angezeigt. |
SATELLITE |
Bei diesem Kartentyp werden Satellitenbilder angezeigt. |
TERRAIN |
Bei diesem Kartentyp werden Karten mit physischen Merkmalen wie Gelände und Vegetation angezeigt. |
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.
Konstruktor | |
---|---|
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. |
Methoden | |
---|---|
set |
set(id, mapType) Parameter:
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.
Attribute | |
---|---|
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.
Konstruktor | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Parameter:
Eine Ebene, auf der der aktuelle Straßenverkehr angezeigt wird. |
Methoden | |
---|---|
getMap |
getMap() Parameter:Keine
Rückgabewert:
Map Gibt die Karte zurück, auf der diese Ebene angezeigt wird. |
setMap |
setMap(map) Parameter:
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.
Attribute | |
---|---|
autoRefresh optional |
Typ:
boolean optional Standard:
true Gibt an, ob die Verkehrsebene automatisch mit aktualisierten Informationen aktualisiert wird. |
map optional |
Typ:
Map optional Karte, auf der die Verkehrslagenebene angezeigt werden soll. |
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.
Konstruktor | |
---|---|
TransitLayer |
TransitLayer() Parameter:Keine
Eine Ebene mit Linien für öffentliche Verkehrsmittel. |
Methoden | |
---|---|
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.
Konstruktor | |
---|---|
BicyclingLayer |
BicyclingLayer() Parameter:Keine
Eine Ebene, auf der Fahrradwege und Fahrradspuren angezeigt und große Straßen zurückgestuft werden. |
Methoden | |
---|---|
getMap |
getMap() Parameter:Keine
Rückgabewert:
Map Gibt die Karte zurück, auf der diese Ebene angezeigt wird. |
setMap |
setMap(map) Parameter:
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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
LatLngBounds Der kleinste Begrenzungsrahmen, der den sichtbaren Bereich enthält. |
nearLeft |
Typ:
LatLng |
nearRight |
Typ:
LatLng |
RenderingType-Konstanten
google.maps.RenderingType
Konstanten
Durch Aufrufen von const {RenderingType} = await google.maps.importLibrary("maps")
aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
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. In den Eigenschaften finden Sie eine Liste möglicher Funktionen.
Attribute | |
---|---|
isAdvancedMarkersAvailable optional |
Typ:
boolean optional |
isDataDrivenStylingAvailable optional |
Typ:
boolean optional |