Map is based on OpenLayers. The element must be integrated into the Map area.



  • Title: Title of the element. The title will be listed in “Layouts” and allows to distinguish between different buttons. It will be indicated if “Show label” is activated.

  • Layersets: Refers to a layerset. Layersets have to be defined first and can then be referred to.

  • Tile size: Size of the tiles of tiled WMS services.

  • SRS: Spatial reference system. Two ways of SRS definitions are supported: EPSG:CODE or EPSG:CODE|MY SRS TITLE.

  • Max. Extent: Maximal map extent, defined by BBOX parameters.

  • Start Extent: Map extent that is visible at application launch. Defined by BBOX parameters.

  • Default resolution [dpi]: The default resolution adapts to the screen resolution based on the configured value in dpi. Default: 96 dpi.

  • Fixed zoom steps: This option activates a zoom behaviour with fixed scales. This is useful to increase visual quality of services that are cached on very particular resolution steps only. When set true, scale denominator snaps to one of the values given in the scales option as defined below (default: false).

  • Scales (csv): A csv scale list. These scales will be supported in your application if you zoom (e.g. via mouse wheel)

  • Other SRS: Other spatial reference systems. Two SRS definitions are supported: EPSG:CODE or EPSG:CODE|MY SRS TITLE.

Configuration example

The map element has to be included into the Map area:


The map can entail all instances that are defined in the layerset. The following example distinguishes between a main (1) and overview (2) layerset.


In order to display all Layersets on the map, they have to be activated. Multiple selections are possible as well. De-selected layersets can function as an Overview. In the example, main is displayed on the main map and overview as an overview map.

The field SRS defines the coordinate reference system that is used at application start. In this example, the coordinate reference system EPSG:25832 or ETRS89/UTM Zone 32N was chosen. If the application should support other coordinate systems, simply add those in the Other SRS field. In this example, the following codes are used: EPSG:25833 (ETRS89/UTM Zone 33N), EPSG:31466 (DHDN/3-degree Gauss-Kruger Zone 2), EPSG:31467 (DHDN/3-degree Gauss-Kruger Zone 3), EPSG:3857 (WGS 84/Pseudo-Mercator) and EPSG:4326 (WGS 84).

The field max. Extent states the maximum zoomable extent of the map application. If there is data outside of the extent, it will not appear in the map. The field start Extent refers to the extent of the map that is visible when the application is started in the browser (in this example: the city of Bonn).

The Default resolution in dpi defines the resolution of the device being used; the corresponding default value of 96 dpi can be adjusted through this field. If the displayed resolution of the map does not match that of the WMS service, changing this value can help to align the map accordingly.


The scale-dependent resolution currently only works reliably on desktops with regular resolution. Moreover, Default resolution is only available from Mapbender 3.3.5 onwards.

Furthermore, the field scales (csv) defines the scales that are usable in the application. It is possible to switch between the defined scales with Scale Selector or Navigation Toolbar. Fixed zoom steps were deactivated in the example. That means it is possible to display undefined zoom levels via mouse scrolling.


This template can be used to include the map into a YAML application.

layerset: null             # refer to a layerset, define the layerset first and refer to it
srs: "EPSG:4326"           # coordinate reference system. Two ways of srs definitions are supported:
                             - "EPSG:CODE" or
                             - "EPSG:CODE|MY SRS TITLE"
    max: [0, 40, 20, 60]    # maximal map extents
    start: [5, 45, 15, 55]  # map extents for the start of the application
scales: "25000000,10000000,5000000,1000000,500000" # a csv scale list
    - EPSG:31466
    - EPSG:31467
    - EPSG:25832          # other coordinate reference systems. Two srs definitions are supported:
                             - ["EPSG:CODE","EPSG:CODE"] or
                             - ["EPSG:CODE|MY SRS TITLE","EPSG:CODE|MY SRS TITLE"]
tileSize: 256             # size of tiles

Controlling by URL-parameters

Make Layer visible

If you have a layer with the id <layerid> in a service with the id <serviceid>, you may pass the URL parameter visiblelayers to turn the layer visible:


You may also pass multiple layers separated by comma.

The layerid and serviceid values are specific to an application. You can get the layerid and serviceid in the specific application, namely in the layerset and there in a layer. Each layer has an icon with three small dots on the right side. Click on the icon and a popup window will appear.


The first value lists the internal SourceID and SourceLayerId (31-591). The seconds value lists the InstanceID and InstanceLayerId that we want to use now (73-836).

Use this values for the “visibleLayers” parameter in your URL, and seperate them by a slash.

For example: http://localhost/mapbender/application/myapp?visiblelayers=73/836

If you have two layers that are not visible by default, put the two values of layerid and serviceid into the URL and seperate them by a comma.

For example: http://localhost/mapbender/application/myapp?visiblelayers=73/836,73/840

Passing POIs

You can pass one or more POIs in the URL. Each POI has the following parameters:

  • point: coordinate pair with values separated by comma (mandatory)

  • label: Label to display (optional)

  • scale: Scale to show POI in (optional, makes only sense with one POI)

If you pass more than one POI, the map will zoom to 150% of the POIs bounding.

To pass a single POI, use the following URL format:


Passing BBOX

You can pass a BBOX to zoom to by using the following URL query parameter:


Passing the scale

You can set the scale from the list of available scales.


Passing SRS

You can pass a favorite EPSG code you want to use on start of the application by URL query parameter:


Passing Center

You can pass a coordinate. The application will open and display the coordinate in the center. In this case, you also have to set the SRS.


More Start Parameters

The elements WMS Loader and WMC Loader also provide parameters you can use on start. Have a look at the element descriptions for further information.