Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:schnittstelle:hochwasserzentralen [2026/03/23 20:31] – admin
+++ server:schnittstelle:hochwasserzentralen [2026/03/25 14:10] (aktuell) – [Einrichtung] stephan
@@ Zeile 1: / Zeile 1: @@
-====== Schnittstelle Hochwasserzentrale ======
+===== Schnittstelle Hochwasserzentrale =====
-Die Schnittstelle Hochwasserzentrale ermöglicht die automatisierte Übernahme aktueller Pegelstände vom zentralen Hochwasserportal in das EDP-System. Da eine direkte Einbindung, beispielsweise über einen Webmapservice, momentan technisch nicht realisierbar ist, wurde diese dedizierte Schnittstellenlösung konzipiert. Die Daten werden dabei als POI-Layer (Points of Interest) integriert und stehen systemübergreifend zur Verfügung.
+Die Schnittstelle Hochwasserzentrale ermöglicht die automatisierte Übernahme aktueller
+Pegelstände vom zentralen Hochwasserportal in das EDP-System. Da eine direkte Einbindung
+über einen Webmapservice momentan technisch nicht realisierbar ist, wurde diese dedizierte
+Schnittstellenlösung konzipiert. Die Daten werden als **dynamischer POI-Layer** integriert
+und stehen systemübergreifend zur Verfügung.
-===== Darstellung in edp: =====
+==== Darstellung in EDP ====
-Innerhalb von edp: können die Pegelinformationen sowohl in der Windows-Version von edp:map als auch in edp:web visualisiert werden. In der Kartenansicht erfolgt die Darstellung über Icons, deren Farbgebung sich dynamisch an der aktuellen Meldestufe des jeweiligen Pegels orientiert. Da die API der Hochwasserzentrale stets die aktuelle Meldestufe bereitstellt, ist die farbliche Indikation direkt an diese Werte gekoppelt. Ergänzend zur kartografischen Darstellung lassen sich die Informationen auch in Form von spezialisierten Kacheln innerhalb der Dashboards einbinden.
+Die Pegelinformationen werden sowohl in der Windows-Version von EDP:map als auch in EDP:web
+visualisiert. Jeder Pegelmesspunkt erscheint als POI-Icon auf der Karte. Die Farbgebung der
+Icons orientiert sich dynamisch an der aktuellen **Meldestufe** des jeweiligen Pegels – da
+die API der Hochwasserzentrale stets die aktuelle Meldestufe bereitstellt, ist die farbliche
+Indikation direkt an diese Werte gekoppelt.
-===== Interaktionsmöglichkeiten und Detailinformationen =====
+Ergänzend zur kartografischen Darstellung lassen sich die Informationen auch in Form von
+spezialisierten **Kacheln innerhalb der Dashboards** einbinden.
-Nutzer haben die Möglichkeit, direkt aus der Kartenansicht auf weiterführende Informationen zuzugreifen. In der Windows-Version von EDP-Map wird durch einen Rechtsklick auf das Pegel-Icon ein hinterlegter Link geöffnet, der direkt zur offiziellen Detailseite des Pegels führt. In der Weboberfläche edp:web kann dieser Link entweder durch einen direkten Klick auf das Icon oder über ein sich öffnendes Modal-Fenster aufgerufen werden. Die Aktualität der Daten wird durch ein konfigurierbares Intervall innerhalb der Schnittstellen-Einstellungen sichergestellt.
+==== Interaktion und Detailinformationen ====
-===== Konfiguration und Datenfilterung =====
+Jeder POI enthält einen direkten Link zur offiziellen Pegelseite des jeweiligen Flusses:
-Die Einrichtung der Schnittstelle erfordert spezifische Parameter, um die Datenlast auf dem Server zu optimieren und nur relevante Informationen zu verarbeiten. In der Konfiguration muss zwingend festgelegt werden, für welche Bundesländer die Pegelstände abgerufen werden sollen. Zusätzlich erfolgt eine geografische Eingrenzung durch die Angabe von Koordinaten, die ein Rechteck definieren. Es werden ausschließlich jene Pegelstände übernommen, die sich innerhalb dieser definierten Zone befinden. Die Kombination aus Bundeslandfilter und geografischem Rechteck ist essenziell für einen performanten Betrieb des Servers.
+  * **EDP:map (Windows):** Rechtsklick auf das Pegel-Icon → Link öffnet die Detailseite
+  * **EDP:web:** Klick auf das Icon oder über ein Modal-Fenster aufrufbar
+Die Aktualität der Daten wird durch das konfigurierbare Synchronisierungsintervall in den
+Schnittstellen-Einstellungen sichergestellt.
+==== Einrichtung ====
+  - In **EDP-Konfiguration → Schnittstellen** eine neue Schnittstelle anlegen
+  - Folgende Grunddaten eintragen:
+    * **Beschreibung:** z. B. ''Hochwasser''
+    * **Schnittstelle:** ''C:\EDP\server\schn_Hochwasserzentrale.exe'' (Standardpfad)
+    * **Aktiv:** Häkchen setzen
+  - Konfigurationsparameter ggf. abändern (siehe unten)
+  - Mit **Speichern** bestätigen
+  - **EDP-Server neustarten**
+{{:server:schnittstelle:hochwasserzentrale_schnittstelle.png?600|}}
+==== Konfiguration ====
+<code>
+[Hochwasserzentrale]
+WriteLagebild=0
+WritePOI=1
+BBoxMinLon=5,8
+BBoxMinLat=47,2
+BBoxMaxLon=15,1
+BBoxMaxLat=55,1
+Bundeslaender=BY&
+TimerIntervalSek=300
+Debug=0
+</code>
+^ Parameter ^ Beschreibung ^
+| ''WritePOI=1'' | POI-Layer anlegen und befüllen (1 = aktiv) |
+| ''BBoxMinLon / BBoxMaxLon'' | Längengrad West/Ost des Erfassungsbereichs |
+| ''BBoxMinLat / BBoxMaxLat'' | Breitengrad Süd/Nord des Erfassungsbereichs |
+| ''Bundeslaender'' | Bundesländer-Filter, Kürzel mit '','' trennen, z. B. ''BY&,BW&'' |
+| ''TimerIntervalSek'' | Synchronisierungsintervall in Sekunden (300 = alle 5 Minuten) |
+| ''Debug=0'' | Debug-Ausgabe (1 = aktiv, nur zur Fehleranalyse) |
+==== Begrenzungsrahmen (Bounding Box) ====
+Die BBox und der Bundesländer-Filter begrenzen gemeinsam den Erfassungsbereich – nur
+Pegelstände innerhalb dieser Zone werden übernommen. Die Kombination beider Filter ist
+essenziell für einen performanten Serverbetrieb.
+Die Standardwerte decken ganz Deutschland ab:
+^ | **Längengrad (Lon/X)** ^ Breitengrad (Lat/Y) ^
+| **Min (SW)** | 5,8 | 47,2 |
+| **Max (NO)** | 15,1 | 55,1 |
+Zur Ermittlung eigener Koordinaten empfiehlt sich z.B. **[[http://bboxfinder.com|bboxfinder.com]]**.
+==== Verhalten des dynamischen Layers ====
+  * Die Schnittstelle legt automatisch einen **dynamischen POI-Layer** an
+  * Synchronisierung erfolgt automatisch im eingestellten Intervall
+  * Wird der Layer über **„Dynamische Layer löschen"** in der POI-Verwaltung entfernt, legt die Schnittstelle ihn bei der nächsten Synchronisierung automatisch neu an.