Öffentliche Übersicht zu .asmaps-Projektdateien und .asmaps.bak-App-Backups für Austausch, Sicherung und mögliche Integrationen durch Drittanwendungen.
Überblick
ArxSilex MapTools trennt einzelne Projektdateien von vollständigen App-Backups. Für Integrationen ist diese Trennung wichtig: .asmaps beschreibt ein einzelnes Kartenprojekt, während .asmaps.bak ein Wiederherstellungsformat für App-Daten ist.
| Dateityp | Zweck | Typischer Inhalt | Für Drittanbieter |
|---|---|---|---|
| .asmaps | Austausch eines Projekts | Projektobjekte, Geometrien, Metadaten, Kategorien, Darstellung und projektbezogene Einstellungen | Geeignet für Import, Anzeige, Validierung und Weiterverarbeitung einzelner Projekte |
| .asmaps.bak | App-Backup und Wiederherstellung | Ausgewählte App-Bereiche, Manifest, Prüfinformationen und optional geschützte Inhalte | Vorrangig für ArxSilex MapTools; Drittanbieter sollten nur dokumentierte Bereiche lesen |
Struktur
Eine .asmaps-Datei ist als Austauschcontainer für ein Projekt gedacht. Die folgenden Bereiche beschreiben die öffentliche Einordnung. Interne Details können sich ändern und sollten nicht als stabile Schnittstelle vorausgesetzt werden.
| Bereich | Beschreibung | Integrationshinweis |
|---|---|---|
| Manifest | Formatversion, Exporthinweise, App-/Projektbezug und optionale Prüfinformationen | Zuerst Version und Dateityp prüfen; unbekannte Felder tolerieren |
| Projekt | Projektname, Beschreibung, Erstellungs-/Änderungsinformationen und Projekteinstellungen | Nicht von einer festen Feldreihenfolge ausgehen |
| Objekte | Marker, POIs, Routen, Tracks, Flächen, Kreise, Peilungen, Distanzen und weitere Kartenelemente | Objekttyp und Geometrie getrennt auswerten |
| Geometrie | Punkte, Linien, Flächen, Trackpunkte sowie Höhen- und Zeitinformationen, soweit vorhanden | Koordinaten als WGS84 interpretieren; optionale Werte dürfen fehlen |
| Eigenschaften | Namen, Notizen, Farben, Sichtbarkeit, Stil, Kategorien und appbezogene Zusatzdaten | Unbekannte Eigenschaften beim erneuten Schreiben möglichst erhalten |
Backup
.asmaps.bak ist kein einzelnes Projekt, sondern ein App-Backup. Es kann mehrere Datenbereiche enthalten, zum Beispiel Einstellungen, Profile, Import-Stapel, POI-Datenbanken, Gruppen, Offline-Karten, Layer, Terrain-Informationen oder Kartenstile.
Drittanbieter sollten .asmaps.bak daher nicht wie eine einfache Projektdatei öffnen. Sinnvoll ist höchstens ein defensives Lesen eindeutig dokumentierter Bereiche, ohne unbekannte Inhalte zu verändern oder zu löschen.
Kompatibilität
Das Format ist auf Weiterentwicklung ausgelegt. Integrationen sollten daher zuerst Dateityp und Formatversion prüfen, nur bekannte Bereiche auswerten, unbekannte Felder unverändert lassen und optionale Werte als optional behandeln.
Datenschutz
Projektdateien und Backups können Standortdaten, Notizen, Tracks, Suchgebiete, Gruppeninformationen oder Remote-ID-Daten enthalten. Remote-ID-Daten können personenbezogene Daten enthalten, etwa wenn Kennungen oder Standortdaten direkt oder indirekt einer Person zugeordnet werden können.
Drittanwendungen sollten diese Daten lokal, sparsam und transparent verarbeiten. Dauerhafte Speicherung, Export, Veröffentlichung oder Weitergabe an Server sollte nur nach bewusster Nutzerentscheidung erfolgen.
Integration
Für offenen Datenaustausch bleiben GPX, KML/KMZ, GeoJSON und CSV die stabilsten Zielformate. .asmaps ist sinnvoll, wenn ArxSilex-Projektobjekte möglichst vollständig erhalten bleiben sollen. .asmaps.bak sollte dagegen nur mit besonderer Vorsicht automatisiert verarbeitet werden.
