In questa pagina
Collega un tuo servizio di mappe a map.army
map.army viene fornito con un elenco fisso di mappe di sfondo. Se la tua organizzazione gestisce un proprio servizio di mappe — quello di un’agenzia cartografica nazionale, un servizio geospaziale della difesa, o un tile server sulla tua rete — puoi far disegnare quello all’app al suo posto, senza alcuna installazione, semplicemente inserendolo nel link.
Risposta rapida — usare un proprio server di mappe
- Costruisci un link:
https://www.map.army/?mapType=seguito dalla descrizione del tuo servizio WMTS o WMS. Vedi Costruire il link. - Apri il link. Il tuo servizio sostituisce le mappe di base integrate per quella sessione. Aprilo una seconda volta se il primo caricamento non mostra alcuna mappa.
- Passa il link al tuo gruppo: non serve alcuna configurazione.
Cosa fa un link mapType
Un indirizzo di map.army può portare un parametro mapType che descrive un servizio di mappe. Quando l’app lo trova, quel servizio diventa la mappa di sfondo:

Sostituisce l’elenco integrato invece di aggiungersi ad esso. La riga Tipo di mappa scompare del tutto da Opzioni → Impostazioni mappa, perché con un solo servizio non c’è più alcuna scelta da offrire:

L’effetto dura solo quanto il link. Non viene salvato nulla: apri di nuovo map.army senza il parametro e tornano le mappe abituali. Questo lo rende un buon modo per consegnare a qualcuno una mappa funzionante della tua zona — invii il link e non serve alcuna configurazione da parte loro — ma un modo scadente per cambiare la tua impostazione predefinita, perché ogni visita richiede lo stesso link.
Apri il link due volte — il primo caricamento non mostra alcuna mappa

Alla prima visita in un dato browser, un link mapType al momento non mostra alcuna mappa di sfondo — una barra degli strumenti funzionante sopra una tela vuota, esattamente come sopra. Ricarica la pagina e il tuo servizio compare. Tutto il resto del link funziona normalmente.
Misurato il 2026-09-17 sulla build 6.1.1/7489: il primo caricamento ha effettuato zero richieste al servizio di tile; un ricaricamento dello stesso indirizzo ne ha effettuate 19 e ha disegnato la mappa.
WMTS o WMS — come distinguerli
Sono entrambi modi standard con cui un server pubblica immagini di mappe, e quale dei due hai decide quali proprietà ti servono. La documentazione del tuo fornitore lo indica, ma è di solito l’indirizzo stesso a tradirlo.

Nel diagramma: 1 WMTS, tile pre-tagliate; 2 WMS, immagine disegnata su richiesta.
- Un servizio WMTS (Web Map Tile Service) serve tile quadrate pre-tagliate. Il suo indirizzo è un modello con segnaposto per la posizione della tile —
{z}per il livello di zoom,{x}e{y}per colonna e riga, come inhttps://tiles.example.org/{z}/{x}/{y}.png. È il più veloce dei due perché il server ha già fatto il lavoro in anticipo. - Un servizio WMS (Web Map Service) disegna un’immagine su richiesta. Il suo indirizzo è un semplice endpoint, e devi anche indicare quali layer vuoi e in quale formato immagine, perché un endpoint WMS pubblica tipicamente molti layer.
Se ti viene fornito un URL GetCapabilities, è WMS. Se ti viene fornito un indirizzo con {z}/{x}/{y} al suo interno, è WMTS.
Costruire il link
Il JSON
Il valore di mapType è un oggetto JSON. Il più corto utilizzabile per WMTS richiede solo un tipo e un indirizzo:
{"type":"wmts","url":"https://tiles.example.org/{z}/{x}/{y}.png"}
Uno per WMS ne richiede tre, perché un semplice endpoint non basta per disegnare nulla:
{"type":"wms","url":"https://wms.example.org/?","layers":"topo-colour","format":"image/png"}
Tutto il resto è opzionale ed è descritto più sotto. Se sbagli le proprietà richieste, l’app ignora silenziosamente l’intero parametro — vedi Quando il link non funziona.
Codificarlo nell’indirizzo
Il JSON contiene caratteri non sicuri in un URL — virgolette, parentesi graffe, virgole — quindi l’oggetto deve essere codificato in percent-encoding prima di inserirlo nell’indirizzo. Qualsiasi libreria HTTP o linguaggio di scripting lo fa per te. Nella console del browser:
const json = JSON.stringify(mapTypeObject);
const query = new URLSearchParams({ mapType: json }).toString();
const link = `https://www.map.army/?${query}`;
Incollare il JSON grezzo nella barra degli indirizzi a volte sembra funzionare, perché i browser codificano alcuni caratteri al posto tuo — ma non tutti, e quelli che tralasciano falliscono silenziosamente. Codificalo correttamente.
Esempi pratici
Un servizio WMTS
Le tile standard di OpenStreetMap, con sottodomini e attribuzione compilati. Questo è il link usato per gli screenshot di questa pagina:
{"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"}
Codificato in un 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
Un servizio WMS
La carta nazionale 1:10 000 di swisstopo, in modalità tiled, limitata all’estensione effettivamente occupata dalla Svizzera così che la mappa non sia vuota altrove:
{"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/"}
Codificato in un 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

Dove andare adesso
- Riferimento link mapType — ogni proprietà, proiezioni, attribuzione, vista 3D, risoluzione dei problemi e limiti di un link.
- Mappe di base — l’elenco integrato, e per cosa può essere usata ciascuna mappa.
- Caricare un layer MilX® tramite parametro URL — ogni altro parametro che un link può portare.
- Import Overlays — layer immagine e layer vettoriali, per mettere il tuo materiale sopra una mappa di base invece di sostituirla.
Ultimo aggiornamento: