4.4 GIS-Kartenansicht — Geodaten auf der Karte visualisieren

4.4 GIS-Kartenansicht — Geodaten auf der Karte visualisieren

Zeigen Sie Datensätze mit Geokoordinaten auf einer interaktiven Karte an — mit konfigurierbaren Layern, Styling, Clustering, Tooltips, Popup-Aktionen und Trail-Visualisierung.

1

Überblick

Die GIS-Kartenansicht zeigt Datensätze mit Geokoordinaten auf einer interaktiven Karte. Layer können individuell gestylt, gefiltert und interaktiv angezeigt werden. Die Kartenansicht basiert auf einem GIS-Ansichtselement, dem ein oder mehrere Daten-Layer zugewiesen werden.

  • Punkte, Linien und Flächen auf der Karte darstellen
  • Farbe, Icon, Größe und Transparenz pro Layer oder datengetrieben pro Datensatz steuern
  • Clustering aktivieren, um viele Punkte bei niedrigen Zoomstufen zusammenzufassen
  • Hover-Tooltips für schnelle Vorschau und Klick-Popups für Detail-Ansicht mit Aktionen
  • Trail-Visualisierung für historische Positionsdaten mit Farbverlauf
  • Stil-Presets für schnelle Konfiguration vorgefertigter Darstellungen
Unser Beispiel für diese Anleitung
Kundenstandorte auf der Karte anzeigen

Sie möchten Ihre Kunden-Datensätze auf einer Karte visualisieren. Jeder Kunde hat Adresskoordinaten (Longitude/Latitude). Die Marker sollen farblich nach Branche unterschieden werden, beim Hovern soll ein Tooltip mit Name und Adresse erscheinen, und beim Klick soll ein Detail-Popup mit der Möglichkeit erscheinen, den Kunden-Dialog zu öffnen.

2

Schritt-für-Schritt-Anleitung

  1. GIS-Ansichtselement anlegen

    Navigieren Sie im Admin-Client zu Ansichtselemente und legen Sie ein neues Ansichtselement vom Typ „GIS-Karte“ an. Vergeben Sie einen sprechenden Namen, z. B. „Kundenstandorte Karte“.

  2. Datenquelle mit Koordinaten zuweisen

    Wechseln Sie in die Registerkarte „Daten-Layer“. Der Hauptlayer ist bereits angelegt — er kann nicht gelöscht werden, da jede GIS-Karte einen Hauptlayer benötigt. Weitere Layer (Sublayer) fügen Sie über die Aktion „Neu“ hinzu.

    Die Konfiguration ist in zuklappbare Blöcke gegliedert:

    • Allgemein — Bezeichnung, Reihenfolge, Aktiv, Edge-Labels
    • Zoom & Rendering — Auto-Zoom, Referenz-Zoom, Zeichenrand, Auto-Refresh
    • Datenquelle — UDM-Datenquelle und Ansichtselement (oder „WFS-Datenquelle“ für externe Quellen)
    • Projektion — Source/Dest SRID + Proj4-Strings (nur bei Bedarf)
    • Feature-Felder — Feature-Titel + Koordinaten-Felder:
      • Longitude-Feld / Latitude-Feld — bei Punktdaten
      • WKT-Feld — alternativ für komplexe Geometrien (Linien, Polygone)

    Klicken Sie nach Änderungen auf Speichern — die Selektion (aktiver Layer + aktiver Stil) bleibt erhalten, der Fokus springt nicht zurück zum Hauptlayer.

  3. Layer-Stil konfigurieren

    In der Sidebar des Layer-Bereichs finden Sie die Stil-Karten. Fügen Sie einen neuen Stil hinzu. Die Detail-Maske jedes Stils ist in zuklappbare Blöcke gegliedert (z. B. beim Text-Stil: Stil-Vorlage, Text-Einstellungen, Schrift, Halo, Banner, Dynamische Attribute).

    Sie können aus vorgefertigten Stil-Presets wählen oder den Stil manuell konfigurieren:

    • Füllfarbe und Transparenz
    • Rahmenfarbe und Rahmenstärke
    • Größe — Symbolgröße in Pixeln
    • Zoom-Scaling — Größenänderung je nach Zoomstufe

    Datengetriebene Stile: Über dynamische Attribute können Sie Farbe, Größe und weitere Eigenschaften pro Datensatz aus einer Spalte oder Lookup-Tabelle ableiten.

  4. Hover-Tooltip einrichten

    Wählen Sie in der Sidebar den Bereich „Tooltip / Popup“. Im Abschnitt „Hover-Tooltip“ konfigurieren Sie die kompakte Vorschau, die beim Überfahren eines Features mit der Maus erscheint:

    • Modus: „FieldList“ (automatische Feldliste) oder „Template“ (eigenes HTML)
    • Titel-Feldname: Welches Feld als Überschrift angezeigt wird
    • Auto-Ausblenden: Nach wie vielen Sekunden der Tooltip verschwindet (0 = dauerhaft)
    • Header-Farbe: Eigene Farbe für den Tooltip-Kopfbereich
    • Vorlagen: Wählen Sie aus vorgefertigten Snippets (z. B. „Card mit Header“)
  5. Klick-Popup mit Aktionen einrichten

    Im Abschnitt „Klick-Popup“ konfigurieren Sie die Detail-Ansicht, die beim Klicken auf ein Feature erscheint. Der Klick-Popup bietet zusätzlich Aktions-Buttons:

    • Aktivieren Sie den Klick-Popup und konfigurieren Sie Modus und Felder wie beim Hover-Tooltip
    • Im Bereich „Popup-Aktionen“ legen Sie Buttons an (z. B. „Kunden-Dialog öffnen“)
    • Pro Aktion erscheint ein Element-Mapping-Control — klicken Sie auf „...“, um den Ziel-Dialog zu wählen und Filter-Code zu hinterlegen
  6. Clustering aktivieren

    Wählen Sie in der Sidebar den Bereich „Clustering“. Aktivieren Sie das Clustering, damit bei niedrigen Zoomstufen eng beieinanderliegende Punkte zu einem Cluster zusammengefasst werden.

