Layers
The layer is the primary building block of a map. Every map requires a minimum of one layer, but it's possible to have multiple layers. This feature can be utilized for various purposes, including the creation of multi-floor maps.
To start crafting a map, the first action is to set up your layer by adding an image or vector file. It's important to note that you can replace this file whenever necessary.
If the map was generated using the Add new button, a layer is already preconfigured.
Layers can be reordered using drag-and-drop.
Layer properties
| Property | Key | Description |
|---|---|---|
| ID | id * | Unique layer identifier. |
| File | file | URL to a base map file. SVG, PNG and JPG formats supported. |
| Name | name * | Display name of the layer. |
Options
It's critical to verify that the map file's width and height settings are precise. Incorrect configurations may result in distorted maps and inaccurately positioned locations.
In the case of multi-level maps, it's important that all layers have matching width and height dimensions.
| Option | Key | Description |
|---|---|---|
| File width | mapWidth * | Width of the map file in pixels. |
| File height | mapHeight * | Height of the map file in pixels. |
| Default | layer | The first layer will be selected if default is not explicitly defined. |
| Selector | layerSwitcher | Position of the layer switcher control. It can also be turned off if no position is selected. |
Geocalibration
Maps in the web mercator projection (EPSG:3857) can be geocalibrated by defining the map extent. This process enables the population of locations using latitude and longitude coordinates.
The built-in geographic maps are typically already geocalibrated and ready to use.
| Option | Key | Description |
|---|---|---|
| Extent | extent | The map file's bounding coordinates. |