How to embed in a web page

The web application can be integrated into a web page with just a few lines of code. The following article shows the necessary steps.


Embed using iFrame

The integration of the web application into a web page can be done via an iFrame. The following sample code displays with all its functions in an 800 pixel wide and 600 pixel high frame. The definition for the attributes supported in the iFrame such as height, width, border, ... can be found here.

<iframe src=" " width="800" height="600" frameborder="0"></iframe>


Hint: Is the iFrame running in a local HTML file, but not on your website? In this case, it is important to ensure that the web server or the CMS support iFrames. In most CMS, this is a parameter that needs to be enabled.


Load MilX-Layer using URL parameter

The latest version of the web application supports to load military map overlays as a ULR parameter. This enables the implementation of an interactive maps into a web page or blog:

 The following steps are required for the implementation:


Step 1 – Save Map Overlay(s)

Create your layers in the web application Save one or multiple overlays into a single MilX file (layer collection). 


Step 2 – Upload

Load the MilX file created in step 1 on your web server. Test whether the layer can be downloaded as a file using a web browser. Example of a link to a layer:
If you are not able to download the file: Check whether the web server supports the MilX file format (MIME Type):

Apache MIME Type Definition
Example of MIME Type definition for *.milxlyz and *.milxly.


Step 3 - Cross-Origin Resource Sharing (CORS)

Is your web server supporting CORS? This is required for the MilX files on your web server to be loaded by a web browser running the web application on CORS therefore must be activated for the domain Depending on the web server this can be done by the following steps:

Apache: The *.htaccess file (in the folder on the web server that contains the *.milxlyz file) should be extended with the following permission:
Apache CORS activation in *.htaccess

Header add Access-Control-Allow-Origin:

Note: If there is no *.htaccess file in this folder, it must be generated and the permission listed above has to be integrated.

IIS: The following customization has to be made in the IIS GUI:
IIS CORS activation - step 1 IIS CORS activation - step 2

As an alternative, the following permission can allow CORS using the web.config file (in the folder containing the *.milxlyz file):
IIS CORS activation via web.config

<?xml version="1.0" encoding="UTF-8"?>  
              <mimeMap fileExtension=".milxlyz" mimeType="application/octet-stream" />  
                  <add name="Access-Control-Allow-Origin" value="" />


Step 4 - Test

Is it possible to load a military map overlay (layer) directly from the web server in using the URL parameters? To test this, you can replace the URL of the MilX layer ( in the following example:


Step 5 - Read-Only Parameter

Depending on the application the layers loaded via the URL parameter should be editable or not. For this purpose, the "readonly" parameter is provided. It can be attached to the URL as the following example demonstrates:;readonly


Step 6 - Adjust iFrame

After completing steps 1 - 5 your are able to add the URL parameters to the iFrame on your web page. Here is an example of code that you can copy:

Example 1:

<iframe src=";readonly"  
width="800" height="600" frameborder="0" style="border:0"></iframe>  

Example 2:

<iframe src=";readonly"   
width="100%" height="98%" frameborder="0"></iframe>

If you have further questions, we are happy to assist you in our Google Group.

Contact US

  • gs-soft AG

    Delfterstrasse 10

    CH-5000 Aarau


    +41 62 832 20 40
    This email address is being protected from spambots. You need JavaScript enabled to view it.

  • Language