Skip to main content

Templated Images Layer

In this section, we will learn how to create a templated image layer. A templated image layer is a layer that fetches a single image file on pans and zooms.

Adding a templated image layer#

<layer- label="Toporama" checked>
<meta name="zoom" content="min=4,max=5" />
<extent units="CBMTILE">
<input name="z" type="zoom" value="19" min="4" max="4" />
<input name="w" type="width" />
<input name="h" type="height" />
<input name="xmin" type="location" units="pcrs" position="top-left" axis="easting" min="-6207743" max="3952277" />
<input name="ymin" type="location" units="pcrs" position="bottom-left" axis="northing" min="-3362085" max="3952277" />
<input name="xmax" type="location" units="pcrs" position="top-right" axis="easting" min="-6207743" max="3952277" />
<input name="ymax" type="location" units="pcrs" position="top-left" axis="northing" min="-3362085" max="3952277" />
<link rel="image" tref="http://my-wms.ca?FORMAT=image/jpeg&amp;WIDTH={w}&amp;HEIGHT={h}&amp;BBOX={xmin},{ymin},{xmax},{ymax}" />
</extent>
</layer->

Associated Elements#

<extent>#

  • units
    • This allows you to define what the projection of the templated tiles are.

<input>#

  • axis

    • This attribute is only useful on inputs of type location, it sets the axis the following input defines. This value also defines what the min and max value's units.
    • Options are, row | column | easting | northing | latitude | longitude
  • name

    • This allows you to name the input, this name is then used in the url template used in the <link> href attribute.
  • type

    • Sets the type of the input.
    • Options are, zoom | location | width | height
  • max

    • Sets the maximum of the bounds of the layer on the given axis.
  • min

    • Sets the minimum of the bounds of the layer on the given axis.
  • position

    • Sets the position of the input, this can either be top-left or bottom-right.
  • value

    • Sets the zoom level the inputs of type location's min and max are defined at.

<link>#

  • rel

    • Set this to image in the case of a templated image layer.
  • title

    • Sets the title of the layer, this is the title shown in the layer controls.
  • type

    • Sets the type of the returned data.
  • tref

    • Sets the templated url of the templated tile layer, this must contain all the names of the inputs used to query a given tile.

Additional Context#

You can also provide a set of elements to further define the templated tile layer. This is the list of available additions with examples.

<meta name="zoom">#

Sets the zoom range of the layer, in the following example the user can zoom from zoom level 1 to 5.

<meta name="zoom" content="min=1,max=5" />

Full Examples#

<mapml-viewer projection="CBMTILE" zoom="4" lat="53.331" lon="-91.667" controls>
<layer- label="Toporama" checked>
<meta name="zoom" content="min=4,max=5" />
<extent units="CBMTILE">
<input name="z" type="zoom" value="19" min="4" max="4" />
<input name="w" type="width" />
<input name="h" type="height" />
<input name="xmin" type="location" units="pcrs" position="top-left" axis="easting" min="-6207743.103886206" max="3952277.216154434" />
<input name="ymin" type="location" units="pcrs" position="bottom-left" axis="northing" min="-3362085.3441706896" max="3952277.216154434" />
<input name="xmax" type="location" units="pcrs" position="top-right" axis="easting" min="-6207743.103886206" max="3952277.216154434" />
<input name="ymax" type="location" units="pcrs" position="top-left" axis="northing" min="-3362085.3441706896" max="3952277.216154434" />
<link rel="image" tref="http://wms.ess-ws.nrcan.gc.ca/wms/toporama_en?SERVICE=WMS&amp;REQUEST=GetMap&amp;FORMAT=image/jpeg&amp;TRANSPARENT=FALSE&amp;STYLES=&amp;VERSION=1.3.0&amp;LAYERS=WMS-Toporama&amp;WIDTH={w}&amp;HEIGHT={h}&amp;CRS=EPSG:3978&amp;BBOX={xmin},{ymin},{xmax},{ymax}&amp;m4h=t" />
</extent>
</layer->
</mapml-viewer>

[ADD MAP HERE]