---
title: Karten
description: Kartenquellen, WMS-Dienste, externe Layer und Start-Ausschnitt.
---

Basiskarten und Layer sind Stammdaten und werden unter **Verwaltung → Karten** gepflegt.

- **Kartenquellen**: Raster- oder Vektor-Basiskarten. Je Quelle lässt sich eine Cache-Dauer für
  den Kachel-Proxy des Servers festlegen.
- **WMS-Dienste und externe Layer**: zusätzliche Ebenen über der Basiskarte, mit Deckkraft,
  Reihenfolge und optionaler automatischer Aktualisierung. Zugangsdaten für WMS-Dienste liegen
  verschlüsselt (`SECRETS_KEY`).
- **Start-Ausschnitt** und **User-Agent** der ausgehenden Kartenanfragen. Manche Geodienste
  sperren unbekannte User-Agents.

## Legenden

Jeder externe Layer hat im Bearbeiten-Dialog das Feld **Legende** mit Vorschau:

- **Vom Dienst** (Standard): Bei WMS-Layern das Legendenbild, das der Dienst in seinen
  Capabilities nennt; es wird beim **Layer wählen** übernommen. Nennt der Dienst keines, fragt
  Lagewerk das Bild per `GetLegendGraphic` an. Geodaten zeigen ein Farbfeld in der Layer-Farbe,
  Bild-Overlays nichts.
- **Eigene Adresse**: ein Legendenbild unter einer beliebigen `http(s)`-Adresse, auch für
  Bild-Overlays.
- **Keine Legende**: Der Layer erscheint nicht im Legenden-Kasten.

![Dialog Layer bearbeiten für die Unwetterwarnungen des DWD: Feld Legende auf „Vom Dienst“ mit Vorschau der Warnstufen](/blume-assets/content/inhalt/administration/bilder/karte-layer-legende.png)

## WMS-Dienste abfragen

Lagewerk fragt alle WMS-Dienste regelmäßig ab: erstmals zehn Minuten nach dem Start des Servers,
danach jeweils 24 Stunden nach der letzten Abfrage. Dabei zählt es die abrufbaren Layer und
übernimmt die Legenden der bereitgestellten Layer neu, so kommen geänderte Legenden von selbst an.
Ist ein Dienst nicht erreichbar, versucht es Lagewerk stündlich erneut.

Die Spalte **Layer** der Dienst-Tabelle zeigt, wie viele Layer bereitgestellt sind und wie viele
der Dienst anbietet, zum Beispiel **3 von 207**. Darunter stehen deaktivierte Layer und der
Zeitpunkt der letzten Abfrage. **Dienst abfragen** fragt sofort ab; solange der Dienst antwortet,
dreht sich am Knopf ein Ladezeichen. Auch beim **Layer wählen** sehen Sie oben, wie viele der
angebotenen Layer gewählt sind.

![Tabelle WMS-Dienste mit dem Deutschen Wetterdienst: 3 von 207 Layern, 1 deaktiviert, Zeitpunkt der Abfrage und der Knopf Dienst abfragen mit Ladezeichen](/blume-assets/content/inhalt/administration/bilder/karte-wms-dienste.png) Legenden geschützter Dienste laufen wie die Kacheln
über den Server.

Interne Kartenserver im eigenen Netz müssen über `EGRESS_ALLOWED_NETS` freigegeben werden.

Details: [`docs/spec/karte.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/docs/spec/karte.md).
