On this page
Connect Your Own Map Service to map.army
map.army ships with a fixed list of background maps. If your organisation runs its own map service — a national survey agency’s, a defence geospatial service, or a tile server on your own network — you can have the app draw that instead, without any installation, by putting it in the link.
Quick answer — use your own map server
- Build a link:
https://www.map.army/?mapType=followed by your WMTS or WMS service description. See Building the link. - Open the link. Your service replaces the built-in base maps for that session. Open it a second time if the first load shows no map.
- Hand the link to your team: they need no setup.
What a mapType link does
A map.army address can carry a mapType parameter describing one map service. When the app finds it, that service becomes the background map:

It replaces the built-in list rather than joining it. The Map Type row disappears from Options → Map Settings altogether, because with a single service there is no longer a choice to offer:

The effect lasts only as long as the link. Nothing is saved: open map.army again without the parameter and the usual maps are back. That makes it a good way to hand somebody a working map of your own area — send the link and they need no setup — and a poor way to change your own default, because every visit needs the same link.
Open the link twice — the first load shows no map

On the first visit in a given browser, a mapType link currently shows no background map at all — a working toolbar over an empty canvas, exactly as above. Reload the page and your service appears. Everything else about the link works normally.
Measured on 2026-09-17 against build 6.1.1/7489: first load made zero requests to the tile service; a reload of the identical address made 19 and drew the map.
WMTS or WMS — telling them apart
Both are standard ways for a server to publish map imagery, and which one you have decides which properties you need. Your provider’s documentation will say, but the address itself is usually the giveaway.

In the diagram: 1 WMTS, pre-cut tiles; 2 WMS, an image drawn to order.
- A WMTS service (Web Map Tile Service) serves pre-cut square tiles. Its address is a template with placeholders for the tile’s position —
{z}for the zoom level,{x}and{y}for the column and row, as inhttps://tiles.example.org/{z}/{x}/{y}.png. It is the faster of the two because the server has done the work in advance. - A WMS service (Web Map Service) draws an image to order. Its address is a plain endpoint, and you also have to say which layers you want and in what image format, because one WMS endpoint typically publishes many.
If you are given a GetCapabilities URL, that is WMS. If you are given an address with {z}/{x}/{y} in it, that is WMTS.
Building the link
The JSON
The value of mapType is a JSON object. The shortest usable WMTS one needs just a type and an address:
{"type":"wmts","url":"https://tiles.example.org/{z}/{x}/{y}.png"}
A WMS one needs three things, because a bare endpoint is not enough to draw anything:
{"type":"wms","url":"https://wms.example.org/?","layers":"topo-colour","format":"image/png"}
Everything else is optional and described below. Get the required properties wrong and the app quietly ignores the whole parameter — see When the link does not work.
Encoding it into the address
JSON contains characters that are not safe in a URL — quotes, braces, commas — so the object has to be percent-encoded before it goes in the address. Any HTTP library or scripting language will do this for you. In a browser console:
const json = JSON.stringify(mapTypeObject);
const query = new URLSearchParams({ mapType: json }).toString();
const link = `https://www.map.army/?${query}`;
Pasting raw JSON into the address bar sometimes appears to work, because browsers encode some characters on your behalf — but not all of them, and the ones it misses fail silently. Encode it properly.
Worked examples
A WMTS service
OpenStreetMap’s standard tiles, with subdomains and attribution filled in. This is the link used for the screenshots on this page:
{"type":"wmts","url":"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png","subdomains":"abc","tileSize":256,"zoomLevel":[0,22],"credits":"OpenStreetMap contributors","creditsUrl":"https://www.openstreetmap.org/copyright"}
Encoded into a link:
https://www.map.army/?mapType=%7B%22type%22%3A%22wmts%22%2C%22url%22%3A%22https%3A%2F%2F%7Bs%7D.tile.openstreetmap.org%2F%7Bz%7D%2F%7Bx%7D%2F%7By%7D.png%22%2C%22subdomains%22%3A%22abc%22%2C%22tileSize%22%3A256%2C%22zoomLevel%22%3A%5B0%2C22%5D%2C%22credits%22%3A%22OpenStreetMap+contributors%22%2C%22creditsUrl%22%3A%22https%3A%2F%2Fwww.openstreetmap.org%2Fcopyright%22%7D
A WMS service
swisstopo’s 1:10 000 national map, tiled, restricted to the extent Switzerland actually occupies so the map is not blank elsewhere:
{"type":"wms","url":"https://wms.geo.admin.ch/?","layers":"ch.swisstopo.landeskarte-farbe-10","format":"image/jpeg","styles":"default","version":"1.3.0","tiled":true,"extent":[5.5,45.8,11,47.8],"zoomLevel":[7,21],"credits":"Federal Office of Topography swisstopo","creditsUrl":"https://www.geo.admin.ch/"}
Encoded into a link:
https://www.map.army/?mapType=%7B%22type%22%3A%22wms%22%2C%22url%22%3A%22https%3A%2F%2Fwms.geo.admin.ch%2F%3F%22%2C%22layers%22%3A%22ch.swisstopo.landeskarte-farbe-10%22%2C%22format%22%3A%22image%2Fjpeg%22%2C%22styles%22%3A%22default%22%2C%22version%22%3A%221.3.0%22%2C%22tiled%22%3Atrue%2C%22extent%22%3A%5B5.5%2C45.8%2C11%2C47.8%5D%2C%22zoomLevel%22%3A%5B7%2C21%5D%2C%22credits%22%3A%22Federal+Office+of+Topography+swisstopo%22%2C%22creditsUrl%22%3A%22https%3A%2F%2Fwww.geo.admin.ch%2F%22%7D

Where to go next
- mapType Link Reference — every property, projections, attribution, 3D view, troubleshooting and the limits of a link.
- Base maps — the built-in list, and what each map may be used for.
- Load a MilX® Layer via URL Parameter — every other parameter a link can carry.
- Import Overlays — image layers and vector layers, for putting your own material on top of a base map instead of replacing it.
Last updated: