Référence technique

Format de projet & intégration

Vue publique des fichiers projet .asmaps et sauvegardes .asmaps.bak pour échange, sauvegarde et intégration par des applications tierces.

Aperçu

Deux types de fichiers aux usages différents

ArxSilex MapTools distingue les fichiers de projet individuels des sauvegardes complètes de l’application. Pour une intégration, .asmaps décrit un projet cartographique, tandis que .asmaps.bak est un format de restauration des données de l’application.

TypeUsageContenu typiquePour les tiers
.asmapsÉchange de projetObjets, géométries, métadonnées, catégories, styles et réglages liés au projetAdapté à l’import, l’affichage, la validation et le traitement de projets individuels
.asmaps.bakSauvegarde et restaurationZones de l’application, manifeste, informations de vérification et contenu protégé optionnelSurtout pour ArxSilex MapTools; les tiers ne devraient lire que les zones documentées

Architecture

Structure logique d’un fichier .asmaps

Un fichier .asmaps est conçu comme conteneur d’échange pour un projet. Les zones suivantes décrivent l’interprétation publique. Les détails internes peuvent changer et ne doivent pas être considérés comme une interface stable.

ZoneDétailNote d’intégration
ManifesteVersion du format, indications d’export, contexte app/projet et informations de vérification optionnellesVérifier d’abord version et type de fichier; tolérer les champs inconnus
ProjetNom, description, informations de création/modification et réglages du projetNe pas dépendre d’un ordre fixe des champs
ObjetsMarqueurs, POI, routes, traces, surfaces, cercles, relèvements, distances et autres éléments cartographiquesÉvaluer séparément type d’objet et géométrie
GéométriePoints, lignes, polygones, points de trace et informations altitude/temps si disponiblesInterpréter les coordonnées en WGS84; les valeurs optionnelles peuvent manquer
PropriétésNoms, notes, couleurs, visibilité, style, catégories et données propres à l’applicationConserver les propriétés inconnues lors d’une réécriture

Sauvegarde

Particularités de .asmaps.bak

.asmaps.bak n’est pas un projet unique. C’est une sauvegarde de l’application et peut contenir plusieurs zones de données, par exemple réglages, profils, lots d’import, bases POI, groupes, cartes hors ligne, couches, terrain ou thèmes de rendu.

Les tiers ne devraient donc pas ouvrir .asmaps.bak comme un simple fichier projet. Une lecture défensive des zones clairement documentées est utile; le contenu inconnu ne doit pas être modifié ni supprimé.

Compatibilité

Versionnement et lecture stable

Le format est prévu pour évoluer. Les intégrations doivent vérifier d’abord type et version, lire uniquement les zones connues, laisser les champs inconnus inchangés et traiter les valeurs optionnelles comme optionnelles.

Recommandé

  • Vérifier la version du format ou du schéma
  • Ignorer ou conserver les champs inconnus
  • Vérifier explicitement coordonnées, horodatages et unités
  • Ignorer les objets défectueux au lieu d’arrêter tout l’import
  • Déclencher l’export seulement par action volontaire

À éviter

  • Supposer un ordre fixe des champs
  • Traiter les ID internes comme des ID globaux permanents
  • Ouvrir .asmaps.bak comme un simple projet
  • Supprimer ou écraser des zones inconnues
  • Stocker durablement des données personnelles ou de localisation sans finalité claire

Confidentialité

Traiter la localisation et Remote ID avec prudence

Les projets et sauvegardes peuvent contenir données de localisation, notes, traces, zones de recherche, informations de groupe ou données Remote ID. Les données Remote ID peuvent être personnelles si des identifiants ou positions permettent d’identifier une personne directement ou indirectement.

Les applications tierces devraient traiter ces données localement, avec parcimonie et transparence. Stockage durable, export, publication ou transfert serveur ne devraient avoir lieu qu’après une décision volontaire de l’utilisateur.

Intégration

Règles pratiques pour les tiers

Pour l’échange ouvert, GPX, KML/KMZ, GeoJSON et CSV restent les formats cibles les plus stables. .asmaps est utile pour préserver au mieux les objets ArxSilex. .asmaps.bak ne devrait être automatisé qu’avec une prudence particulière.