UserClient → Kartenansicht: Layer-Toolbar mit aktiven Ebenen
+ Layer hinzufügen Straßen ÖPNV-Linien Anlagen Störungen Karte durchsuchen…
● Halt Mühlburger Tor ⚠ Störung Linie 2 Cluster (12)
3

Trail-Visualisierung (historische Daten)

Die Trail-Funktion zeigt den Bewegungsverlauf eines Features auf der Karte an. Historische Positionsdaten werden als farblich abgestufte Punkte mit optionaler Verbindungslinie dargestellt — von blass (alt) bis kräftig (aktuell).

  1. Trail-Datenquelle vorbereiten

    Erstellen Sie eine Datenquelle, die historische Positionsdaten enthält (z. B. GPS-Logs mit Geräte-ID, Breitengrad, Längengrad und Zeitstempel).

  2. Trail konfigurieren

    Wählen Sie in der Sidebar den Bereich „Trail“ und aktivieren Sie die Funktion. Konfigurieren Sie:

    • Trail-Datenquelle: Die Datenquelle mit den historischen Daten
    • Quell-Feld (Haupt-Layer): Das Feld, das Haupt-Feature und Trail-Daten verknüpft (z. B. „GeräteId“)
    • Filter-Feld (Trail-DS): Das entsprechende Feld in der Trail-Datenquelle
    • Breitengrad/Längengrad-Feld: Koordinatenfelder der Trail-Datenquelle
    • Sortierung: Nach Zeitstempel oder Reihenfolge-Nummer
  3. Darstellung anpassen

    Wählen Sie Start- und Endfarbe für den Farbverlauf, Punktgröße und ob eine Verbindungslinie gezeichnet werden soll.

  4. Trail auf der Karte aktivieren

    In der Kartenansicht erscheint ein Trail-Button (Routen-Symbol) links oben neben dem Ebenen-Panel. Klicken Sie auf ein Feature und dann auf den Trail-Button oder den „Trail“-Button im Klick-Popup, um den Verlauf anzuzeigen.

Tipp: Trail-Performance Begrenzen Sie die Anzahl der Trail-Punkte über das Feld „Max. Punkte“ (Standard: 50). Bei sehr vielen historischen Datensätzen kann die Darstellung sonst langsam werden.
4

Layer-Stil-Optionen im Überblick

Option Beschreibung Dynamisch möglich?
Marker-Icon / Symboltyp Auswahl des Symboltyps (Kreis, Quadrat, Dreieck etc.) Nein (statisch pro Layer)
Füllfarbe Grundfarbe des Markers oder der Fläche Ja — per Spalte oder Lookup
Größe Symbolgröße in Pixeln; skaliert optional mit Zoomstufe Ja — per Spalte oder Lookup
Rahmenfarbe / Rahmenstärke Umrandung des Symbols oder der Fläche Ja — per Spalte oder Lookup
Transparenz (Opacity) Durchsichtigkeit von Füllung und Rahmen (0 = unsichtbar, 1 = voll sichtbar) Ja — per Spalte oder Lookup
Zoom-Scaling Unterschiedliche Größen/Stile je nach Zoomstufe Konfiguration pro Stufe
Clustering Punkte bei niedriger Zoomstufe zusammenfassen Ein/Aus pro Layer
Text-Label Beschriftung auf der Karte (z. B. Name des Standorts) Ja — Schriftfarbe, Größe, Halo
5

