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.
Konstruktor | |
---|---|
Map |
Map(mapDiv[, opts]) Parameter:
Erstellt eine neue Karte innerhalb des angegebenen HTML-Containers, bei dem es sich normalerweise um ein DIV -Element handelt. |
Konstanten | |
---|---|
DEMO_MAP_ID |
Karten-ID, die für Codebeispiele verwendet werden kann, die eine Karten-ID erfordern. Diese Karten-ID ist nicht für Produktionsanwendungen vorgesehen und kann nicht für Funktionen verwendet werden, die eine Cloud-Konfiguration erfordern, z. B. das cloudbasierte Gestalten von Karteninhalten. |
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 die <div> des Steuerelements zum MVCArray entsprechend der ControlPosition hinzu, in der es gerendert werden soll. |
data |
Typ:
Data Eine Instanz von Data , die an die Karte gebunden ist. Fügen Sie diesem Data -Objekt Elemente hinzu, um sie bequem auf der Karte darzustellen. |
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, an die sie angehängt sind, und zwar in der Reihenfolge, in der sie im overlayMapTypes -Array vorkommen. Overlays mit höheren Indexwerten werden vor Overlays mit niedrigeren Indexwerten angezeigt. |
Methoden | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parameter:
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 von der fitBounds -Funktion als 0 x 0 gelesen. Sie erfolgt daher nicht. Um den Darstellungsbereich zu ändern, 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 setzt diese Methode die Neigung und Ausrichtung der Karte auf den Standardwert Null. Das Aufrufen dieser Methode kann zu einer flüssigen Animation führen, wenn die Karte geschwenkt und gezoomt wird, um sie an die Grenzen anzupassen. Ob diese Methode animiert wird, hängt von einer internen Heuristik ab. |
getBounds |
getBounds() Parameter:Keine
Rückgabewert:
LatLngBounds|undefined Die Breiten-/Längengrenzen des aktuellen Darstellungsbereichs.Gibt die Breite-/Länge-Grenzen des aktuellen Darstellungsbereichs zurück. Wenn mehr als eine Kopie der Welt sichtbar ist, reichen die Längengrenzen von -180 bis einschließlich 180 Grad. Wenn die Karte noch nicht initialisiert oder zentriert und der Zoom nicht festgelegt wurde, lautet das Ergebnis undefined . Bei Vektorkarten mit Neigung oder Ausrichtung ungleich null stellen die zurückgegebenen Breiten-/Längengrenzen den kleinsten Markierungsrahmen dar, der den sichtbaren Bereich des Darstellungsbereichs der Karte enthält. Informationen zum Abrufen des genauen sichtbaren Bereichs des Darstellungsbereichs der Karte finden Sie unter MapCanvasProjection.getVisibleRegion . |
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 stellt einen interessanten Punkt (auch POI genannt) dar. Wenn der zurückgegebene Wert true ist, sind die Symbole auf der Karte anklickbar. |
getDatasetFeatureLayer |
getDatasetFeatureLayer(datasetId) Parameter:
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 Elementebenen mit datengestütztem Stil oder keine im Kartenstil konfigurierten Datasets), wird ein Fehler protokolliert und der resultierende FeatureLayer.isAvailable ist „false“. |
getDiv |
getDiv() Parameter:Keine
Rückgabewert:
HTMLElement Die „mapDiv“ der Karte. |
getFeatureLayer |
getFeatureLayer(featureType) Parameter:
Rückgabewert:
FeatureLayer Gibt den FeatureLayer der spezifischen FeatureType zurück. In der Google Cloud Console muss ein FeatureLayer aktiviert sein. Wenn ein FeatureLayer der angegebenen FeatureType auf dieser Karte nicht vorhanden ist oder keine datengestützten Stile verfügbar sind (keine Karten-ID, keine Vektorkacheln und kein FeatureLayer im Kartenstil aktiviert), wird ein Fehler protokolliert und der resultierende FeatureLayer.isAvailable ist „false“. |
getHeading |
getHeading() Parameter:Keine
Rückgabewert:
number|undefined Gibt die Kompassausrichtung der Karte zurück. Der Richtungswert wird in Grad (im Uhrzeigersinn) ausgehend von der Himmelsrichtung Norden gemessen. Wenn die Karte noch nicht initialisiert ist, ist das Ergebnis undefined . |
getMapCapabilities |
getMapCapabilities() Parameter:Keine
Rückgabewert:
MapCapabilities Informiert den Aufrufer über die aktuell verfügbaren Funktionen der Karte basierend auf der angegebenen Karten-ID. |
getMapTypeId |
getMapTypeId() Parameter:Keine
Rückgabewert:
MapTypeId|string|undefined |
getProjection |
getProjection() Parameter:Keine
Rückgabewert:
Projection|undefined Gibt den aktuellen Projection zurück. Wenn die Karte noch nicht initialisiert ist, ist das Ergebnis undefined . Prüfen Sie das projection_changed -Ereignis und prüfen Sie seinen Wert, um sicherzustellen, dass es nicht undefined ist. |
getRenderingType |
getRenderingType() Parameter:Keine
Rückgabewert:
RenderingType Gibt den aktuellen RenderingType der Karte zurück. |
getStreetView |
getStreetView() Parameter:Keine
Rückgabewert:
StreetViewPanorama Das an die Karte gebundene Panorama.Gibt das standardmäßige StreetViewPanorama zurück, das an die Karte gebunden ist. Dabei kann es sich um ein in die Karte eingebettetes Standardpanorama handeln oder um das Panorama, das mit setStreetView() festgelegt wurde. Änderungen am streetViewControl der Karte spiegeln sich in der Anzeige des 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 dem Kopf aufgenommen wurden, oder 45 für 45°-Bilder. Diese Methode gibt nicht den von setTilt festgelegten Wert zurück. Weitere Informationen findest du unter setTilt . |
getZoom |
getZoom() Parameter:Keine
Rückgabewert:
number|undefined Gibt die Zoomstufe der Karte zurück. Wenn kein Zoom festgelegt wurde, lautet das Ergebnis undefined . |
moveCamera |
moveCamera(cameraOptions) Parameter:
Rückgabewert:Keine
Setzt die Kamera der Karte sofort auf die Zielkameraoptionen, 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 das mindestens erforderliche Maß, sodass sie das angegebene LatLngBounds enthält. Es gibt keine Garantie dafür, wo sich die Grenzen auf der Karte befinden, außer 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:
Rückgabewert:Keine
Steuert, ob die Kartensymbole anklickbar sind oder nicht. Ein Kartensymbol stellt einen interessanten Punkt (auch POI genannt) dar. Übergeben Sie einen Wert von false an diese Methode, um die Anklickbarkeit von Kartensymbolen zu deaktivieren. |
setHeading |
setHeading(heading) Parameter:
Rückgabewert:Keine
Legt die Kompassausrichtung der Karte fest, gemessen in Grad ausgehend von der Himmelsrichtung Norden. Bei Rasterkarten gilt diese Methode nur für Luftbilder. |
setMapTypeId |
setMapTypeId(mapTypeId) Parameter:
Rückgabewert:Keine
|
setOptions |
setOptions(options) Parameter:
Rückgabewert:Keine
|
setStreetView |
setStreetView(panorama) Parameter:
Rückgabewert:Keine
Verknüpft einen StreetViewPanorama mit der Karte. Dieses Panorama überschreibt den standardmäßigen StreetViewPanorama , sodass die Karte an ein externes Panorama außerhalb der Karte gebunden werden kann. Wenn Sie das Panorama auf null setzen, wird das standardmäßig eingebettete Panorama wieder an die Karte gebunden. |
setTilt |
setTilt(tilt) Parameter:
Rückgabewert:Keine
Legt für Vektorkarten den Einfallswinkel der Karte fest. Die zulässigen Werte sind abhängig von der Zoomstufe der Karte beschränkt. Steuert bei Rasterkarten das Verhalten beim automatischen Wechsel für den Einfallswinkel der Karte. Die einzigen zulässigen Werte sind 0 und 45 . setTilt(0) bewirkt, dass unabhängig von Zoomstufe und Darstellungsbereich immer eine Draufsicht von 0° verwendet wird. 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 gesetzt, wenn keine 45°-Bilder verfügbar sind (dies ist die Standardeinstellung). 45°-Bilder sind nur für die Kartentypen satellite und hybrid sowie an einigen Standorten und bei bestimmten Zoomstufen verfügbar. Hinweis: getTilt gibt den aktuellen Neigungswinkel und nicht den durch setTilt festgelegten Wert zurück. Da sich getTilt und setTilt auf unterschiedliche Dinge beziehen, solltest du die Property tilt nicht bind() verwenden. Dies kann zu unvorhersehbaren Auswirkungen führen. |
setZoom |
setZoom(zoom) Parameter:
Rückgabewert:Keine
Legt die Zoomstufe der Karte fest. |
Übernommen:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Veranstaltungen | |
---|---|
bounds_changed |
function() Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Darstellungsbereichsgrenzen geändert haben. |
center_changed |
function() Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die center-Eigenschaft der Karte ändert. |
click |
function(event) Argumente:
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 ein- und manchmal zweimal, direkt vor diesem Ereignis, 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. |
|
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, das zum Definieren der Eigenschaften verwendet wird, die für eine Karte festgelegt werden können.
Attribute | |
---|---|
backgroundColor optional |
Typ:
string optional Für den Hintergrund des Karten-div-Elements 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 Standard:
true Wenn false , sind Kartensymbole nicht anklickbar. Ein Kartensymbol stellt einen interessanten Punkt (auch POI genannt) dar. |
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. Eine spätere Aktualisierung des Werts kann die Steuerelemente in den Status undefined versetzen. Steuert nur die Steuerelemente, die von der Google Maps API selbst vorgenommen werden. Skaliert keine vom Entwickler erstellten benutzerdefinierten Steuerelemente. |
disableDefaultUI optional |
Typ:
boolean optional Aktiviert/deaktiviert alle standardmäßigen UI-Schaltflä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. Sie wird separat über die Option MapOptions.gestureHandling gesteuert. |
disableDoubleClickZoom optional |
Typ:
boolean optional Aktiviert/deaktiviert das Zoomen und Zentrieren durch Doppelklick. Standardmäßig aktiviert. Hinweis: Diese Eigenschaft wird nicht empfohlen. Um das Zoomen beim Doppelklicken zu deaktivieren, können Sie das Attribut |
|
Typ:
boolean optional Wenn der Wert false lautet, kann die Karte nicht gezogen werden. Verschieben ist standardmäßig aktiviert. |
draggableCursor optional |
Typ:
string optional Der Name oder die URL des Cursors, der angezeigt werden soll, wenn die Maus über eine verschiebbare Karte bewegt wird. Diese Eigenschaft verwendet das CSS-Attribut cursor , 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 Verschieben der Karte angezeigt werden soll. Diese Eigenschaft verwendet das CSS-Attribut cursor , 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 Der Aktivierungs-/Deaktivierungsstatus des Vollbildsteuerelements. |
fullscreenControlOptions optional |
Typ:
FullscreenControlOptions optional Die Anzeigeoptionen für das Vollbildsteuerelement. |
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 Standard:
true für Vektorkarten und false für RasterkartenGibt 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 Falls false , kann die Karte nicht über die Tastatur gesteuert werden. Tastaturkürzel sind standardmäßig aktiviert. |
mapId optional |
Typ:
string optional Karten-ID der Karte Dieser Parameter kann nach der Instanziierung einer Karte nicht mehr festgelegt oder geändert werden. |
mapTypeControl optional |
Typ:
boolean optional Anfänglicher Aktivierungs-/Inaktivierungsstatus der Kartentypsteuerung. |
mapTypeControlOptions optional |
Typ:
MapTypeControlOptions optional Anfängliche Anzeigeoptionen für die Kartentypsteuerung. |
mapTypeId optional |
Typ:
MapTypeId|string optional Anfängliche mapTypeId der Karte. Die Standardeinstellung ist ROADMAP . |
maxZoom optional |
Typ:
number optional Die maximale Zoomstufe, die auf der Karte angezeigt wird. Wenn das Feld auf null gesetzt oder weggelassen wird, wird stattdessen die maximale Zoomstufe des aktuellen Kartentyps verwendet. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe. |
minZoom optional |
Typ:
number optional Die minimale Zoomstufe, die auf der Karte angezeigt wird. Wenn das Feld auf null gesetzt oder weggelassen wird, wird stattdessen die minimale Zoomstufe des aktuellen Kartentyps verwendet. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe. |
noClear optional |
Typ:
boolean optional Falls true , den Inhalt des Karten-div-Elements nicht löschen. |
|
Typ:
boolean optional Der Aktivierungs-/Deaktivierungsstatus der Schwenksteuerung. |
|
Typ:
PanControlOptions optional Die Anzeigeoptionen für die Schwenksteuerung. |
restriction optional |
Typ:
MapRestriction optional Definiert eine Begrenzung, die den für Nutzer zugänglichen Bereich der Karte einschränkt. Wenn diese Einstellung aktiviert ist, kann der Nutzer nur so lange schwenken und zoomen, wie die Kameraansicht innerhalb der Begrenzungen 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 der Karte mit dem Mausrad deaktiviert. Das Scrollrad ist standardmäßig aktiviert. Hinweis: Diese Eigenschaft wird nicht empfohlen. Wenn Sie das Zoomen mit dem Scrollrad deaktivieren möchten, verwenden Sie die Eigenschaft |
streetView optional |
Typ:
StreetViewPanorama optional Ein StreetViewPanorama , das angezeigt wird, wenn der Street View-Pegman auf die Karte gezogen wird. Wenn kein Panorama angegeben ist, wird beim Ablegen des Pegman-Symbols ein Standard-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. ein anderer Kartentyp als Google Earth). |
streetViewControlOptions optional |
Typ:
StreetViewControlOptions optional Anfängliche Anzeigeoptionen für das Steuerelement des Street View-Männchens. |
styles optional |
Typ:
Array<MapTypeStyle> optional Stile, die auf die einzelnen Standardkartentypen angewendet werden sollen Beachten Sie, dass diese Stile für die Modi satellite /hybrid und terrain nur auf Labels und Geometrie angewendet werden. |
tilt optional |
Typ:
number optional Legt für Vektorkarten den Einfallswinkel der Karte fest. Die zulässigen Werte sind abhängig von der Zoomstufe der Karte beschränkt. Steuert bei Rasterkarten das Verhalten beim automatischen Wechsel für den Einfallswinkel der Karte. Die einzigen zulässigen Werte sind 0 und 45 . Durch den Wert 0 wird unabhängig von Zoomstufe und Darstellungsbereich immer eine Draufsicht von 0° verwendet. Der Wert 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 zurück zu 0, wenn keine 45°-Bilder verfügbar sind (dies ist die Standardeinstellung). 45°-Bilder sind nur für die Kartentypen satellite und hybrid sowie 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, solltest du die Property tilt nicht bind() verwenden. Das kann zu unvorhersehbaren Auswirkungen führen. |
zoom optional |
Typ:
number optional Anfängliche Zoomstufe der Karte. Gültige Zoomwerte sind Zahlen von 0 bis zur unterstützten maximalen Zoomstufe. Größere Zoomwerte entsprechen einer höheren Auflösung. |
zoomControl optional |
Typ:
boolean optional Der Aktivierungs-/Deaktivierungsstatus der Zoomsteuerung. |
zoomControlOptions optional |
Typ:
ZoomControlOptions optional Die Anzeigeoptionen für die Zoomsteuerung. |
MapElement-Klasse
google.maps.MapElement
Klasse
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
.
Diese Klasse implementiert MapElementOptions
.
Zugriff über const {MapElement} = await google.maps.importLibrary("maps")
aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
MapElement |
MapElement([options]) Parameter:
|
Attribute | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional Der Breiten- und Längengrad in der Mitte der Karte.
HTML-Attribut:
|
innerMap |
Typ:
Map Ein Verweis auf den Map , den das MapElement intern verwendet. |
mapId |
Typ:
string optional Die Karten-ID der Karte. Weitere Informationen finden Sie in der Dokumentation zu Karten-IDs.
HTML-Attribut:
|
zoom |
Typ:
number optional Die Zoomstufe der Karte.
HTML-Attribut:
|
Methoden | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Richtet eine Funktion ein, die immer aufgerufen wird, wenn das angegebene Ereignis an das Ziel geliefert wird. Siehe addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Parameter:
Rückgabewert:
void Entfernt einen zuvor mit addEventListener registrierten Event-Listener aus dem Ziel. Siehe removeEventListener. |
Veranstaltungen | |
---|---|
gmp-zoomchange |
function(event) Argumente:
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft "Zoom" der Karte ändert. |
MapElementOptions.
google.maps.MapElementOptions
-Schnittstelle
MapElementOptions-Objekt, mit dem die Eigenschaften 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 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 Beobachten einer 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, mit denen der Stil der Karte definiert wird. Selektoren geben die Kartenelemente und/oder -elemente an, die betroffen sein sollen, und Styler geben an, wie diese Merkmale und Elemente geändert werden sollen. Weitere Informationen finden Sie in der Stilreferenz.
Attribute | |
---|---|
stylers |
Die Stilregeln, die auf die ausgewählten Kartenelemente und -elemente angewendet werden sollen. Die Regeln werden in der Reihenfolge angewendet, die Sie in diesem Array angeben. Richtlinien zur Verwendung und zu zulässigen Werten finden Sie in der Stilreferenz. |
elementType optional |
Typ:
string optional Das Element, auf das ein Styler angewendet werden soll. Ein -Element ist ein visueller Aspekt eines Kartenelements. Beispiele: ein Label, ein Symbol, die auf die Geometrie angewendete Kontur oder Füllung usw. Optional. Ist elementType nicht angegeben, wird als Wert 'all' 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 als Wert 'all' 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.
Attribute | |
---|---|
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 nicht auf die DOM-Struktur der internen Implementierung der Google Maps API verlassen. Aufgrund der internen Ereigniszuordnung kann domEvent eine andere Semantik als MapMouseEvent haben (z.B. kann ein MapMouseEvent -Klick einen domEvent vom Typ KeyboardEvent haben). |
latLng optional |
Typ:
LatLng optional Die geografische Breite/Länge, die sich unter dem Cursor befand, als das Ereignis eintrat. |
Methoden | |
---|---|
stop |
stop() Parameter:Keine
Rückgabewert:
void Verhindert, dass dieses Ereignis weiter verbreitet wird. |
IconMouseEvent-Schnittstelle
google.maps.IconMouseEvent
-Schnittstelle
Dieses Objekt wird in einem Ereignis gesendet, wenn ein Nutzer auf ein Symbol auf der Karte klickt. Die Orts-ID dieses Ortes wird im „placeId“-Mitglied gespeichert. Um zu verhindern, dass das Standardinfofenster angezeigt wird, rufen Sie die stop()-Methode für dieses Ereignis auf, damit es nicht weitergegeben wird. Weitere Informationen zu Orts-IDs finden Sie im Places API-Entwicklerhandbuch.
Diese Schnittstelle erweitert MapMouseEvent
.
Attribute | |
---|---|
placeId optional |
Typ:
string optional Die Orts-ID des Orts, auf den geklickt wurde. Mit dieser Orts-ID können weitere Informationen zu dem angeklickten Element abgefragt werden. Weitere Informationen zu Orts-IDs finden Sie im Places API-Entwicklerhandbuch. |
Übernommen:
domEvent ,
latLng
|
Methoden | |
---|---|
Übernommen:
stop
|
MapTypeId-Konstanten
google.maps.MapTypeId
-Konstanten
Kennungen für gebräuchliche MapTypes Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'satellite'
oder google.maps.MapTypeId.SATELLITE
.
Zugriff über 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. |
MapTypeRegistry-Klasse
google.maps.MapTypeRegistry
Klasse
Eine Registrierung für MapType-Instanzen, die anhand der MapType-ID verschlüsselt ist.
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.
Konstruktor | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parameter:Keine
Das MapTypeRegistry enthält die benutzerdefinierten Kartentypen, die für die Karte verfügbar sind. Die API prüft diese Registry beispielsweise, wenn sie die Liste der verfügbaren Kartentypen in Steuerelementen bereitstellt. |
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
|
MapRestriction-Schnittstelle
google.maps.MapRestriction
-Schnittstelle
Eine Einschränkung, die auf die Karte angewendet werden kann. Der Darstellungsbereich der Karte überschreitet diese Beschränkungen nicht.
Attribute | |
---|---|
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 Breitengrenzen die westlichen bzw. östlichen Längengrade von -180 bzw. 180, z. B. latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional |
Typ:
boolean optional Grenzen können restriktiver gestaltet werden, indem Sie das Flag strictBounds auf true setzen. Dadurch wird der Zoom für den Nutzer reduziert und alles, was außerhalb der eingeschränkten Grenzen liegt, bleibt verborgen. Die Standardeinstellung ist false . Das bedeutet, dass ein Nutzer herauszoomen kann, bis der gesamte begrenzte Bereich sichtbar ist, möglicherweise auch Bereiche außerhalb des begrenzten Bereichs. |
TrafficLayer-Klasse
google.maps.TrafficLayer
Klasse
Eine Verkehrsebene.
Diese Klasse erweitert MVCObject
.
Zugriff über 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 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, mit dem die Eigenschaften definiert werden, die für ein TrafficLayer festgelegt werden können.
Attribute | |
---|---|
autoRefresh optional |
Typ:
boolean optional Standard:
true Gibt an, ob die Verkehrsebene automatisch mit aktualisierten Informationen aktualisiert wird. |
map optional |
Typ:
Map optional Karte, auf der die Verkehrsebene angezeigt werden soll. |
TransitLayer-Klasse
google.maps.TransitLayer
Klasse
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.
Konstruktor | |
---|---|
TransitLayer |
TransitLayer() Parameter:Keine
Eine Ebene, auf der ÖPNV-Linien angezeigt werden. |
Methoden | |
---|---|
getMap |
getMap() Parameter:Keine
Rückgabewert:
Map Gibt die Karte zurück, auf der diese Ebene angezeigt wird. |
setMap |
setMap(map) Parameter:
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.
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 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.
Attribute | |
---|---|
center optional |
Typ:
LatLngLiteral|LatLng optional |
heading optional |
Typ:
number optional |
tilt optional |
Typ:
number optional |
zoom optional |
Typ:
number optional |
VisibleRegion-Schnittstelle
google.maps.VisibleRegion
-Schnittstelle
Enthält die vier Punkte, die das vierseitige Polygon definieren, das den sichtbaren Bereich der Karte darstellt. Auf einer Vektorkarte kann dieses Polygon ein Trapez statt eines Rechtecks sein, wenn eine Vektorkarte geneigt ist.
Attribute | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
LatLngBounds Der kleinste Begrenzungsrahmen, der den sichtbaren Bereich enthält. |
nearLeft |
Typ:
LatLng |
nearRight |
Typ:
LatLng |
RenderingType-Konstanten
google.maps.RenderingType
-Konstanten
Zugriff über 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 |
Gibt an, dass noch nicht bekannt ist, ob es sich um eine Vektor- oder eine 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 einer Momentaufnahme der Funktionen, die derzeit für die Karte verfügbar sind. 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 in den Attributen.
Attribute | |
---|---|
isAdvancedMarkersAvailable optional |
Typ:
boolean optional Wenn „true“ festgelegt ist, ist diese Karte so konfiguriert, dass erweiterte Markierungen verwendet werden können. Beachten Sie, dass Sie weiterhin die marker -Bibliothek importieren müssen, um erweiterte Markierungen zu verwenden. 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 Feature-Ebene 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. |