In questa pagina
Riferimento link mapType: proprietà e limiti
Questa pagina è il riferimento per i link mapType di map.army: ogni proprietà, le proiezioni che funzionano, l’attribuzione e ciò che un link non può fare. Per costruire il primo link, parti da Collega un tuo servizio di mappe a map.army.
Ogni proprietà in dettaglio
La proprietà extent (vedi la tabella sotto) limita dove viene disegnato il servizio: dentro il riquadro (1) la mappa è visibile, all’esterno (2) resta vuota.
Proprietà comuni a entrambi i tipi di servizio
| Proprietà | Significato | Obbligatoria |
|---|---|---|
type | wmts o wms. Qualsiasi altro valore e il parametro viene ignorato. | Sì |
url | L’indirizzo del servizio. Per WMTS un modello XYZ contenente {z}, {x} e {y}, più {s} se usi i sottodomini. Per WMS l’endpoint. | Sì |
extent | L’area effettivamente coperta dal servizio, come [xmin, ymin, xmax, ymax] in gradi WGS84 — prima la longitudine. Al di fuori la mappa è vuota. Per impostazione predefinita è il mondo intero. | No |
epsg | Il sistema di coordinate in cui il servizio pubblica, come codice EPSG. Il valore predefinito è 3857. Consulta Quali proiezioni funzionano prima di usare qualsiasi altro codice. | No |
epsgExtent | Un confine espresso nelle unità di epsg anziché in gradi. Questo definisce la griglia di tile, non il ritaglio del layer, ed è significativo solo per WMTS o per un WMS con tiled: true — un WMS non tiled semplice non ha una griglia di tile e lo ignora. | No |
zoomLevel | Lo zoom minimo e massimo supportato dal servizio, come [min, max]. Richiedere uno zoom che il server non ha produce tile vuote. | No |
credits | Il testo di attribuzione. Vedi Attribuzione e crediti — ha effetto solo insieme a creditsUrl. | No |
creditsUrl | Il link dietro quel testo di attribuzione. | No |
Solo WMTS
| Proprietà | Significato | Obbligatoria |
|---|---|---|
subdomains | Le lettere su cui far ruotare il segnaposto {s}, scritte come un’unica stringa senza separatori — abc significa a, b e c. I fornitori li offrono così un browser può recuperare tile da più host contemporaneamente. Omettilo se il tuo url non contiene {s}. | No |
tileSize | Il lato della tile in pixel. Il valore predefinito è 256, usato da quasi tutti i servizi; alcuni più recenti servono 512. | No |
Solo WMS
| Proprietà | Significato | Obbligatoria |
|---|---|---|
layers | I nomi dei layer da richiedere, esattamente come il servizio li denomina. Più valori sono separati da virgola. | Sì |
format | Il tipo di immagine come tipo MIME — image/jpeg per immagini fotografiche, image/png dove serve la trasparenza. | Sì |
styles | Lo stile del layer, vuoto per impostazione predefinita. Nota il plurale: una chiave style viene ignorata, il che è facile non notare perché la richiesta ha comunque successo e usa semplicemente lo stile predefinito del server. | No |
version | La versione della specifica WMS. Il valore predefinito è 1.3.0. I server più vecchi potrebbero richiedere 1.1.1, che differisce nell’ordine delle coordinate. | No |
tiled | true richiede la mappa come tante piccole tile, false come una singola grande immagine per vista. Tiled è di solito più veloce e più leggero per il server; alcuni servizi supportano solo una delle due modalità. | No |
Quali proiezioni funzionano
La vista della mappa è sempre in Web Mercator. Il tuo epsg indica all’app in cosa pubblica il servizio, e la mappa riproietta da quel sistema — ma solo per i sistemi di coordinate che conosce.
3857(Web Mercator) e4326(WGS84 lon/lat) funzionano sempre. Sono integrati.- Qualsiasi altro codice non è supportato a meno che tu non l’abbia testato. Gli altri codici dipendono dalla registrazione di una definizione di proiezione prima che la mappa venga costruita, e ciò non avviene in modo affidabile. Un servizio svizzero LV95 (
2056) potrebbe funzionare; un servizio ETRS89/UTM come25832è molto improbabile che funzioni.
Se il tuo servizio pubblica solo in una griglia nazionale, la strada affidabile è chiedere al tuo fornitore se serve anche 3857 o 4326 — la maggior parte lo fa — invece di passare il codice nazionale sperando che funzioni.
Attribuzione e crediti
credits e creditsUrl sono opzionali per l’app, ma di solito non lo sono per la tua licenza. La maggior parte dei servizi di mappe, inclusi OpenStreetMap e ogni agenzia cartografica nazionale, richiede che la propria attribuzione compaia ovunque le proprie immagini siano mostrate.
Se compilati, compaiono in due punti:
- Nell’app, come link nel pannello informazioni — il pulsante i nell’angolo in basso a destra — con la dicitura
© Map Data:seguita dal tuo testocredits, che rimanda al tuocreditsUrl. Verificato il 2026-09-17: un link che portava l’attribuzione di OpenStreetMap ha prodotto lì© Map Data: OpenStreetMap contributors, esattamente come le mappe integrate producono© Map Data: Google. - Nel piè di pagina di ogni esportazione e stampa, che è quello che di solito conta ai fini della licenza.
Nota che il credito nell’app è dietro quel pulsante, non disegnato sulla mappa. Se la tua licenza richiede che l’attribuzione sia visibile senza un clic, il piè di pagina dell’esportazione è dove puoi fare affidamento.
credits senza creditsUrl non produce nulla — nessun link nel pannello e un piè di pagina di esportazione vuoto, senza alcun avviso in entrambi i casi. Se l’attribuzione conta per la tua licenza, imposta entrambe e controlla un’esportazione prima di pubblicarla.La vista 3D
Le mappe personalizzate caricate con il parametro URL mapType non sono supportate nella vista 3D. La vista 3D usa invece una mappa di riserva, quindi il tuo servizio non vi compare; usa la mappa 2D per vederlo.
Combinare con altri parametri
mapType viene letto indipendentemente dagli altri parametri URL, quindi un unico link può portare il tuo servizio di mappe e precaricare un layer con layer=. I parametri funzionano in un embed iframe esattamente come in un link normale.
mapType sia una condivisione smette di essere il link che hai inviato. Quando l’app apre una condivisione, riscrive la barra degli indirizzi con l’indirizzo proprio della condivisione e mantiene solo i parametri della condivisione — quindi mapType scompare dall’URL. La mappa continua a funzionare per quella sessione, ma l’indirizzo non è più copiabile, salvabile nei preferiti o ricaricabile come link combinato. Conserva l’originale da qualche parte se ti serve di nuovo, e ricorda che il ricaricamento al primo caricamento richiede proprio quel link.Condividere una mappa caricata in questo modo
Se apri map.army con un link mapType e poi crei una condivisione, la persona che apre la tua condivisione non riceve il tuo servizio di mappe. Riceve il proprio sfondo predefinito con il tuo layer sopra di esso.
Nel diagramma: 1 il tuo schermo, con il tuo sfondo e il tuo layer; 2 il destinatario, con il proprio sfondo predefinito e il tuo layer sopra.
Questo è il malinteso più probabile su questa pagina, perché nulla sullo schermo lo lascia intuire: la tua condivisione ti appare corretta. La condivisione memorizza quale mappa di base era selezionata ma non la sua definizione, e il tuo servizio non ha mai fatto parte dell’elenco del destinatario, quindi la sua app ricade sul proprio predefinito.
Per dare a qualcuno la tua mappa di sfondo oltre al tuo layer, inviagli direttamente il link mapType — con il parametro layer= se vuoi che il layer lo accompagni — invece di una condivisione.
Quando il link non funziona
Ci sono tre errori distinti, e appaiono diversi sullo schermo.
Una mappa vuota al primo caricamento. Previsto, per ora — ricarica la pagina. Vedi Apri il link due volte.
Il tuo servizio viene ignorato e appaiono le mappe normali. Il JSON era leggibile ma non descriveva un servizio utilizzabile — un type diverso da wmts o wms, un url mancante, oppure un WMS senza layers o format. L’app torna al suo elenco integrato. Controlla le proprietà richieste per il tuo tipo di servizio.
Nessuna mappa, nemmeno dopo un ricaricamento. O il JSON non poteva essere letto — una virgola in più, una parentesi graffa spaiata, un carattere non codificato — oppure il servizio non è raggiungibile in un modo che l’app può usare. Per il JSON, incollalo in un qualsiasi validatore prima di codificarlo. Per il servizio, controlla tre cose in quest’ordine:
- Accesso cross-origin. map.army disegna ogni tile tramite un canvas, in modo da poter applicare luminosità, tonalità e crominanza e da poter includere la mappa in un’esportazione. Questo significa che il tuo servizio deve inviare un’intestazione
Access-Control-Allow-Originche permetta l’origine dell’app. Un servizio che non lo fa non mostrerà nulla, anche se lo stesso identico URL di tile si apre perfettamente in una scheda del browser. Questa è la causa più comune di un servizio apparentemente corretto che non compare mai, ed è la più difficile da indovinare. - HTTPS. Un browser blocca le immagini in HTTP semplice all’interno di una pagina HTTPS.
- Raggiungibilità. Verifica che il servizio risponda dalla macchina che esegue il browser, non solo dall’interno della tua rete.
Se non riesci a far sì che il tuo servizio invii intestazioni cross-origin, la soluzione abituale è mettergli davanti un proxy che possa farlo, sulla tua stessa infrastruttura.
Cosa un link non può fare
- Un solo servizio per link. Non c’è modo di passare un elenco, né di aggiungere il tuo accanto alle mappe integrate.
- Non viene ricordato. Ogni visita richiede di nuovo il link.
- Non compare nel pannello Opzioni come nuova voce — prende il posto dell’intero elenco, e la riga Tipo di mappa scompare.
- Non viaggia in una condivisione. Vedi sopra.
epsg,epsgExtentetileSizesono rispettati qui ma non nel file di configurazione proprio di una distribuzione, quindi un link può descrivere un servizio in modo più preciso di quanto possa fare una distribuzione installata.
Per un elenco permanente dei tuoi servizi, selezionabile come qualsiasi altra mappa e condiviso da chiunque usi quella distribuzione, vedi Gratuito vs Pro.
Ultimo aggiornamento: