A leaflet layer for non-tiled overlays.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 3 commits ahead, 179 commits behind ptv-logistics:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


While Leaflet handles the de-facto standard for stitching a map from tiles very well, i haven't found a concept for imagery data that cannot be queried in tiles.

Not all imagery providers can handle tiles properly, for example if they render labels dynamically. So i've added a Leaflet.NonTiledLayer which gets the imagery for the complete map viewport whenever it changes. Leaflet.NonTiledLayer.WMS is the implementation that makes WMS requests, similar to the TileLayer.WMS.

You can see a demo here:


It uses the WMS service of xMap-Server http://xserver.ptvgroup.com/en-uk/products/ptv-xserver/ptv-xmap/ from PTV Group, which requires a tiled/non-tiled hybrid approach (and that is the reason i've built this). The sample also displays an OSM WMS overlay that also cannot be requested in tiles.

The supported options

  • attribution - the attribution text for the layer data
  • opacity - the opacity value between 0.0 and 1.0; default = 1.0
  • minZoom - the minimum zoom level for which the overlay is requested
  • maxZoom - the maximum zoom level for which the overlay is requested
  • zIndex - z-index of the images
  • pane - the pane where the child div is inserted; default: undefined (div inserted at overlayPane).

The pane and zIndex properties allow to fine-tune the layer ordering. For example, it is possible to insert a NonTiledLayer between two layers the tilePane, like the labels in, or on top of the vector shapes, like the labels in http://ptv-logistics.github.io/fl-labs/.

You can build your own NonTiledLayer by inheriting from NonTiledLayer and implementing either the function getImageUrl or getImageUrlAsync. The getImageUrl just returns an uri and is used by the WMS implementation. The getImageUrlAsync can be used for services that not only return images, but also additional context information for interaction. The project https://github.com/ptv-logistics/Leaflet.PtvLayer uses this method.