Dynamisch geladene Ebenen - Konfiguration

Das Plugin Dynamisch geladene Ebenen ermöglicht das dynamische Hinzufügen von Ebenen zu einer Karte, ohne die Konfiguration bearbeiten zu müssen. Dieser Leitfaden enthält detaillierte Informationen zu den verfügbaren Konfigurationsoptionen für dynamische Webdatenquellen und Katalog-Integrationen.

Die Plugin-Konfiguration besteht aus mehreren Hauptabschnitten, die die verfügbaren Tabs, Standardeinstellungen und vordefinierte Konfigurationen steuern:

Allgemeine Einstellungen

Table 1. Primäre Konfigurationsoptionen
Option	Beschreibung	Standard	Erlaubte Werte
Aktivierte Tabs	Aktivierte Tabs in der Plugin-Oberfläche, werden direkt beim Öffnen des Plugins angezeigt	['webdata', 'catalogues']	webdata, catalogues
Standardregisterkarte	Die Registerkarte, die beim Starten des Plugins standardmäßig geöffnet wird	webdata	webdata, catalogues

Registerkarten Konfiguration

Nur die Registerkarten aktivieren, die für die Zielgruppe relevant sind
Aktivierte Tabs auf die am häufigsten genutzte Funktionalität setzen
Arbeitsabläufe berücksichtigen, um zu entscheiden, welche Registerkarten standardmäßig geöffnet werden soll

Webdaten

Der Abschnitt Webdaten konfiguriert die Standardeinstellungen für das Hinzufügen dynamischer Webdatenquellen zur Karte.

Table 2. Konfigurationsoptionen für Webdaten
Option	Beschreibung	Standard	Erlaubte Werte
Standardtyp	Vorausgewählter Webdatenquellen-Typ	Web Map Service (WMS)	Siehe Unterstützte Webdaten-Typen
Standard-URL	Vorbelegte URL zum Hinzufügen von Webdatenquellen	' '	Jede gültige URL

Webdatenquellen

Bei der Konfiguration von Webdaten-Standards:

Standardtyp auf den im Unternehmen am häufigsten verwendeten Ebenen-Typ setzen
Standard-URL auf einen häufig genutzten Service-Endpunkt verweisen lassen
Die Fähigkeiten der Zielservices bei der Auswahl des Standardtyps berücksichtigen

Unterstützte Webdaten-Typen

Das Plugin unterstützt folgende Webdatenquellen-Typen:

Table 3. Unterstützte Webdaten-Typen
Typ	Beschreibung	Standard-Referenz
Cesium 3D Tiles	3D-Tiles zur Darstellung von 3D-Inhalten	OGC 3D Tiles
Cesium Pointcloud	Cesium-Punktwolken-Daten (3D Tiles)	OGC 3D Tiles
Cesium Terrain	Cesium-Terrain-Kacheln	Cesium Quantized Mesh
CZML	CZML zeitdynamische Daten	CZML Spezifikation
GeoJSON	Vektordaten im GeoJSON-Format	OGC GeoJSON
Web Feature Service (WFS)	Web Feature Service	OGC WFS
Web Map Service (WMS)	Web Map Service	OGC WMS
Web Map Tile Service (WMTS)	Web Map Tile Service	OGC WMTS

Kataloge

Der Abschnitt Kataloge konfiguriert die Integration mit externen Datenkatalogen, die durchsucht und nach Datensätzen gefiltert werden können.

Table 4. Konfigurationsoptionen für Kataloge
Option	Beschreibung	Standard	Erlaubte Werte
Elemente pro Seite	Anzahl der pro Seite angezeigten Datensätze	14	Jede positive Ganzzahl
Voreinstellungen für Kataloge	Vordefinierte Katalog-Konfigurationen	[]	Siehe Katalog-Voreinstellungen

Katalog-Integration

Bei der Konfiguration von Katalog-Presets:

Katalog-URLs auf öffentlich zugängliche API-Endpunkte verweisen lassen, siehe dazu Katalog-Beispiele
Aussagekräftige Titel und Untertitel bereitstellen, um Kataloge zu identifizieren
Beschreibungen nutzen, um den Umfang und Zweck jedes Katalogs zu erläutern
Die Auswirkung des Werts von Items per page auf die Performance beachten – höhere Werte können das Laden verlangsamen