Dynamische Stile (datengetrieben)

Dynamische Attribute ermöglichen es, Stil-Eigenschaften pro Datensatz aus den Daten abzuleiten. Es gibt zwei Auflösungsquellen:

Quelle Beschreibung
Spalte (Column) Der Wert wird direkt aus einer Spalte der Datenquelle gelesen (z. B. eine Hex-Farbe #FF5733 in der Spalte „MarkerFarbe“).
Lookup Der Spaltenwert wird über eine Zuordnungstabelle aufgelöst (z. B. Branche „IT“ → Farbe #2563eb).
6

Layer-Navigation in der Sidebar

Wenn ein Layer ausgewählt ist, zeigt die Sidebar folgende Bereiche an:

Bereich Funktion
Ebene Allgemeine Layer-Einstellungen: Name, Datenquelle, Koordinatenfelder, Projektion, Reihenfolge, Daten-Filter
Clustering Clustering-Einstellungen: Aktivierung, Max-Zoomstufe, Darstellung der Cluster-Marker
Tooltip / Popup Getrennte Konfiguration für Hover-Tooltip (kompakte Vorschau) und Klick-Popup (Detail-Ansicht mit Aktionen)
Highlight Hervorhebungs-Stil bei Positionsänderung (z. B. pulsierender Marker bei Auto-Refresh)
Trail Trail-Konfiguration: Historische Datenquelle, Feld-Mapping, Farbverlauf, Verbindungslinie
Stil-Karten Punkt-, Linien-, Flächen- und Text-Stile mit Presets und dynamischen Attributen
AdminClient → Layer-Sidebar: aktiver Layer mit Stil-Konfiguration
📍
Layer „Haltestellen“
Punkt-Layer · aktiv
Datenquelle
DS_Haltestellen
Stil-Karte
Symbol nach Verkehrsmittel
Clustering
aktiv (ab Zoom < 14)
Klick-Popup
Standard + Aktion „Detail öffnen“
7

Popup-Aktionen (Klick-Popup)

Im Klick-Popup können Sie Aktions-Buttons definieren, die beim Klick auf ein Feature angezeigt werden. Jede Aktion ist mit einem Element-Mapping verknüpft, das bestimmt, welcher Dialog geöffnet wird und wie die Daten übergeben werden.

  1. Aktion anlegen

    Im Bereich „Popup-Aktionen“ des Klick-Popups klicken Sie auf „Neu“. Vergeben Sie ein Label (z. B. „Details anzeigen“) und optional ein Icon (z. B. fa-solid fa-eye).

  2. Ziel-Dialog zuweisen

    Unter der Aktions-Tabelle erscheint pro Aktion ein Element-Mapping-Control. Klicken Sie auf das „...“-Symbol, um den Ziel-Dialog auszuwählen und das Mapping zu konfigurieren (Popup/Seite, Filter-Code).

  3. Ergebnis

    Auf der Karte zeigt der Klick-Popup nun den Button an. Beim Klick wird der konfigurierte Dialog geöffnet — mit den Daten des angeklickten Features.

8

Daten-Filter pro Layer

Jeder Layer kann einen eigenen Daten-Filter besitzen, der bestimmt, welche Datensätze auf der Karte angezeigt werden. So können Sie mehrere Layer auf derselben Datenquelle anlegen und jeden Layer auf einen anderen Ausschnitt der Daten filtern.

Beispiel
Drei Layer für drei Status-Gruppen

Sie möchten Fahrzeuge nach Status farblich trennen: Grüne Marker für „Aktiv“, gelbe für „Wartung“ und rote für „Defekt“. Legen Sie drei Layer mit derselben Datenquelle an. Auf jedem Layer setzen Sie einen Filter (z. B. Status = Aktiv) und weisen einen passenden Punkt-Stil zu.

  1. Layer anlegen

    Erstellen Sie einen neuen Layer und wählen Sie die gewünschte Datenquelle.

  2. Filter setzen

    Im Bereich „Ebene“ finden Sie unterhalb der Koordinatenfelder den Abschnitt „Daten-Filter“. Hier steht Ihnen der bekannte FilterControl zur Verfügung. Definieren Sie Ihre Filterbedingungen (z. B. Status = Aktiv).

  3. Stil zuweisen

    Fügen Sie dem Layer einen eigenen Punkt-Stil hinzu (z. B. grün für „Aktiv“). Wiederholen Sie die Schritte für die weiteren Status-Gruppen.

Tipp: Layer ein-/ausblenden Auf der Karte können Benutzer einzelne Layer über das Ebenen-Panel (Layer-Symbol oben links) ein- und ausblenden. So lässt sich z. B. gezielt nur der „Defekt“-Layer anzeigen.
Tipp: Koordinatenformate UDM unterstützt Koordinaten als Longitude/Latitude (Dezimalgrad, z. B. 11.5820 / 48.1351) oder als WKT (Well-Known Text, z. B. POINT(11.5820 48.1351)). WKT wird für Linien und Polygone benötigt. Achten Sie auf die korrekte Reihenfolge: WKT verwendet Longitude vor Latitude.
Hover-Tooltip vs. Klick-Popup Beide können unabhängig voneinander aktiviert werden. Der Hover-Tooltip zeigt eine kompakte Vorschau beim Überfahren mit der Maus und verschwindet automatisch. Der Klick-Popup zeigt eine ausführliche Ansicht mit optionalen Aktions-Buttons. Auf Touch-Geräten wird der Hover-Tooltip automatisch deaktiviert — dort funktioniert nur der Klick-Popup.
Zoomstufen und Clustering Die Kartenansicht unterstützt Zoomstufen von 1 (Weltübersicht) bis 20 (Straßenebene). Clustering ist besonders nützlich, wenn viele Punkte auf engem Raum liegen — bei niedrigen Zoomstufen werden sie automatisch gruppiert.
Achtung: Projektionseinstellungen Falls Ihre Koordinaten nicht im Standard-Format (WGS 84 / EPSG:4326) vorliegen, müssen Sie die Source SRID und ggf. den Proj4-String im Layer korrekt konfigurieren. Fehlerhafte Projektionseinstellungen führen dazu, dass Punkte an falschen Positionen angezeigt werden.
9

Häufige Fragen

Frage Antwort
Welche Geometrietypen werden unterstützt? Punkte (Longitude/Latitude), Linien und Polygone (jeweils als WKT). Für einfache Standortmarker genügen Longitude und Latitude.
Kann ich mehrere Layer übereinander anzeigen? Ja. Sie können beliebig viele Layer anlegen. Die Reihenfolge wird über das Feld „Reihenfolge“ gesteuert.
Wie färbe ich Marker nach einer Kategorie ein? Legen Sie ein dynamisches Attribut für die Füllfarbe an. Wählen Sie als Quelle „Lookup“ und ordnen Sie jeder Kategorie eine Hex-Farbe zu.
Was ist der Unterschied zwischen Hover-Tooltip und Klick-Popup? Der Hover-Tooltip erscheint automatisch beim Überfahren und verschwindet nach der konfigurierten Zeit. Der Klick-Popup erscheint beim Klicken und bietet zusätzlich Aktions-Buttons (z. B. Dialog öffnen).
Wie zeige ich einen Trail / Verlauf an? Konfigurieren Sie im Bereich „Trail“ eine separate Datenquelle mit historischen Positionsdaten. Auf der Karte aktivieren Sie den Trail über den Trail-Button (Routen-Symbol oben links) oder im Klick-Popup.
Kann ich mehrere Layer auf dieselbe Datenquelle setzen? Ja. Jeder Layer hat einen eigenen Daten-Filter. So können Sie z. B. drei Layer mit derselben Datenquelle anlegen und jeden auf einen anderen Status filtern — mit unterschiedlichen Farben und Symbolen.
Kann ich die Karte automatisch aktualisieren? Ja. Im Layer kann ein Auto-Refresh-Intervall in Sekunden konfiguriert werden. Bei Positionsänderungen wird der Highlight-Stil angezeigt.
Gibt es vorgefertigte Stile? Ja. Beim Erstellen eines neuen Stils können Sie aus Stil-Presets wählen (z. B. „Grüner Pin“, „Roter Alarm-Kreis“). Das Preset wird angewendet und kann anschließend angepasst werden.
Welche Basiskarte wird verwendet? Die Basiskarte wird über WMS/WMTS-Ebenen konfiguriert. Siehe die Anleitungen WMS/WMTS-Kartendienste und den Template-Katalog mit über 40 fertigen Vorlagen.