Caricare un livello MilX tramite parametro URL in map.army

Questo articolo spiega come caricare un livello MilX dal tuo server web nel sito map.army.

Come incorporare map.army in una pagina web

L’applicazione web map.army può essere integrata in una pagina web con poche righe di codice. L’articolo seguente illustra i passaggi necessari.

Integrazione tramite iFrame

L’integrazione dell’applicazione web in una pagina web può essere effettuata tramite un iFrame. Il codice di esempio seguente visualizza map.army con tutte le sue funzioni in un frame largo 800 pixel e alto 600 pixel. La definizione degli attributi supportati nell’iFrame come height, width, border, … si trova qui.

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

Nota: L’iFrame funziona in un file HTML locale ma non sul tuo sito web? In tal caso, è importante assicurarsi che il server web o il CMS supportino gli iFrame. Nella maggior parte dei CMS, questo è un parametro che deve essere abilitato.

Caricare un livello MilX tramite parametro URL

L’ultima versione dell’applicazione web supporta il caricamento di sovrapposizioni di carte militari come parametro URL. Ciò consente l’implementazione di mappe interattive in una pagina web o in un blog:

I seguenti passaggi sono necessari per l’implementazione:

Livello dimostrativo dell'applicazione web

Passaggio 1 – Salvare la/le sovrapposizioni di carta

Crea i tuoi livelli nell’applicazione web map.army. Salva una o più sovrapposizioni in un singolo file MilX (raccolta di livelli).

Passaggio 2 – Caricare
Carica il file MilX creato nel passaggio 1 sul tuo server web. Verifica che il livello possa essere scaricato come file tramite un browser web. Esempio di link a un livello: www.gs-soft.com/CMS/files/Layer.milxlyz
Se non riesci a scaricare il file: verifica che il server web supporti il formato di file MilX (tipo MIME):

Configurazione del tipo MIME del server web per le estensioni di file .milxlyz e .milxly

Esempio di definizione del tipo MIME per *.milxlyz e *.milxly.

Passaggio 3 - Cross-Origin Resource Sharing (CORS)

Il tuo server web supporta il CORS? Questo è necessario affinché i file MilX sul tuo server web possano essere caricati da un browser web che esegue l’applicazione su www.map.army. Il CORS deve quindi essere attivato per il dominio www.map.army. A seconda del server web, è possibile procedere come segue:

Apache: Il file *.htaccess (nella cartella del server web che contiene il file *.milxlyz) deve essere esteso con il seguente permesso:

Intestazione CORS Apache .htaccess che concede l'accesso a map.army
Header add Access-Control-Allow-Origin: https://www.map.army

Nota: Se non c’è un file *.htaccess in questa cartella, deve essere generato e il permesso elencato sopra deve essere integrato.

IIS: La seguente personalizzazione deve essere effettuata nell’interfaccia grafica IIS:

Finestra di dialogo delle impostazioni CORS IIS per la cartella dei file MilX Impostazioni CORS IIS che consentono il dominio map.army

In alternativa, il seguente permesso può consentire il CORS tramite il file web.config (nella cartella contenente il file *.milxlyz):

Frammento XML di configurazione CORS e tipo MIME in 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>

Passaggio 4 - Test

È possibile caricare una sovrapposizione di carta militare (livello) direttamente dal server web in www.map.army usando i parametri URL? Per testarlo, puoi sostituire l’URL del livello MilX (www.gs-soft.com/CMS/files/Layer.milxlyz) nell’esempio seguente: https://www.map.army/?layer=www.gs-soft.com/CMS/files/Layer.milxlyz

Passaggio 5 - Parametro di sola lettura

A seconda dell’applicazione, i livelli caricati tramite il parametro URL possono essere modificabili o meno. A questo scopo è disponibile il parametro “readonly”. Può essere aggiunto all’URL come mostra l’esempio seguente:

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

Passaggio 6 - Adattare l’iFrame Dopo aver completato i passaggi 1-5, puoi aggiungere i parametri URL all’iFrame della tua pagina web. Ecco un esempio di codice che puoi copiare:

Esempio 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>

Esempio 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>

Per ulteriori domande, siamo lieti di aiutarti nel nostro Google Group.