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.

Suggerimento:

Risposta rapida — usare un proprio server di mappe

  1. Costruisci un link: https://www.map.army/?mapType= seguito dalla descrizione del tuo servizio WMTS o WMS. Vedi Costruire il link.
  2. 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.
  3. Passa il link al tuo gruppo: non serve alcuna configurazione.

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:

map.army che disegna un servizio WMTS OpenStreetMap personalizzato come mappa di sfondo, caricato da un link mapType

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:

Menu a tendina Tipo di mappa di map.army espanso, con Satellite, Terrain, Hybrid, Roads, Roadmap e OSM

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.

Suggerimento: Non c’è alcun campo nel pannello Opzioni per l’indirizzo di un servizio di mappe. Il link è l’unico modo per farlo nell’app ospitata; l’app ospitata non ha un elenco permanente dei tuoi servizi — vedi Ambito dell’app ospitata.
map.army alla prima visita di un link mapType: barra degli strumenti funzionante, area mappa completamente vuota

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.

Suggerimento: Invia il link con l’indicazione “aprilo, poi ricarica una volta”. Chi apre il tuo link, vede una mappa vuota e chiude la scheda non ha modo di sapere che qualcosa non ha funzionato — non compare alcun messaggio di errore. Finché questo non viene corretto nell’app, il ricaricamento è la soluzione temporanea, ed è utile dirlo esplicitamente a chi riceve il link.

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.

A sinistra: tessere prefabbricate (WMTS); a destra: un'immagine disegnata su richiesta (WMS).

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 in https://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.

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
map.army mostra il WMS swisstopo dell'esempio: la carta nazionale svizzera entro la sua estensione

Dove andare adesso

Ultimo aggiornamento: