Initialisierung

Um die Karte zu initialisieren, können Sie den folgenden Code verwenden:

// initialize the map on the "map" div with a given center and zoom
var map = ym.map('map', {
    center: [51.505, -0.09],
    zoom: 13
});

Factory: ym.map(id, options)

Instanziiert ein Kartenobjekt mit einem div-Element (oder dessen ID) und optional einem Objekt mit den unten beschriebenen Kartenoptionen.

Parameter	Beschreibung	Datentyp	Standardwert
id	Ein div-Element oder eine ID. [erforderlich]	HTML-element or string
options	[optional]	Object

Parameter: options

Kartenstatus-Optionen

Name	Beschreibung	Datentyp	Standardwert
center	Ursprünglicher geografischer Mittelpunkt der Karte.	LatLng	null
zoom	Ursprünglicher Zoomwert.	int	null
layers	Layer, die der Karte zuerst hinzugefügt werden.	ILayer[]	null
minZoom	Minimale Zoomstufe der Karte. Überschreibt alle minZoom-Einstellungen der Kartenlayer.	int	null
maxZoom	Maximale Zoomstufe der Karte. Überschreibt alle maxZoom-Einstellungen der Kartenlayer.	int	null
maxBounds	Wenn diese Option gesetzt ist, beschränkt die Karte die Ansicht auf die angegebenen geografischen Grenzen und verhindert, dass der Benutzer die Karte außerhalb dieser Ansicht bewegt. Um die Beschränkung dynamisch festzulegen, verwenden Sie die Methode setMaxBounds.	LatLngBounds	null
style	Einstellung des Kartenstils, der auf der Karte angezeigt werden soll. Standardmäßig wird das Profil lightmode verwendet. Sie können zwischen verschiedenen, an den jeweiligen Anwendungsfall angepassten Stilen wählen.
	lightmode, darkmode, daylight, greyscale, nightmode, colorblind, designmode		lightmode

Interaktionsoptionen

Name	Beschreibung	Datentyp	Standardwert
fullscreenControl	Ob die Karte im Vollbildmodus geöffnet werden kann	bool	false
draggable	Ob die Karte mit der Maus oder per Touch verschoben werden kann	bool	true
touchZoom	Ob die Karte durch Berühren mit zwei Fingern gezoomt werden kann	bool	true
scrollWheelZoom	Ob die Karte mit dem Mausrad gezoomt werden kann. Wenn Sie "center" übergeben, wird die Karte unabhängig von der Position der Maus zur Mitte der Ansicht gezoomt.	bool	true
doubleClickZoom	Ob die Karte durch Doppelklick vergrößert und durch Doppelklick bei gedrückter Umschalttaste (Shift) verkleinert werden kann. Wenn Sie die Option "Center" ausgewählt haben, zoomt der Doppelklick unabhängig von der Position der Maus zur Mitte der Ansicht.	bool	true
boxZoom	Ob die Karte auf einen rechteckigen Bereich gezoomt werden kann, der durch Ziehen mit der Maus bei gedrückter Umschalttaste (Shift) definiert wird.	bool	true
tap	Aktiviert Mobile-Hacks zur Unterstützung von sofortigen Taps (behebt die 200-ms-Klickverzögerung unter iOS/Android) und Touch-Holds (werden als Kontextmenü-Ereignisse ausgelöst)	bool	true
tapTolerance	Die maximale Anzahl an Pixeln, die ein Benutzer bei einer Berührung mit dem Finger bewegen darf, damit sie noch als gültige Fingerspitze gilt.	int	15
trackResize	Ob die Karte sich bei einer Größenänderung des Browserfensters automatisch aktualisiert.	bool	true
worldCopyJump	Wenn diese Option aktiviert ist, werden beim Verschieben zu einer anderen Kopie der Welt die Kartenspuren angezeigt und nahtlos zur ursprünglichen Karte gesprungen, sodass alle Overlays wie Marker und Vektor-Layer weiterhin sichtbar bleiben.	bool	false
closePopupOnClick	Setzen Sie diesen Wert auf false, wenn Pop-ups nicht durch einen Klick auf die Karte geschlossen werden sollen.	bool	true
bounceAtZoomLimits	Setzen Sie diese Einstellung auf false, wenn die Karte beim Pinch-Zoom nicht über die minimale/maximale Zoomstufe hinaus zoomen und dann wieder zurückspringen soll.	bool	true

Tastatureingabe-Optionen

Name	Beschreibung	Datentyp	Standardwert
keyboard	Macht die Karte fokussierbar und ermöglicht dem Benutzer die Navigation auf der Karte mit den Pfeiltasten und den Tasten [+]/[-].	bool	true
keyboardPanOffset	Anzahl der Pixel, um die sich die Karte beim Drücken einer Pfeiltaste verschiebt.	int	80
keyboardZoomOffset	Anzahl der Zoomstufen, die beim Drücken der Taste [+]/[-] geändert werden.	int	1

Optionen für die Trägheit von Bewegungsaktionen

Name	Beschreibung	Datentyp	Standardwert
inertia	Wenn diese Option aktiviert ist, hat das Bewegen der Karte beim Ziehen einen Trägheitseffekt, sodass sich die Karte noch eine Weile in dieselbe Richtung weiterbewegt. Fühlt sich besonders auf Touch-Geräten gut an.	bool
inertiaDeceleration	Die Geschwindigkeit, mit der die Trägheitsbewegung abgebremst wird, in Pixel pro Sekunde.	int	3000
inertiaMaxSpeed	Maximale Geschwindigkeit der Trägheitsbewegung, in Pixel/Sekunde.	int	1500
inertiaThreshold	Anzahl der Millisekunden, die zwischen dem Stoppen der Bewegung und dem Loslassen der Maus oder Berührung vergehen müssen, um Trägheit zu verhindern (standardmäßig 32 für Touch-Geräte und 14 für alle anderen Geräte)	int

Control-Optionen

Name	Beschreibung	Datentyp	Standardwert
zoomControl	Ob der Zoom-Regler standardmäßig zur Karte hinzugefügt wird.	bool	true
attributionControl	Ob das Attribution-Control standardmäßig zur Karte hinzugefügt wird.	bool	true

Animationsoptionen

Name	Beschreibung	Datentyp	Standardwert
fadeAnimation	Ob die Tile-Überblendanimation aktiviert ist. Standardmäßig ist dies in allen Browsern aktiviert, die CSS3-Übergänge unterstützen (nicht Android).	bool
zoomAnimation	Ob die Tile-Zoomanimation aktiviert ist. Standardmäßig ist dies in allen Browsern aktiviert, die CSS3-Übergänge unterstützen (nicht Android).	bool
zoomAnimationThreshold	Der Zoom wird nicht animiert, wenn die Zoomdifferenz diesen Wert überschreitet.	int	4
markerZoomAnimation	Gibt an, ob Marker während der Zoomanimation ebenfalls animiert werden. Wenn diese Option deaktiviert ist, verschwinden die Marker für die Dauer der Animation. Standardmäßig ist dies in allen Browsern aktiviert, die CSS3-Übergänge unterstützen (nicht Android).	bool

Lokalisierungsoptionen

Name	Beschreibung	Datentyp	Standardwert
watch	Wenn true, startet die kontinuierliche Beobachtung von Standortänderungen (statt einer einmaligen Erkennung) mit der W3C-Methode watchPosition. Sie können die Beobachtung später mit der Methode map.stopLocate beenden.	bool	false
setView	Wenn false, wird die Kartenansicht automatisch (falls die Geolokalisierung fehlschlägt) je nach Erkennungsgenauigkeit auf den Standort des Benutzers oder auf die Weltansicht gesetzt.	bool	false
maxZoom	Der maximale Zoomfaktor für die automatische Einstellung der Ansicht bei Verwendung der Option setView.	int	Infinity
timeout	Anzahl der Millisekunden, die auf eine Geolocation-Antwort gewartet wird, bevor ein Standortfehler-Ereignis ausgelöst wird.	Number	10000
maximumAge	Maximales Alter des erkannten Standorts. Wenn seit der letzten Geolocation-Antwort weniger als diese Anzahl an Millisekunden vergangen ist, gibt locate einen zwischengespeicherten Standort zurück.	int	0
enableHighAccuracy	Aktiviert hohe Genauigkeit (siehe Beschreibung in der W3C-Spezifikation)	bool	false

Zoom- und Verschiebungsoptionen

Name	Beschreibung	Datentyp	Standardwert
reset	Wenn true, wird die Kartenansicht vollständig zurückgesetzt (ohne Animationen).	bool	false
pan	Legt die Optionen für das Verschieben (ohne Zoomänderung) fest, wenn dies erfolgt.	pan options
zoom	Legt die Optionen für die Zoomänderung fest, wenn diese erfolgt.	zoom options
animate	Entspricht der Übergabe von Animationen für die Zoom- und Pan-Optionen (siehe unten).	bool

Verschiebungsoptionen

Name	Beschreibung	Datentyp	Standardwert
animate	Wenn true, wird das Ziehen nach Möglichkeit animiert. Wenn false, wird das Ziehen nicht animiert. Beim Verschieben um mehr als eine Bildschirmbreite wird entweder die Kartenansicht zurückgesetzt, oder es wird nur ein neuer Versatz für den Kartenausschnitt festgelegt (außer bei panBy, das immer Letzteres tut).	bool
duration	Dauer der animierten Bewegung.	int	0.25
easeLinearity	Der Krümmungsfaktor der Verschiebungsanimations-Abklingkurve (dritter Parameter der kubischen Bezierkurve). 1.0 bedeutet lineare Animation. Je kleiner der Wert, desto stärker gekrümmt die Kurve.	int	0.25
noMoveStart	Wenn true, löst das Bewegen beim Start das Movestart-Ereignis nicht aus (wird intern für die Pan-Trägheit verwendet).	bool	false

Zoomoptionen

Name	Beschreibung	Datentyp	Standardwert
animate	Wenn nicht angegeben, wird die Zoomanimation ausgeführt. Bedingung: Der Ursprung des Zooms liegt innerhalb der aktuellen Ansicht. Ist dies der Fall, versucht die Karte, den Zoom zu animieren, unabhängig davon, wo sich der Ursprung des Zooms befindet. Wird false gesetzt, wird die Ansicht immer vollständig ohne Animation zurückgesetzt.	bool

Randanpassungsoptionen

Name	Beschreibung	Datentyp	Standardwert
paddingTopLeft	Legt fest, wie viel Rand-Padding in der oberen linken Ecke eines Kartencontainers angezeigt wird, der beim Anpassen der Ansicht an die Grenzen nicht berücksichtigt werden soll. Nützlich, wenn Sie Control-Overlays wie eine Sidebar auf der Karte haben und die Objekte, auf die Sie zoomen, nicht verdecken möchten.	Point	[0, 0]
paddingBottomRight	Das Gleiche gilt für die untere rechte Ecke der Karte.	Point	[0, 0]
padding	Entspricht der Einstellung des Rand-Paddings für sowohl oben links als auch unten rechts. Es wird derselbe Wert gesetzt.	Point	[0, 0]
maxZoom	Die maximal mögliche Zoomstufe, die Sie verwenden können.	int	null