Skip to content

Imagery

Adding extra imagery layers is simple. In the imagery section, specify imagery layers as a map of maps:

imagery:
  IPR-orotofoto-last-tms:
    name: "Praha IPR latest orthophoto"
    url: "https://osm-{switch:a,b,c}.zby.cz/tiles_ipr_last.php/{zoom}/{x}/{y}.jpg"
    maxZoom: 20
    attribution: "IPR Praha; OSM CZ"
  turkuOrto:
    name: "City of Turku ortophoto"
    type: wms
    url: "https://opaskartta.turku.fi/TeklaOGCWeb/WMS.ashx?FORMAT=image/png&TRANSPARENT=TRUE&VERSION=1.1.1&SERVICE=WMS&REQUEST=GetMap&LAYERS=Ilmakuva 2021&STYLES=&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox}"
    minZoom: 4
    maxZoom: 20
    attribution: "© Turun kaupunki"
  nommeTest:
    url: nomme-test.mbtiles
    maxZoom: 18

Available keys are:

  • url: the only required key, layer URL templated the same as in the editor layer index.
  • name: how the layer is listed in the imagery panel.
  • type: one of those:
    • tms: a regular tile service with URLs usually ending in /{zoom}/{x}/{y}.png
    • wms: a WMS service, like the turkuOrto in the example. This type is implied when the URL contains SERVICE=WMS.
    • mbtiles: a packaged MBTiles file. This type is implied when the url (which should point to the file) ends with .mbtiles. A web URL would probably fail.
  • attribution: the string displayed on the screen when the layer is active.
  • minZoom and maxZoom: self-explanatory, integer numbers.
  • wms4326: a boolean field that should be true for WMS layers which support EPSG:4326, but not 3857.
  • tileSize: for TMS layers, defaults to 256.

To change the base map layer, use base for an imagery key. For example:

imagery:
  base:
    name: "Topo Map"

Overlays

Initially Every Door displays a single map layer: either OpenStreetMap-based for the base map, or an imagery layer. For thematic or directed mapping you might need to add more layers: for example, a semi-transparent tile layer with a heatmap, or display polygons for an area to confine the mapping effort.

With plugins, it's pretty simple: add an overlays key with a list of layers in the same format.

overlays:  
 - url: "https://tile.waymarkedtrails.org/cycling/{zoom}/{x}/{y}.png"  
   maxZoom: 17  
 - url: map.geojson

With overlays, you can also use a geojson type. It is automatically inferred when the URL ends with a .geojson or a .json. URLs are supported, but if the url value does not start with http, it is assumed to be a file inside the plugin.