Auf dieser Seite

MilX-Dateiformat — Austauschformat von map.army

map.army verwendet MilX (Military Exchange Format) als natives Dateiformat zum Speichern, Teilen und Importieren militärischer Lagen. Diese Seite ist eine Orientierungsreferenz: Was ist das Format, welche Dateien gehören dazu, und wie erhält man die vollständige Spezifikation.

Was MilX ist

MilX ist ein XML-basiertes Austauschformat, das MIL-STD-2525-Symbolik und taktische Grafiken zwischen Systemen transportiert. Es wird von gs-soft AG zusammen mit dem MSS (Military Symbol Service) gepflegt und ist dasselbe Format, das von Industriepartnern, Führungs- und Informationssystemen sowie militärischen Simulationsanwendungen verwendet wird, die Lagedaten mit map.army austauschen.

Konzeptionell enthält ein MilX-Dokument:

• Layer (1) — benannte, geordnete Container für Symbole und taktische Grafiken.
• Symbole (2) — Platzierungen mit einer MIL-STD-2525-Symbol-ID, Position, Gesinnung, Status und den jeweiligen Modifikatoren.
• Taktische Grafiken (3) — Mehrpunkt-Formen (Linien, Flächen, Reichweitenkreise usw.) mit Geometrie und Modifikatoren.
• Metadaten (4) — Ersteller, Zeitstempel, Koordinatensystem, optionale MilX-Version.

Die Kompatibilität mit MIL-STD-2525C / JC3IEDM ist eine Designvorgabe: Eine MilX-Datei ist von jedem Konsumenten lesbar, der den Standard versteht.

Das bedeutet nicht, dass eine MilX-Datei auf das beschränkt ist, was der reine Standard ausdrücken kann. MilX trägt jedes Symbol als undurchsichtige MSS-Zeichenkette, Modifikatoren eingeschlossen, statt die Symbolik selbst zu modellieren — so bleiben die map.army-Erweiterungen unangetastet erhalten. Die im Arbeitsmodus Erweitert verfügbaren Schweizer Sätze und die Icon-Erweiterungsmodifikatoren überstehen beide ein Speichern und ein Teilen unverändert.

Was die Gegenseite sieht, hängt davon ab, worum es sich handelt:

• Ein auf MSS basierender Konsument, der nur die MIL-STD-2525C-Bibliothek besitzt, zeigt das Ersatzsymbol, das die Bibliothek für dieses erweiterte Symbol definiert — ein festgelegter 2525C-Ersatz, kein leeres Symbol.
• Ein Konsument, der nur die rohe Symbol-ID liest, sieht einen Code, den er nicht erkennt, und behandelt ihn so, wie er jede unbekannte ID behandelt.

Dateiendungen

Beide Endungen tragen die gleichen Nutzdaten; die komprimierte Form ist der Standard für den Austausch, weil typische Lagekarten mit vielen Symbolen sehr gut komprimieren.

Bekannte Einschränkungen

Einige praktische Einschränkungen, die beim Erzeugen oder Bearbeiten von MilX ausserhalb der App relevant sind:

• Symbol-IDs folgen MIL-STD-2525. map.army prüft ihre Länge nicht selbst — kommt eine Datei mit einem fehlerhaften Eintrag zurück, wurde dieser vom Konvertierungsdienst zurückgewiesen oder angepasst; die App meldet, was passiert ist, statt Features stillschweigend zu verwerfen.
• Bild- und Vektor-Layer werden nicht eingebettet. Wenn map.army eine .milxlyz speichert, werden Bild-Layer und Online-Quellen-Vektor-Layer nicht in die Datei serialisiert. Nur MilX-Symbolik wandert mit dem Export. (Siehe Layer importieren für den Sidecar-Mechanismus bei Bildoverlays.)
• Koordinatensystem. Das Standard-Koordinatensystem in MilX-Exporten ist WGS84. Die Option “Erweiterte MilX-Einstellungen” in Optionen → Allgemein erlaubt die Konvertierung in ein anderes Koordinatensystem oder in eine ältere MilX-Version vor dem Download.
• Eine ältere Version anzugeben, schreibt Modifikatoren um. Standardmässig wird nichts ersetzt — der Export verwendet die aktuelle Symbolbibliothek. Aktivieren Sie jedoch die erweiterten Einstellungen und wählen eine ältere Bibliotheksversion, durchläuft der Dienst jede Legacy-Konvertierung, die neuer ist als die gewählte Version, und einige davon ersetzen einen Modifikator durch einen anderen (zum Beispiel wird aus einer Zerstört-Markierung ein Modifikator für den operativen Zustand). Nutzen Sie diese Option nur, wenn das empfangende System die ältere Version wirklich benötigt, und prüfen Sie das Ergebnis; der Standard ist die verlustfreie Wahl.
• SysCustPropList ist nicht für den Austausch gedacht. Das Format enthält einen benutzerdefinierten Eigenschaftsplatz pro Layer und pro Grafik für Partnersysteme, und das Schema legt ausdrücklich fest, dass dieser nur für die interne Nutzung bestimmt ist und beim Datenaustausch mit anderen Partnern nicht verwendet werden sollte. map.army nutzt ihn, um NVG-Dokumentmetadaten auf einem Layer zu vermerken. Bauen Sie keine Integration darauf auf.

Vollständige Spezifikation erhalten

Das vollständige MilX-Schema und die Validierungsregeln werden nicht auf dieser Dokumentationsseite veröffentlicht. Wenn Sie MilX in eigene Software integrieren oder .milxly programmatisch erzeugen möchten (zum Beispiel über ein Skript oder eine LLM-gestützte Tooling-Pipeline), kontaktieren Sie gs-soft AG für die aktuelle Spezifikation:

• Kontaktformular
• mss@gs-soft.com

gs-soft arbeitet mit Industriepartnern an der MilX-Integration im Rahmen einer breiteren MSS-/MilX-Lizenzierung — siehe den FAQ-Eintrag Können MSS und MilX Web Services von anderen genutzt werden? für den Kontext.