@vcmap/dynamic-layer

Part of the VC Map Project

The Dynamic Layer plugin can be used to dynamically add layers to a Map, without editing its configuration.

Currently supported sources are:

• Web Data
  • 3D Tiles
  • Cesium PointCloud
  • Cesium Terrain
  • CZML
  • GeoJSON
  • Web Feature Service (WFS)
  • Web Map Service (WMS)
  • Web Map Tile Service (WMTS)
• Catalogues
  • GeoNetwork
  • Idra
  • NBS Registry
  • Piveau

Web Data

Web Data layers added to the Map through this plugin will be shared when a Map share link is created.

Add a new web data source:

A new web data source can be added by clicking the "+" icon. It requires to select the type of the source and to provide the URL of the service. The source will be added to the content tree.

View layer information and add it to the Map:

All layers of the plugin's content tree can be selected to view their information. If a layer includes nested children, all of them can be added at once, or each layer can be added independently.

Once added, the layer appears in the Map content tree, and its attributions are added to those of the Map. If the layer comes with a legend, this is added to the Map legend.

Catalogues

Preset a catalogue to make it accessible to users:

To be accessible, a catalogue must be predefined in the plugin configuration. An URL and one of the supported catalogue types must be specified. Optionally, a title can be supplied to identify the catalogue, as well as a subtitle which is displayed in the catalogue overview, visible when multiple catalogues are predefined. You can also specify a Markdown description, which will be displayed when a catalogue is opened but no dataset is selected (otherwise, the default description is an explanation of the use of a catalogue within the plugin).

Usage of a catalogue:

When opened, a catalogue displays the first datasets, sorted by relevance and unfiltered in the list on the left. Above this, a search bar allows you to search for a dataset by name. The sorting icon lets you choose the display order (relevance, asc./desc. name, creation or modification date). The filter icon lets you apply filters based on those available in the catalogue. Below the list, pagination allows you to move between results pages. The right-hand side of the catalogue shows the catalogue description (when configured, otherwise a default description explains how catalogues work).

When a dataset is selected, its details are displayed instead of the catalogue description. At the bottom of the presentation is a list of its distributions. Each one can be expanded to see its details, and when it is compatible with the VC Map, a button offers to add it to the map. Compatible datasets are those presented in the list of Web Data sources.

Edit the parameters of an added layer:

User-defined settings will not be shared when a Map share link is created.

The 'Added layers' section of the plugin shows all layers added to the Map, sorted by type. Editing parameters (such as its name in the content tree or parameters specific to a layer type) is possible by selecting the layer in this section.

Configuration

| Property | Type | Default | Description | Allowed values | | ----------- | -------- | ------------------------- | --------------------------------------------------- | ----------------------- | | defaultTab | string | 'webdata' | The default tab opened when the plugin is launched. | 'webdata', 'catalogues' | | enabledTabs | Array | ['webdata', 'catalogues'] | The enabled tabs in the plugin. | 'webdata', 'catalogues' | | webdata | object | | The webdata configuration. | See below. | | catalogues | object | | The catalogues configuration. | See below. |

Webdata configuration

| Property | Type | Default | Description | Allowed values | | ----------- | -------- | ---------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | defaultType | string | 'WMSLayer' | The type of webdata source preselected. | 'CesiumTilesetLayer', 'CzmlLayer', 'GeoJSONLayer', 'PointCloudLayer', 'TerrainLayer', 'WFSLayer', 'WMSLayer', 'WMSTLayer' | | defaultUrl | string | '' | The pre-filled URL for adding source webdata. | any |

Catalogues configuration

| Property | Type | Default | Description | Allowed values | | ------------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------- | -------------------------- | | itemsPerPage | number | 14 | The number of datasets to be displayed. 14 is the value used to display the list of datasets without scrolling. | any | | presets | Array | [] | The presets catalogues. | See configuration below. |

Common properties

These properties are common ot the four supported catalogue types.

| Property | Type | Default | Description | Allowed values | | ----------- | -------- | --------------------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------- | | type | string | required | The type of the catalogue. | 'idra', 'geonetwork', 'nbsRegistry', 'piveau' | | url | string | required | The URL of the catalogue. | any | | title | string | Domain name | The title of the catalogue. | any | | logo | string | Catalogue type logo | The logo of the catalogue, as a base64 image. | any | | subtitle | string | Catalogue type | The catalogue subtitle, shown in catalogues overview. | any | | description | string | An explanation of how the catalogs work | The catalogue description. Is rendered as MarkDown when no dataset is selected. | any |

Type-dependant properties

Additionally to the common properties, the following catalogue type dependant properties can be set. Default values are the bold ones

| Property | Catalogue type | Type | Description | Allowed values | | --------------- | ------------------ | ----------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | defaultSorting | Idra | string | The default sorting of datasets | 'nameAsc', 'nameDesc', 'lastCreated', 'lastModified' | | defaultSorting | GeoNetwork | string | The default sorting of datasets | 'relevance', 'rating', 'popularity', 'dateStamp', 'createDate', 'resourceTitleObject.default.sort' (Title ascending) | | defaultSorting | Piveau | string | The default sorting of datasets | 'relevance+desc', 'title.$locale$+asc', 'title.$locale$+desc', 'modified+desc', 'issued+desc' | | aggregationKeys | GeoNetwork | Array<string> | The aggregation kes to be fetched, used for filtering | ['resourceType','inspireTheme','cl_topic','format','organisationNameObject','groupOwner'] | | filter | GeoNetwork, Piveau | Record<string,string> | An object used to prefilter the catalogues entries. Filter defined in the config will not be overridable in the UI. | any |

A config entry could for example look like:

{
  "name": "@vcmap/dynamic-layer",
  "defaultTab": "webdata",
  "enabledTabs": ["webdata", "catalogues"],
  "webdata": {
    "defaultType": "WMSLayer",
    "defaultUrl": "https://sgx.geodatenzentrum.de/wms_topplus_open"
  },
  "catalogues": {
    "presets": [
      {
        "url": "https://data.europa.eu/",
        "type": "piveau",
        "title": "Data Europa",
        "filter": { "filter": "dataset" },
        "subtitle": "The official portal for European data"
      },
      {
        "url": "https://open.bydata.de/",
        "type": "piveau",
        "title": "Offene Daten aus Bayern",
        "description": "# Offene Daten aus Bayern\nHier finden Datenbegeisterte freie Datensätze und Unterstützung, um noch mehr Daten zu teilen. Damit schaffen wir gemeinsam – Verwaltung, Unternehmen, aber auch Wissenschaft und Zivilgesellschaft – Mehrwert für uns alle.\n"
      }
    ]
  }
}