ym.modules.provider.TileLayer

Überblick

Dient zum Laden und Anzeigen von Kachelebenen auf der Karte. Implementiert die ILayer-Schnittstelle.

Beispielaufruf

 L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png?{foo}', {foo: 'bar'}).addTo(map);

Initialisierung

Factory: ym.tileLayer(urlTemplate, options)

Instanziiert ein Tile-Layer-Objekt mit einer URL-Vorlage und optional einem Optionen-Objekt.

Parameter

Name Beschreibung Datentyp Standardwert
bounds [erforderlich] string  
options [optional] TileLayerOptions  

Parameter: urlTemplate

Eine Zeichenkette der folgenden Form:

http://{s}.somedomain.com/anything/{z}/{x}/{y}.png

{s} bedeutet eine der verfügbaren Subdomains (wird sequentiell verwendet, um bei browserparallelen Anfragen pro Domainbegrenzung zu helfen; Subdomainwerte werden in Optionen angegeben; {z} — Zoomstufe, {x} und {y} — Kachelkoordinaten.

Sie können benutzerdefinierte Schlüssel in der Vorlage verwenden, die über die TileLayer-Optionen ausgewertet werden:

 L.tileLayer('http://{s}.somedomain.com/{foo}/{z}/{x}/{y}.png', {foo: 'bar'});

Parameter: options

Name Beschreibung Datentyp Standardwert
attribution Zum Beispiel "© SmartMaps" – die von der Attributionskontrolle verwendete Zeichenfolge beschreibt die Layerdaten. string ''
bounds Wenn diese Option gesetzt ist, lädt TileLayer nur Kacheln, die sich in den angegebenen geographischen Grenzen befinden. LatLngBounds null
continuousWorld Wenn auf true gesetzt, werden die Kachelkoordinaten nicht um die Weltbreite (-180 bis 180 Längengrad) gewickelt oder so geklemmt, dass sie innerhalb der Welthöhe (-90 bis 90) liegen. Verwenden Sie diese Option, wenn Sie das Faltblatt für Karten verwenden, die nicht die reale Welt widerspiegeln (zum Beispiel Spiel-, Innen- oder Fotokarten). bool false
detectRetina Wenn true und der Benutzer sich auf einem Retina-Display befindet, fordert er vier Kacheln der halben Größe und eine höhere Zoomstufe an, um die hohe Auflösung zu nutzen. bool false
errorTileUrl URL zum Kachelbild, das anstelle derjenigen Kachel, die nicht geladen werden konnte, angezeigt wird. string ''
maxNativeZoom Maximale Zoomzahl, die die Kachelquelle zur Verfügung stellt. Wenn angegeben, werden die Kacheln auf allen Zoomstufen höher als maxNativeZoom aus der Stufe maxNativeZoom geladen und automatisch skaliert. int null
maxZoom Maximale Zoomzahl. int 18
minZoom Minimale Zoomzahl. int 0
noWrap Wenn auf true gesetzt, werden die Kacheln nur außerhalb der Weltbreite (-180 bis 180 Längengrad) geladen, anstatt sich zu wiederholen. bool false
opacity Die Undurchsichtigkeit der Fliesenschicht. int 1.0
reuseTiles Wenn true, werden alle Kacheln, die nach dem Panning nicht sichtbar sind, in eine Wiederverwendungswarteschlange gestellt, aus der sie geholt werden, wenn neue Kacheln sichtbar werden (im Gegensatz zur dynamischen Erstellung neuer). Dies wird den Speicherverbrauch gering halten und die Notwendigkeit, Speicher für neue Kacheln zu reservieren eliminieren. bool false
subdomains Subdomains des Kacheldienstes. Kann in Form einer Zeichenkette (wobei jeder Buchstabe ein Subdomainname ist) oder eines Arrays von Zeichenketten übergeben werden. string oder string[] 'abc'
tileSize Kachelgröße (Breite und Höhe in Pixel, vorausgesetzt, die Kacheln sind quadratisch). int 256
tms Wenn true, wird die Nummerierung der Y-Achse für Kacheln umgekehrt (für TMS-Dienste einschalten). bool false
unloadInvisibleTiles Wenn true, werden alle Kacheln, die nach dem Panning nicht sichtbar sind, entfernt (für bessere Performance). Ist standardmäßig true auf mobilem WebKit, sonst false. bool  
updateWhenIdle Wenn false, werden neue Tiles beim Panning geladen, ansonsten erst danach (für bessere Performance). Ist standardmäßig true auf mobilem WebKit, sonst false. bool  
zIndex Der explizite zIndex der Kachelschicht. Nicht standardmäßig eingestellt. int null
zoomOffset Die in Kachel-URLs verwendete Zoomzahl wird um diesen Wert ergänzt. int 0
zoomReverse Wenn auf true gesetzt, wird die in den Kachel-URLs verwendete Zoom-Nummer umgekehrt (maxZoom - zoom statt zoom). bool false

Ereignisse ab v3

Ereignis Ereignistyp Beschreibung
loading Event Wird ausgelöst, wenn die Kachelschicht mit dem Laden der Kacheln beginnt.
load Event Wird ausgelöst, nachdem die Kachelschicht alle sichtbaren Kacheln geladen hat.
tileloadstart TileEvent Wird ausgelöst, wenn eine Kachel angefordert wird und zu laden beginnt.
tileload TileEvent Wird ausgelöst, wenn ein Tile geladen wird.
tileunload TileEvent Wird ausgelöst, wenn eine Kachel entfernt wird (zum Beispiel, wenn Sie unloadInvisibleTiles eingeschaltet haben).
tileerror TileEvent Wird ausgelöst, wenn ein Fehler beim Laden einer Kachel auftritt.

Methoden

addTo(map) ab v3

Adds the layer to the map.

Parameter

Name Beschreibung Datentyp Standardwert
map   Map  

Rückgabe

this

bringToFront() ab v3

Brings the tile layer to the top of all tile layers.

Rückgabe

this

bringToBack() ab v3

Brings the tile layer to the bottom of all tile layers.

Rückgabe

this

setOpacity(opacity) ab v3

Changes the opacity of the tile layer.

Parameter

Name Beschreibung Datentyp Standardwert
opacity   int  

Rückgabe

this

setZIndex(zIndex) ab v3

Sets the zIndex of the tile layer.

Parameter

Name Beschreibung Datentyp Standardwert
zIndex   int  

Rückgabe

this

redraw() ab v3

Causes the layer to clear all the tiles and request them again.

Rückgabe

this

setUrl(urlTemplate) ab v3

Updates the layer’s URL template and redraws it.

Parameter

Name Beschreibung Datentyp Standardwert
urlTemplate string

Rückgabe

this

getContainer() ab v3

Returns the HTML element that contains the tiles for this layer.

Rückgabe

HTMLElement