# Radar-Handbuch

> Für Nutzerinnen und Nutzer. Technischer Hintergrund:
> [radar-map-architecture.md](radar-map-architecture.md),
> [radar-source-evaluation.md](radar-source-evaluation.md),
> [radar-nowcasting.md](radar-nowcasting.md).

## Datenquelle

Das Radar zeigt das Niederschlagsradar-Komposit des Deutschen Wetterdiensts (DWD) — dieselbe
Analyse-/Kurzvorhersage-Grundlage, die der DWD auch öffentlich anbietet. Seit v1.9.11 stellt dieser
Server dafür fertig zusammengesetzte, standortbezogene Bilder bereit (`/api/v1/mobile/radar/image`)
statt vieler einzelner Kartenkacheln — schneller und flüssiger, ohne die DWD-Farbwerte zu
verändern (Details: [radar-map-architecture.md](radar-map-architecture.md)).

## Aktualisierung

Neue Frames werden alle wenige Minuten abgerufen (Standard: alle 5 Minuten geprüft). Der Zeitstempel
über der Karte zeigt, wie alt der aktuell angezeigte Frame ist.

## Radarfilm: vorgeladen und flüssig (v1.9.11)

Beim Öffnen des Radar-Reiters lädt die App den aktuellen Messframe sowie benachbarte Frames im
Voraus. Solange noch nicht genug Frames bereitstehen, zeigt ein Hinweis den Fortschritt
(„Radarfilm wird vorbereitet: 8 von 36 Bildern"). Einmal geladene Frames bleiben für die restliche
Sitzung im Speicher — ein zweiter Durchlauf derselben Zeitleiste lädt nichts erneut nach. Die
Animation wechselt ausschließlich auf bereits vollständig geladene Frames, es gibt kein sichtbares
Nachladen während der Wiedergabe.

- **Tempo**: „Langsam" / „Normal" / „Schnell" über die Auswahl oberhalb der Karte.
- **Schleife**: an-/abschaltbar; ohne Schleife hält die Animation am letzten Frame an.
- Am Übergang von der letzten Messung zur ersten Prognose sowie auf dem letzten Frame bleibt das
  Bild jeweils kurz etwas länger stehen — bewusst, damit dieser wichtige Übergang nicht übersehen
  wird.
- Wird der Radar-Reiter verlassen oder die App-Registerkarte gewechselt, pausiert die Animation
  automatisch. Bereits geladene Frames bleiben erhalten — bei Rückkehr ist kein erneuter Aufbau
  nötig.
- Wer „Bewegung reduzieren" im Betriebssystem aktiviert hat, bekommt die Animation nicht automatisch
  gestartet; ein bewusster Klick auf ▶ funktioniert trotzdem.

## Zeitachse

- **Messframes** (links der Marke „Jetzt"): bereits erfasste Radardaten ("Messung").
- **Vorhersageframes** (rechts der Marke „Jetzt"): kurzfristige, vom DWD selbst berechnete
  Fortschreibung ("Vorhersage", reicht ca. 2 Stunden voraus) — **keine eigene Berechnung** dieses
  Projekts. Die farbige Spur über dem Zeitregler sowie die Beschriftungen „◀ Messung" / „Prognose ▶"
  zeigen die Grenze deutlich.
- Zeitregler, „vorheriger/nächster Frame", „Jetzt"-Schaltfläche (springt zum aktuellen Messframe)
  und Abspielen (▶) erlauben das Durchblättern.

## Kartensteuerung

- **Ausschnitt**: „Nahbereich", „Region" (Braunschweig–Wolfsburg–Helmstedt, Standardansicht) oder
  „Norddeutschland" über die Auswahl oberhalb der Karte.
- Karte verschieben: ziehen. Zoomen: Scrollrad/Pinch-Geste oder die +/− Symbole der Karte.
- **Zoomgrenze (v1.9.12):** jeder Ausschnitt hat eine sinnvolle maximale Vergrößerung. Wird sie in
  „Region"/„Norddeutschland" erreicht, wechselt die Karte automatisch zum schärferen „Nahbereich"
  (Standort und gewählte Radarzeit bleiben erhalten). In „Nahbereich" selbst erscheint bei
  weiterem Zoomversuch der Hinweis „Maximale sinnvolle Radarvergrößerung erreicht" - ein
  Kartenausschnitt hat immer eine feste, physikalische Rastergröße (1 km je Zelle); mehr Zoom
  macht das Bild nicht genauer, nur größer dargestellt.
- Standort zurücksetzen: 📍-Schaltfläche zentriert wieder auf den gewählten Ausschnitt.
- Deckkraft: 🌗-Schaltfläche schaltet zwischen schwacher/mittlerer/starker Radar-Deckkraft um —
  praktisch, um die Basiskarte darunter besser zu erkennen.
- Vollbild: ⛶-Schaltfläche.

## Legende

Die Legende (aufklappbar) zeigt die **offizielle DWD-Farbskala** für Niederschlagsintensität —
keine selbst erfundenen Farbwerte.

## Ausfälle

Ist die Radarquelle gerade nicht erreichbar, zeigt die Karte einen Fehlerzustand mit einer
„Neu laden"-Schaltfläche. Ein Radar-Ausfall betrifft **ausschließlich** den Radar-Reiter — alle
anderen Funktionen (Wetterdaten, Warnungen, Push, E-Mail) laufen unverändert weiter.

## Grenzen (bewusst)

- **Keine eigene Gewitterdiagnose aus Radarfarben.** Ein starker Radarreflex bedeutet nicht
  automatisch Gewitter — siehe [how-to-read-weather-data.md](how-to-read-weather-data.md#gewitter).
- **Kein numerisches Regen-Nowcasting.** Eine Minuten-genaue Regenvorhersage aus den Radarbildern
  wird derzeit **nicht** berechnet — das würde ohne die offizielle DWD-Umrechnungstabelle
  (Pixelfarbe → Millimeter) eine falsche Genauigkeit vortäuschen. Dies ist ein **geplanter**,
  noch nicht umgesetzter Folgepunkt (siehe [radar-nowcasting.md](radar-nowcasting.md)).

## Beispiele

- **Regenband westlich des Ortes, verschiedene Frames**: das Band wandert im Zeitregler sichtbar
  näher — ein Hinweis (keine Garantie), dass es den Standort in den nächsten Frames erreichen könnte.
- **Schwacher Radarreflex** (helle Farbe in der Legende): leichter, meist unauffälliger Niederschlag.
- **Starker Reflex** (kräftige Farbe in der Legende): deutlich intensiverer Niederschlag im
  dargestellten Bereich — aber: nicht jeder Reflex erreicht tatsächlich den Boden.
- **„Quelle nicht verfügbar"**: der DWD-Dienst antwortet gerade nicht — siehe „Ausfälle" oben.
- **Veralteter Frame**: der Zeitstempel weicht deutlich von "jetzt" ab — meist ein Hinweis auf eine
  vorübergehende Verzögerung beim DWD, kein Fehler dieser App.