Map Layers
Map layers are the fundamental building blocks for visualizing and interacting with spatial data in the application. Each layer type supports different data sources and formats, such as raster images, vector features, or external services, allowing users to combine and manage diverse geospatial information in a single map view. Layers can be organized into folders or groups for better structure and usability, and their configuration determines how data is displayed, queried, and interacted with.
Layer Types Overview
| Layer Type | Vector | Raster |
|---|---|---|
| lids-map-layer-attachments | ✔️ | |
| lids-map-layer-bing | ✔️ | |
| lids-map-layer-cluster | ✔️ | |
| lids-map-layer-esri-vector | ✔️ | |
| lids-map-layer-feature-api | ✔️ | |
| lids-map-layer-file | ✔️ | |
| lids-map-layer-folder | ✔️ | ✔️ |
| lids-map-layer-geojson | ✔️ | |
| lids-map-layer-geotiff | ✔️ | |
| lids-map-layer-grid | ✔️ | |
| lids-map-layer-group | ✔️ | ✔️ |
| lids-map-layer-heatmap | ✔️ | |
| lids-map-layer-markers | ✔️ | |
| lids-map-layer-query-vector | ✔️ | |
| lids-map-layer-shp | ✔️ | |
| lids-map-layer-tms | ✔️ | |
| lids-map-layer-vector-url | ✔️ | |
| lids-map-layer-wfs | ✔️ | |
| lids-map-layer-wms | ✔️ | |
| lids-map-layer-wms-geojson | ✔️ | |
| lids-map-layer-wms-getcapabilities | ✔️ | |
| lids-map-layer-wmts | ✔️ |
lids-map-layer-attachments
Vector
This layer type manages and displays files attached to map features, such as images, documents, or PDFs. It allows users to view, add, or download attachments that provide additional information or context for spatial objects on the map.
{
"id": "attachmentsLayer",
"type": "lids-map-layer-attachments",
"title": "Attachments"
},
lids-map-layer-bing
Raster
A Bing Maps layer displays raster imagery from Microsoft Bing Maps service. It supports various imagery types including Road, Aerial, and AerialWithLabels. Requires a valid Bing Maps API key.
lids-map-layer-cluster
Vector
Cluster layer groups nearby points into clusters, which are displayed as single symbols with a count, improving map clarity and performance for large datasets.
{
"id": "cluster",
"type": "lids-map-layer-cluster",
"title": "cluster layer",
"distance": "45",
"condition": "click",
"markdownInfo": {
"content": "<html><body><table><tbody><tr><td style='width: auto; border:none);'><div style='margin-bottom:5px;font-size:1.15em;font-family:Roboto;font-weight:bold;'>Správa členské základny - zde i nečlenové <span style='margin-bottom:5px;font-size:0.83em;font-family:Roboto;font-weight:normal;'>oznameni ponechat zobrazene- resi se jedna drobnost na SAMO-HD <a href='http://ris-dev.asseco-ce.com/' target='_blank' style='display:inline'>Více zde</a></span></div></td></tr></tbody></table></body></html>"
},
"labelStyle": {
"Text": {
"symbolHeight": "12",
"offsetX": 0,
"offsetY": 0,
"strokeColor": "rgba(0,0,0,0.4)",
"fillColor": "#fff",
"strokeWidth": 4
}
},
"clusterStyle": {
"Circle": {
"fillColor": "rgba(96, 198, 253, 0.5)",
"strokeColor": "rgb(2, 136, 209)",
"strokeWidth": 2
}
},
"sourceLayer": {
"id": "setdefinition_2011050282"
}
}
lids-map-layer-esri-vector
Vector
An ESRI vector layer connects to ESRI vector services, allowing advanced rendering and querying of vector features.
{
"id": "esri_nuts_3",
"title": "NUTS_3_esri_layer",
"type": "lids-map-layer-esri-vector",
"properties": {
"url": "https://services.arcgis.com/P3ePLMYs2RVChkJx/ArcGIS/rest/services/Europe_NUTS_3_Demographics_and_Boundaries/FeatureServer/0"
},
"visible": false
},
lids-map-layer-feature-api
Vector Deprecated
This layer type was used to connect to a backend API for loading and displaying vector features on the map.
{
"id": "water-all-feature-api",
"title": "Water all - Feature API",
"type": "lids-map-layer-feature-api",
"request": {
"output": {
"graphics": {"graphicTags": {}}
},
"preset": {
"type": "mapLayers",
"layers": [
"setdefinition_2011050282"
]
}
}
},
lids-map-layer-file
Vector
A file layer allows users to upload and display vector data from local files in various formats, such as GeoJSON, KML, or GPX. This enables quick visualization and analysis of custom datasets without requiring server-side configuration.
lids-map-layer-folder
Vector Raster
A folder layer does not display any data itself. It is used purely for organizing layers into a hierarchical structure, and folders can be nested to any depth for better management of complex layer trees.
{
"id": "rs_folder",
"title": "Redlining + Sketch as folder",
"layers": [
{
"id": "cat_5070000"
},
{
"id": "cat_5080000"
}
]
},
lids-map-layer-geojson
Vector
A GeoJSON layer displays vector data from GeoJSON files or objects. It allows you to visualize points, lines, and polygons directly on the map, supporting custom styling and interactivity.
{
"type": "lids-map-layer-geojson",
"title": "{tr:map.layerSearchResult}",
"visible": true,
"optional": true
}
lids-map-layer-geotiff
Raster
A GeoTIFF layer displays raster data from GeoTIFF files, such as satellite imagery, elevation models, or other gridded datasets. It is useful for visualizing high-resolution backgrounds or performing raster-based spatial analysis.
lids-map-layer-grid
Vector
A grid layer displays a vector grid overlay on the map. It can show points and/or lines at configurable intervals, useful for coordinate reference or measurement assistance. Supports both screen-based and map-based grid sizing.
lids-map-layer-group
Vector Raster
A group layer also does not display any data itself. It combines multiple layers into a single logical unit, so you can control their visibility and settings together as if they were one layer.
{
"id": "group_example",
"type": "lids-map-layer-group",
"title": "Ukázková skupina vrstev",
"icon": "samo-demo-icons:folder",
"iconOpened": "samo-demo-icons:folder-open",
"layers": [
{
"id": "cat_5010000"
},
{
"id": "cat_5040000"
}
]
},
lids-map-layer-heatmap
Vector
Heatmap layer visualizes the density of points or features as a smooth color gradient, making it easy to identify areas with high or low concentrations of data.
{
"id": "heatMap",
"type": "lids-map-layer-heatmap",
"title": "heatMap",
"sourceLayer": {
"id": "setdefinition_2011050282"
},
"markdownInfo": {
"contentResource": "resource:help/about_{lang:}.md"
}
}
lids-map-layer-markers
Vector
A markers layer displays a collection of point markers with optional tooltips on the map. Each marker can have custom styling, coordinates, and content that appears on click. Useful for highlighting specific locations or points of interest.
lids-map-layer-query-vector
Vector New
This is a new layer type that allows querying and displaying vector data based on user-defined criteria or filters. It supports interactive exploration and visualization of spatial features that match specific query conditions.
{
"id": "water-all-query-vector-evaluateStylesByZoom",
"title": "W all - Query Vector evaluateStylesByZoom",
"type": "lids-map-layer-query-vector",
"request": {
"output": {
"graphics": {"graphicTags": {}}
},
"preset": {
"type": "mapLayers",
"layers": [
"setdefinition_2011050282"
]
}
},
"properties": {
"evaluateStylesByZoom": true
}
},
lids-map-layer-shp
Vector
A shapefile layer allows users to upload and display spatial data from Shapefile format (.shp, .dbf, .shx, etc.). It is commonly used for visualizing and working with vector data such as points, lines, and polygons from local files.
lids-map-layer-tms
Raster
A TMS (Tile Map Service) layer provides raster map tiles from a TMS-compliant server. It is used for efficient map rendering and navigation, supporting custom tile grids and resolutions for specialized mapping applications.
{
"title": "{tr:map.layerCityMap}",
"type": "lids-map-layer-tms",
"visible": false,
"optional": true,
"gatewayEntity": "tms",
"gatewayEntityGroup": "samo-layers-tms",
"properties": {
"layerName": "tms_citymap",
"opacity": "0.63",
"origin": [3449000.0, 5450250.0],
"resolutions": [
45.00002430000002, 15.0000081, 5.0000027, 1.66666756666667
],
"extent": [
3449000.8333333335, 3494023.3333333335, 5450227.5, 5495226.666666667
],
"tileSize": [1000, 1000]
}
},
lids-map-layer-vector-url
Vector
A vector URL layer loads vector data directly from a URL, such as a WFS service or other vector data endpoint. It supports custom styling and is useful for integrating external vector data sources into the map.
{
"id": "wfs_plna",
"title": "Swiss:4326 (47.165370,8.433172)",
"optional": true,
"type": "lids-map-layer-vector-url",
"visible": false,
"properties": {
"maxScale": 40000,
"url": "https://geodienste.ch/db/av_0?SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAME=ms:PLNA&SRSNAME=EPSG:4326",
"geometryName": "msGeometry",
"styleMap": {
"PLNA": {
"symbolizer": {
"charCode": 9654,
"fontFamily": "sans-serif",
"symbolHeight": 10,
"textAlign": "end",
"color": "#002AFF"
}
}
}
}
},
lids-map-layer-wfs
Vector
A WFS (Web Feature Service) layer loads and displays vector features from a WFS server. It supports querying, filtering, and editing of geospatial features, making it suitable for interactive maps that require access to up-to-date vector data from remote services.
lids-map-layer-wms
Raster
A WMS (Web Map Service) layer displays raster map images served from a remote WMS server. It is commonly used to integrate base maps, aerial imagery, or other geospatial data published by third-party providers.
{
"title": "OSM Overlay WMS - by terrestris",
"id": "osm-overlay",
"type": "lids-map-layer-wms",
"singleTile": true,
"url": "https://ows.terrestris.de/osm/service?",
"wmsParams": {
"LAYERS": "OSM-Overlay-WMS"
}
},
lids-map-layer-wms-geojson
Vector
A WMS GeoJSON layer combines the capabilities of WMS with GeoJSON vector data. It allows you to retrieve and display vector features from a WMS service as GeoJSON, enabling advanced styling and interactivity while leveraging standard WMS protocols.
{
"title": "{tr:map.layerParcels}",
"type": "lids-map-layer-wms-geojson",
"visible": false,
"optional": true,
"gatewayEntity": "wms",
"gatewayEntityGroup": "samo-layers-wms",
"properties": {
"wmsParams": {
"LAYERS": "setdefinition_2011050212745",
"VERSION": "1.1.1"
}
}
},
lids-map-layer-wms-getcapabilities
Raster
A WMS GetCapabilities layer automatically fetches the GetCapabilities document from a WMS service and creates individual WMS layers for each available layer. This simplifies integration with WMS servers by auto-discovering all published layers.
lids-map-layer-wmts
Raster
A WMTS (Web Map Tile Service) layer displays tiled raster data from a WMTS server. It is optimized for fast map rendering by serving pre-generated image tiles at multiple zoom levels, making it ideal for background maps, satellite imagery, or other large raster datasets.
{
"title": "nginx wmts",
"type": "lids-map-layer-wmts",
"optional": true,
"properties": {
"opacity": 0.5,
"url": "https://demo-dev.ivp-samo-as1.assecosk.local/myMap/secwss/service/UPCLKWMTS/httpauth",
"external": {
"url": "https://leitungskataster.upc.ch/secwss/service/UPCLKWMTS/httpauth",
"username":"lien086290r1",
"password":"eanc_EMF_RY7"
},
"autoConfiguration":true
//"wmtsSetting": "158310984091640288"
}
},