Methoden (Karte)
Methoden zum Ändern des Kartenstatus
| Name | Rückgabe | Beschreibung |
|---|---|---|
| setView(LatLng center, int zoom?, zoom/pan options options?) | this | Legt die Ansicht der Karte (geografisches Zentrum und Zoom) mit den angegebenen Animationsoptionen fest. |
| setZoom(int zoom, zoom options options?) | this | Setzt den Zoom der Karte. |
| zoomIn(int delta?, zoom options options?) | this | Erhöht den Zoom der Karte um delta (Standardwert 1). |
| zoomOut(int delta?, zoom options options?) | this | Verringert den Zoom der Karte um delta (Standardwert 1). |
| setZoomAround(LatLng latlng, int zoom, zoom options options?) | this | Verkleinert die Karte, während ein bestimmter Punkt auf der Karte unverändert bleibt (wird intern für Scroll-Zoom und Doppelklick-Zoom verwendet). |
| fitBounds(LatLngBounds bounds, fitBounds options options?) | this | Legt eine Kartenansicht fest, die die angegebenen geografischen Grenzen mit der maximal möglichen Zoomstufe enthält. |
| fitWorld(fitBounds options options?) | this | Legt eine Kartenansicht fest, die üblicherweise die gesamte Welt mit der maximal möglichen Zoomstufe enthält. |
| panTo(LatLng latlng, pan options options?) | this | Verschiebt die Karte zu einem bestimmten Zentrum. Animiert die Verschiebung, wenn das neue Zentrum nicht mehr als einen Bildschirm vom aktuellen Zentrum entfernt ist. |
| panInsideBounds(LatLngBounds bounds, pan options options?) | this | Verschiebt die Karte zur nächstgelegenen Ansicht, die innerhalb der angegebenen Grenzen liegt (falls nicht bereits dort), und steuert die Animation mit den angegebenen Optionen, sofern vorhanden. |
| panBy(Point point, pan options options?) | this | Verschiebt die Karte um eine bestimmte Anzahl von Pixeln (animiert). |
| invalidateSize(bool animate) | this | Prüft, ob sich die Größe des Kartencontainers geändert hat, und aktualisiert die Karte; falls ja, nach dynamischer Änderung der Kartengröße aufrufen, standardmäßig wird die Verschiebung ebenfalls animiert. |
| invalidateSize(zoom/pan options options) | this | Prüft, ob sich die Größe des Kartencontainers geändert hat, und aktualisiert die Karte; falls ja, nach dynamischer Änderung der Kartengröße aufrufen, standardmäßig wird die Verschiebung ebenfalls animiert. |
| setMaxBounds(LatLngBounds bounds) | this | Beschränkt die Kartenansicht auf die angegebenen Grenzen. |
| locate(Locate options options?) | this | Versucht, den Standort des Benutzers über die Geolocation API zu ermitteln, und löst anschließend ein locationfound-Event aus. Bei Erfolg werden die Standortdaten zurückgegeben, andernfalls locationerror. Setzt optional die Kartenansicht auf den Standort des Benutzers entsprechend der Erkennungsgenauigkeit (oder auf die Weltansicht, falls die Geolokalisierung fehlgeschlagen ist). |
| stopLocate() | this | Beendet die Standortermittlung durch map.locate({watch: true}) und bricht das Zurücksetzen der Karte ab, falls map.locate wie folgt aufgerufen wurde: {setView: true}. |
| remove() | this | Zerstört die Karte und löscht alle damit verbundenen Event-Receiver. |
Methoden zum Auslesen des Kartenstatus
| Name | Rückgabe | Beschreibung |
|---|---|---|
| getCenter() | LatLng | Gibt das geografische Zentrum der Kartenansicht zurück. |
| getZoom() | int | Gibt den aktuellen Zoom der Kartenansicht zurück. |
| getMinZoom() | int | Gibt die minimale Zoomstufe der Karte zurück. |
| getMaxZoom() | int | Gibt die maximale Zoomstufe der Karte zurück. |
| getBounds() | LatLngBounds | Gibt die LatLngBounds der aktuellen Kartenansicht zurück. |
| getBoundsZoom(LatLngBounds bounds, bool inside?) | int | Gibt die maximale Zoomstufe zurück, bei der die angegebenen Grenzen vollständig in die Kartenansicht passen. Ist inside (optional) auf true gesetzt, gibt die Methode stattdessen die minimale Zoomstufe zurück, bei der die Kartenansicht vollständig innerhalb der angegebenen Grenzen liegt. |
| getSize() | Point | Gibt die aktuelle Größe des Kartencontainers zurück. |
| getPixelBounds() | Bounds | Gibt die Grenzen der aktuellen Kartenansicht in projizierten Pixelkoordinaten zurück (manchmal nützlich bei Layer- und Overlay-Implementierungen). |
| getPixelOrigin() | Point | Gibt die projizierten Pixelkoordinaten des oberen linken Punkts des Karten-Layers zurück (nützlich für benutzerdefinierte Layer- und Overlay-Implementierungen). |
Methoden für Layer und Steuerelemente
| Name | Rückgabe | Beschreibung |
|---|---|---|
| addLayer(ILayer layer) | this | Fügt der Karte den angegebenen Layer hinzu. |
| removeLayer(ILayer layer) | this | Entfernt den angegebenen Layer von der Karte. |
| hasLayer(ILayer layer) | bool | Gibt true zurück, wenn der angegebene Layer aktuell zur Karte hinzugefügt ist. |
| eachLayer(Function fn, Object context?) | this | Iteriert über die Layer der Karte und übergibt optional den Kontext der Iterator-Funktion. |
| openPopup(Popup popup) | this | Öffnet das angegebene Pop-up und schließt dabei das zuvor geöffnete. |
| openPopup(String html | HTMLElement el, LatLng latlng, Popup options options?) | this | Erstellt ein Pop-up mit den angegebenen Optionen und öffnet es an der angegebenen Stelle auf einer Karte. |
| closePopup(Popup popup?) | this | Schließt das zuvor mit openPopup geöffnete Pop-up (oder das angegebene). |
| addControl(IControl control) | this | Fügt der Karte das angegebene Control hinzu. |
| removeControl(IControl control) | this | Entfernt das angegebene Control von der Karte. |
Konvertierungsmethoden
| Name | Rückgabe | Beschreibung |
|---|---|---|
| latLngToLayerPoint(LatLng latlng) | Point | Gibt den Punkt des Karten-Layers zurück, der den angegebenen geografischen Koordinaten entspricht. |
| layerPointToLatLng(Point point) | LatLng | Gibt die geografischen Koordinaten eines angegebenen Karten-Layer-Punkts zurück. |
| containerPointToLayerPoint(Point point) | Point | Wandelt den Punkt relativ zum Kartencontainer in einen Punkt relativ zum Karten-Layer um. |
| layerPointToContainerPoint(Point point) | Point | Wandelt den Punkt relativ zum Karten-Layer in einen Punkt relativ zum Kartencontainer um. |
| latLngToContainerPoint(LatLng latlng) | Point | Gibt den Kartencontainer-Punkt zurück, der den angegebenen geografischen Koordinaten entspricht. |
| containerPointToLatLng(Point point) | LatLng | Gibt die geografischen Koordinaten eines angegebenen Kartencontainer-Punkts zurück. |
| project(LatLng latlng, Number zoom?) | Point | Projiziert die angegebenen geografischen Koordinaten für die angegebene Zoomstufe auf absolute Pixelkoordinaten. |
| unproject(Point point, Number zoom?) | LatLng | Projiziert die angegebenen absoluten Pixelkoordinaten für die angegebene Zoomstufe auf geografische Koordinaten. |
| mouseEventToContainerPoint(MouseEvent event) | Point | Gibt die Pixelkoordinaten eines Mausklicks relativ zum Kartencontainer zurück. |
| mouseEventToLayerPoint(MouseEvent event) | Point | Gibt die Pixelkoordinaten eines Mausklicks relativ zum Karten-Layer zurück. |
| mouseEventToLatLng(MouseEvent event) | LatLng | Gibt die geografischen Koordinaten des Punkts zurück, auf den geklickt wurde. |
Weitere Methoden
| Name | Rückgabe | Beschreibung |
|---|---|---|
| getContainer() | HTMLElement | Gibt das Container-Element der Karte zurück. |
| getPanes() | MapPanes | Gibt ein Objekt mit verschiedenen Kartenbereichen zurück (zum Rendern von Overlays). |
| whenReady(Function fn, Object context?) | this | Führt den angegebenen Callback aus, wenn die Karte mit einem Standort und Zoom initialisiert wurde, oder sofort, wenn die Initialisierung bereits abgeschlossen ist. |