Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:schnittstelle:droniq [2025/10/14 09:33] – patrick
+++ server:schnittstelle:droniq [2025/10/14 11:08] (aktuell) – patrick
@@ Zeile 1: / Zeile 1: @@
 ==== Schnittstelle "Droniq" ====
-Über die Schnittstelle zu Droniq können Positionsmeldungen von Drohnen sowie ein Layer "Luftlagebild" in edp: übernommen und eingespielt werden.
+{{:server:schnittstelle:droniq_luftlagebild.png?1000|}}
+Über die Schnittstelle zu Droniq können Positionsmeldungen von Drohnen und anderen Luftfahrzeugen sowie ein Layer "Luftlagebild" in EDP übernommen und eingespielt werden. Die Schnittstelle verbindet sich mit dem VISX-Service von Droniq und empfängt Echtzeit-Positionsdaten über eine WebSocket-Verbindung.
 ^ Funktion ^ Daten senden ^ Daten empfangen |
-| Positionsmeldungen| | ✔|
+| Positionsmeldungen | | ✔ |
-| Luftlagebild| | ✔|
+| Luftlagebild | | ✔ |
 ✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
+=== Voraussetzungen ===
+  * Gültiger API-Token von Droniq (VISX-Service)
+  * Internetverbindung zum Droniq-Server (visx.droniq.io, Port 443)
+  * In EDPmap muss eine Heimatposition definiert sein
+  * Wenn eigene Drohne getracked werden soll: Transponder von Droniq
 === Konfiguration ===
