MilX-Layer per URL-Parameter in map.army laden

In diesem Artikel erfahren Sie, wie Sie einen MilX-Layer von Ihrem Webserver auf der map.army Webseite laden können.

Wie kann man map.army in eine Webseite einbinden

Die Webanwendung map.army kann mit nur wenigen Zeilen Code in eine Webseite integriert werden. Der folgende Artikel zeigt die notwendigen Schritte.

Einbindung per iFrame

Die Integration der Webanwendung in eine Webseite kann über ein iFrame erfolgen. Der folgende Beispielcode zeigt map.army mit allen Funktionen in einem 800 Pixel breiten und 600 Pixel hohen Rahmen. Die Definition der unterstützten Attribute im iFrame wie Höhe, Breite, Rahmen usw. finden Sie hier.

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

Hinweis: Funktioniert das iFrame in einer lokalen HTML-Datei, aber nicht auf Ihrer Webseite? In diesem Fall ist es wichtig sicherzustellen, dass der Webserver oder das CMS iFrames unterstützt. In den meisten CMS ist dies ein Parameter, der aktiviert werden muss.

MilX-Layer per URL-Parameter laden

Die neueste Version der Webanwendung unterstützt das Laden von militärischen Karten-Overlays als URL-Parameter. Dies ermöglicht die Einbindung interaktiver Karten in eine Webseite oder einen Blog:

Für die Implementierung sind folgende Schritte erforderlich:

Demo layer from the web application

Schritt 1 – Karten-Overlay(s) speichern

Erstellen Sie Ihre Layer in der Webanwendung map.army. Speichern Sie einen oder mehrere Overlays in einer einzigen MilX-Datei (Layer-Sammlung).

Schritt 2 – Hochladen
Laden Sie die in Schritt 1 erstellte MilX-Datei auf Ihren Webserver hoch. Testen Sie, ob der Layer als Datei über einen Webbrowser heruntergeladen werden kann. Beispiel für einen Link zu einem Layer: www.gs-soft.com/CMS/files/Layer.milxlyz
Falls der Download nicht funktioniert: Prüfen Sie, ob der Webserver das MilX-Dateiformat unterstützt (MIME Type):

MIME-Type-Konfiguration für .milxlyz und .milxly im Webserver

Beispiel für die MIME-Type-Definition für *.milxlyz und *.milxly.

Schritt 3 - Cross-Origin Resource Sharing (CORS)

Unterstützt Ihr Webserver CORS? Dies ist erforderlich, damit die MilX-Dateien von Ihrem Webserver durch einen Webbrowser, der die Webanwendung auf www.map.army ausführt, geladen werden können. CORS muss daher für die Domain www.map.army aktiviert sein. Je nach Webserver kann dies wie folgt erfolgen:

Apache: Die Datei *.htaccess (im Ordner auf dem Webserver, der die *.milxlyz-Datei enthält) sollte mit folgender Berechtigung erweitert werden:

Apache .htaccess CORS-Eintrag für map.army
Header add Access-Control-Allow-Origin: https://www.map.army

Hinweis: Falls keine *.htaccess-Datei in diesem Ordner vorhanden ist, muss sie erstellt und die oben genannte Berechtigung eingefügt werden.

IIS: Die folgende Anpassung muss in der IIS-Oberfläche vorgenommen werden:

IIS CORS-Einstellungen für den MilX-Ordner IIS CORS-Einstellung für die Domain map.army

Alternativ kann die folgende Berechtigung CORS über die web.config-Datei (im Ordner mit der *.milxlyz-Datei) erlauben:

IIS web.config XML-Snippet für CORS und MIME-Type
<?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>

Schritt 4 - Test

Ist es möglich, ein militärisches Karten-Overlay (Layer) direkt vom Webserver in www.map.army per URL-Parameter zu laden? Zum Testen können Sie die URL des MilX-Layers (www.gs-soft.com/CMS/files/Layer.milxlyz) im folgenden Beispiel ersetzen:
https://www.map.army/?layer=www.gs-soft.com/CMS/files/Layer.milxlyz

Schritt 5 - Read-Only Parameter

Je nach Anwendung sollen die per URL-Parameter geladenen Layer bearbeitbar sein oder nicht. Dafür gibt es den “readonly”-Parameter. Er kann wie im folgenden Beispiel an die URL angehängt werden:

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

Schritt 6 - iFrame anpassen
Nach Abschluss der Schritte 1 - 5 können Sie die URL-Parameter in das iFrame auf Ihrer Webseite einfügen. Hier ein Beispielcode zum Kopieren:

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

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

Wenn Sie weitere Fragen haben, helfen wir Ihnen gerne in unserer Google Group weiter.