==== Schnittstelle "Droniq" ====

{{: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 | | ✔ |
| 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?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 ==

  * 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]]