-{{:server:schnittstelle:droniq_konfig.png?400|}}
+{{:server:schnittstelle:droniq_konfig.png?300|}}
+== Grundkonfiguration ==
+^ Parameter ^ Beschreibung ^ Standardwert ^
+| **API-Token** | Der API-Token für den Zugriff auf den VISX-Service von Droniq. Dieser Token muss bei Droniq beauftragt werden. | (leer) |
+| **Radius um Heimatposition** | Der Radius in Kilometern um die in EDPmap definierte Heimatposition, für den Luftfahrzeugdaten abgefragt werden. | 10 km |
+| ::: | **Maximum:** 50 km (wird automatisch begrenzt) | ::: |
+| ::: | **Minimum:** 1 km | ::: |
+== Höhenfilter ==
+Mit dem Höhenfilter können eingehende Positionsmeldungen nach Flughöhe gefiltert werden. Dies ist nützlich, um z.B. nur niedrig fliegende Luftfahrzeuge anzuzeigen.
+^ Parameter ^ Beschreibung ^ Standardwert ^
+| **auf Flughöhe filtern** | Aktiviert oder deaktiviert die Filterung nach Flughöhe | deaktiviert |
+| **max Flughöhe (in ft)** | Maximale Flughöhe in Fuß. Luftfahrzeuge über dieser Höhe werden ignoriert. | 3500 ft |
+| **min Flughöhe (in ft)** | Minimale Flughöhe in Fuß. Luftfahrzeuge unter dieser Höhe werden ignoriert. | 0 ft |
+**Wenn der Höhenfilter deaktiviert ist, werden alle Luftfahrzeuge unabhängig von ihrer Flughöhe angezeigt.**
+=== Luftlagebild ===
+Die Schnittstelle erstellt automatisch einen Layer "Luftlagebild" in EDPmap, auf dem alle empfangenen Luftfahrzeuge dargestellt werden. Die Positionsmeldungen werden in Echtzeit aktualisiert.
+== Angezeigt werden: ==
+  * **Drohnen (UAV)** - Darstellung mit Drohnen-Symbol
+  * **Hubschrauber (ROTORCRAFT)** - Darstellung mit Drehflügler-Symbol
+  * **Flugzeuge** - Darstellung mit Flächenflügler-Symbol
+    * Kleine Flugzeuge (L1P_SMALL, L1P_MEDIUM)
+    * Mittlere Flugzeuge (L2J_MEDIUM)
+    * Große Flugzeuge (L4P_LARGE, L2J_LARGE, L4J_LARGE)
+  * **Segelflugzeuge (GLIDER)**
+  * **Ballons (BALLOON)**
+  * **Fallschirme (PARACHUTE)**
+  * **Ultraleichtflugzeuge** (AIRSHIP, HANGGLIDER)
+== Angezeigte Informationen: ==
+Für jedes Luftfahrzeug werden folgende Informationen angezeigt:
+  * **Position** (Latitude/Longitude)
+  * **Kennung** (Callsign oder ICAO Mode-S Adresse, falls verfügbar)
+  * **Flughöhe** (in Fuß)
+  * **Flugzeugkategorie**
+  * **Zeitstempel** der letzten Positionsmeldung
+**Positionsmeldungen, die älter als 3 Minuten sind, werden automatisch aus dem Luftlagebild entfernt.**
+=== Zuordnung von Einsatzmitteln ===
+Die Schnittstelle kann Positionsdaten bestimmter Luftfahrzeuge direkt den Einsatzmitteln in EDP zuordnen. Dies ermöglicht die automatische Aktualisierung der Position von eigenen Drohnen oder hinterlegten Hubschraubern in edp:. **Eigene Drohnen können über einen Transponder von Droniq geortet werden, weitere Informationen finden Sie dazu bei Droniq: [[https://droniq.de/produkte/verkehrsmanagement/transponder-antikollision/|Droniq Transponder]]**
+== Konfiguration der Zuordnung ==
+Im Textfeld "Zuordnung von EM" können Luftfahrzeug-Kennungen den Rufnamen von Einsatzmitteln zugeordnet werden.
+**Format:**
+Kennung=Rufname
+**Beispiele:**
+  * CHX17=Chr. 17
+  * D-HEMS=RTH Christoph 1
+  * DRONE123=Drohne 1
+  * Die **Kennung** entspricht dem Callsign (fid) oder der ICAO Mode-S Adresse (icx) des Luftfahrzeugs aus den Droniq-Daten
+  * Der **Rufname** muss exakt mit dem Rufnamen des Einsatzmittels in der EDP-Datenbank übereinstimmen
+=== Funktionsweise ===
+  - Die Schnittstelle verbindet sich beim Start mit dem EDP-Server
+  - Es wird automatisch ein Layer "Luftlagebild" in EDPmap angelegt (falls nicht vorhanden)
+  - Die WebSocket-Verbindung zum Droniq-Server (visx.droniq.io) wird aufgebaut
+  - Als Mittelpunkt wird die in EDPmap definierte HOME-Position verwendet
+  - Die Schnittstelle authentifiziert sich mit dem konfigurierten API-Token
+  - Eingehende Positionsmeldungen werden empfangen und verarbeitet
+  - Gefilterte Daten werden im Luftlagebild-Layer angezeigt
+  - Alle 3 Minuten werden veraltete Positionsmeldungen automatisch entfernt
+=== Fehlerbehebung ===
+== Keine Verbindung zum Droniq-Server ==
+  * Prüfen Sie die Internetverbindung
+  * Stellen Sie sicher, dass Port 443 (HTTPS) nicht blockiert ist
+  * Überprüfen Sie den API-Token
+== Keine HOME-Position definiert ==
+  * Öffnen Sie EDPmap
+  * Definieren Sie eine HOME-Position (Heimatposition) in den Karteneinstellungen
+== Luftfahrzeuge werden nicht angezeigt ==
+  * Prüfen Sie, ob der konfigurierte Radius ausreichend groß ist
+  * Überprüfen Sie die Höhenfilter-Einstellungen
+  * Stellen Sie sicher, dass in Ihrem Umkreis tatsächlich Luftfahrzeuge unterwegs sind
+== Einsatzmittel-Position wird nicht aktualisiert ==
-=== Positionen eigener Drohnen ===
+  * Prüfen Sie die Schreibweise der Kennung und des Rufnamens
+  * Stellen Sie sicher, dass das Einsatzmittel in EDP existiert
+  * Überprüfen Sie das Log auf Meldungen wie "Prüfe: <Kennung>" und "Rufname: <Rufname>"
+  * Die Kennung muss exakt dem Callsign oder der ICAO-Adresse des Luftfahrzeugs entsprechen
+=== Weiterführende Links ===
+  * [[https://www.droniq.de/|Droniq Website]]