Katalog-Voreinstellungen

Katalog-Voreinstellungen definieren externe Datenkataloge, auf die über die Plugin-Oberfläche zugegriffen werden kann.

Table 5. Katalog-Voreinstellungen
Option	Beschreibung	Erforderlich	Erlaubte Werte
Titel	Anzeigename für den Katalog	Nein	Beliebiger String
URL	URL des Katalogdienstes	Ja	Gültiger Katalog-API-Endpunkt
Typ	Typ des Katalogsystems	Ja	geonetwork, idra, nbsRegistry, piveau
Untertitel	Kurzbeschreibung in der Katalogübersicht	Nein	Beliebiger String
Logo	Base64-codiertes Bild für Katalog-Branding	Nein	Base64-Bild-String
Beschreibung	Detaillierte Beschreibung als Markdown gerendert	Nein	Markdown-formatierter Text

Die aktuelle Implementierung unterstützt nur öffentliche Kataloge. Authentifizierungsmechanismen für geschützte Kataloge werden in dieser Version nicht unterstützt.

Performance-Hinweise

Große Werte für Items per page können die Performance beim Durchsuchen von Katalogen beeinträchtigen
Komplexe Katalogbeschreibungen mit umfangreicher Markdown-Formatierung können die Renderleistung beeinflussen
Die Anzahl der Katalog-Presets berücksichtigen, da für jedes eine initiale Verbindungsprüfung erfolgt

Unterstützte Katalogtypen

Das Plugin unterstützt die Integration mit vier Typen von Datenkatalogsystemen:

Table 6. Unterstützte Kataloge
Typ	Beschreibung	Referenz
Piveau	Katalog kompatibel mit dem European Data Portal	Piveau Platform
GeoNetwork	Open-Source-Metadatenkatalog	GeoNetwork OpenSource
Idra	Open Data Federation Plattform	Idra auf GitHub
NBS Registry	UrBreaths Nature-Based Solutions Kataloge	NBS Registry auf GitHub

Konfigurationsbeispiele

Minimale Konfiguration

Beispiel - Minimale Plugin-Konfiguration

{
  "name": "@vcmap/dynamic-layer",
  "defaultTab": "webdata",
  "enabledTabs": ["webdata"],
  "webdata": {
    "defaultType": "WMSLayer",
    "defaultUrl": ""
  },
  "catalogues": {
    "itemsPerPage": 14,
    "presets": []
  }
}

Erweiterte Konfiguration mit Katalogen

Beispiel - Vollständige Konfiguration

{
  "name": "@vcmap/dynamic-layer",
  "defaultTab": "catalogues",
  "enabledTabs": ["webdata", "catalogues"],
  "webdata": {
    "defaultType": "WMSLayer",
    "defaultUrl": "https://sgx.geodatenzentrum.de/wms_topplus_open"
  },
  "catalogues": {
    "itemsPerPage": 20,
    "presets": [
      {
        "url": "https://data.europa.eu/api/hub/search/",
        "type": "piveau",
        "title": "Data Europa",
        "subtitle": "Das offizielle Portal für europäische Daten",
        "description": "# Europäisches Datenportal\n\nZugriff auf offene Daten von EU-Institutionen und Mitgliedstaaten."
      },
      {
        "url": "https://gdk.gdi-de.org/gdi-de/srv/eng/",
        "type": "geonetwork",
        "title": "Geodaten Katalog",
        "subtitle": "Deutscher Geodatenkatalog",
        "description": "Deutscher Katalog der Geodateninfrastruktur mit Metadaten zu Geodaten und Geodiensten."
      },
      {
        "url": "https://idra.example.com/api/v1/client/",
        "type": "idra",
        "title": "Open Data Federation",
        "subtitle": "Föderierte Open-Data-Plattform",
        "description": "Föderierter Katalog mit Zugriff auf mehrere Datenquellen über eine einheitliche Schnittstelle."
      }
    ]
  }
}

Nur-Webdaten-Konfiguration

Beispiel - Plugin-Konfiguration nur für Webdaten

{
  "name": "@vcmap/dynamic-layer",
  "defaultTab": "webdata",
  "enabledTabs": ["webdata"],
  "webdata": {
    "defaultType": "GeoJSONLayer",
    "defaultUrl": "https://example.com/data/"
  }
}