Charger une couche MilX via un paramètre URL dans map.army

Cet article explique comment charger une couche MilX depuis votre serveur web vers le site map.army.

Comment intégrer map.army dans une page web

L’application web map.army peut être intégrée dans une page web avec seulement quelques lignes de code. L’article suivant présente les étapes nécessaires.

Intégration via iFrame

L’intégration de l’application web dans une page web peut se faire via un iFrame. L’exemple de code ci-dessous affiche map.army avec toutes ses fonctions dans un cadre de 800 pixels de large et 600 pixels de haut. La définition des attributs pris en charge dans l’iFrame (height, width, border, …) se trouve ici.

<iframe src="https://www.map.army " width="800" height="600" frameborder="0"></iframe>

Remarque : L’iFrame fonctionne dans un fichier HTML local mais pas sur votre site web ? Dans ce cas, assurez-vous que le serveur web ou le CMS prend en charge les iFrames. Dans la plupart des CMS, il s’agit d’un paramètre à activer.

Charger une couche MilX via un paramètre URL

La dernière version de l’application web permet de charger des superpositions de carte militaire comme paramètre URL. Cela permet d’intégrer des cartes interactives dans une page web ou un blog :

Les étapes suivantes sont nécessaires pour l’intégration :

Couche de démonstration de l'application web

Étape 1 – Enregistrer la ou les superpositions de carte

Créez vos couches dans l’application web map.army. Enregistrez une ou plusieurs superpositions dans un seul fichier MilX (collection de couches).

Étape 2 – Téléverser
Chargez le fichier MilX créé à l’étape 1 sur votre serveur web. Vérifiez que la couche peut être téléchargée en tant que fichier via un navigateur web. Exemple de lien vers une couche : www.gs-soft.com/CMS/files/Layer.milxlyz
Si vous ne pouvez pas télécharger le fichier : vérifiez que le serveur web prend en charge le format de fichier MilX (type MIME) :

Configuration du type MIME du serveur web pour les extensions de fichiers .milxlyz et .milxly

Exemple de définition de type MIME pour *.milxlyz et *.milxly.

Étape 3 - Cross-Origin Resource Sharing (CORS)

Votre serveur web prend-il en charge le CORS ? Ceci est requis pour que les fichiers MilX de votre serveur web puissent être chargés par un navigateur web exécutant l’application sur www.map.army. Le CORS doit donc être activé pour le domaine www.map.army. Selon le serveur web, cela peut être fait comme suit :

Apache : Le fichier *.htaccess (dans le dossier du serveur web contenant le fichier *.milxlyz) doit être complété avec la permission suivante :

En-tête CORS Apache .htaccess autorisant l'accès à map.army
Header add Access-Control-Allow-Origin: https://www.map.army

Remarque : S’il n’y a pas de fichier *.htaccess dans ce dossier, il doit être créé et la permission ci-dessus doit y être intégrée.

IIS : La personnalisation suivante doit être effectuée dans l’interface graphique IIS :

Boîte de dialogue des paramètres CORS IIS pour le dossier des fichiers MilX Paramètres CORS IIS autorisant le domaine map.army

En alternative, la permission suivante peut autoriser le CORS via le fichier web.config (dans le dossier contenant le fichier *.milxlyz) :

Extrait XML de configuration CORS et type MIME dans web.config IIS
<?xml version="1.0" encoding="UTF-8"?>  
  <configuration>  
      <system.webServer>  
          <staticContent>  
              <mimeMap fileExtension=".milxlyz" mimeType="application/octet-stream" />  
          </staticContent>  
          <httpProtocol>  
              <customHeaders>  
                  <add name="Access-Control-Allow-Origin" value=" https://www.map.army" />
                </customHeaders>  
          </httpProtocol>  
      </system.webServer>  
  </configuration>

Étape 4 - Tester

Est-il possible de charger une superposition de carte militaire (couche) directement depuis le serveur web dans www.map.army en utilisant les paramètres URL ? Pour tester, vous pouvez remplacer l’URL de la couche MilX (www.gs-soft.com/CMS/files/Layer.milxlyz) dans l’exemple suivant : https://www.map.army/?layer=www.gs-soft.com/CMS/files/Layer.milxlyz

Étape 5 - Paramètre lecture seule

Selon l’application, les couches chargées via le paramètre URL doivent être modifiables ou non. À cette fin, le paramètre “readonly” est fourni. Il peut être ajouté à l’URL comme le montre l’exemple suivant :

https://www.map.army/?layer=www.gs-soft.com/CMS/files/Layer.milxlyz;readonly

Étape 6 - Ajuster l’iFrame Après avoir complété les étapes 1 à 5, vous pouvez ajouter les paramètres URL à l’iFrame de votre page web. Voici un exemple de code que vous pouvez copier :

Exemple 1 :

<iframe src="https://www.map.army/?layer=www.gs-soft.com/CMS/files/Layer.milxlyz;readonly"  
width="800" height="600" frameborder="0" style="border:0"></iframe>

Exemple 2 :

<iframe src="https://www.map.army/?layer=www.gs-soft.com/CMS/files/Demo-Layers.milxlyz;readonly"   
width="100%" height="98%" frameborder="0"></iframe>

Pour toute question supplémentaire, nous sommes heureux de vous aider dans notre Google Group.