🗺️ Manuale Utente Web GIS
Guida completa alle funzionalità del Sistema Informativo Geografico del Raggruppamento Carabinieri Biodiversità. Usa la barra di ricerca o il menu laterale per navigare.
Il Web GIS del Raggruppamento Carabinieri Biodiversità è un sistema informativo geografico accessibile da browser, progettato per la visualizzazione, analisi e gestione di dati territoriali relativi alle aree naturali protette gestite dall'Arma.
Il sistema è basato su OpenLayers 10 e integra dati istituzionali da PCN (Portale Cartografico Nazionale), Catasto, SITAP e geoportali regionali.
L'interfaccia è divisa in tre aree principali:
- Pannello sinistro — strumenti operativi: ricerca, misure, disegno, buffer, geoprocessing, coordinate, caricamento file, altimetria, foto.
- Mappa centrale — visualizzazione interattiva con overlay di bussola, scala e coordinate.
- Pannello destro — gestione layer: vettoriali, WMS personalizzati, PCN, Catasto, SITAP, WMS regionali.
Il Web GIS utilizza il sistema di riferimento EPSG:32632 – UTM Zone 32N basato sul datum WGS84. È il sistema ufficiale adottato per l'Italia continentale.
| CRS | Descrizione | Uso |
|---|---|---|
EPSG:32632 | WGS84 / UTM Zone 32N | CRS interno della mappa |
EPSG:4326 | WGS84 Lat/Lon | Geocoding, popup coordinate |
EPSG:3857 | Web Mercator | Basemap raster (OSM, Bing…) |
EPSG:25832 | ETRS89 / UTM 32N | Catasto, SITAP |
Il campo di ricerca nella sezione "Ricerca" consente di trovare qualsiasi località italiana e mondiale usando il servizio Nominatim (OpenStreetMap).
- Digita il nome del luogo nel campo di ricerca (es. "Parco Nazionale del Pollino")
- Clicca Vai o premi Invio
- I risultati appaiono come lista cliccabile
- Clicca un risultato per centrare la mappa e aggiungere un marker temporaneo
Nella sezione "Inserisci Coordinate" puoi navigare direttamente a coordinate note:
- Seleziona il CRS delle coordinate (UTM 32N, WGS84, ecc.)
- Inserisci Est/X e Nord/Y nei rispettivi campi
- Opzionalmente, inserisci un'etichetta per il marker
- Clicca Vai per centrare la mappa e aggiungere un marker
| CRS | Formato X/Est | Formato Y/Nord |
|---|---|---|
| UTM 32N (32632) | es. 500000 | es. 4650000 |
| WGS84 (4326) | es. 12.4964 (lon) | es. 41.9028 (lat) |
| Web Mercator (3857) | es. 1390000 | es. 5150000 |
Nella sezione "Basemap" del pannello sinistro è possibile selezionare la mappa di sfondo:
| Nome | Tipo | Fonte |
|---|---|---|
| OSM Standard | Vettoriale | OpenStreetMap |
| OSM Humanitarian | Vettoriale | HOT / OpenStreetMap |
| CartoDB Light | Vettoriale | Carto |
| Satellite (ESRI) | Raster | ESRI World Imagery |
| Topo (OpenTopo) | Raster | OpenTopoMap |
| Terreno (Stamen) | Raster | Stadia/Stamen |
Nella sezione WMS del pannello destro, tra i layer PCN, sono disponibili ortofoto storiche:
- Ortofoto Colore 2012 — alta risoluzione, colore naturale
- Ortofoto Colore 2006 — media risoluzione, colore
- Ortofoto B/N 1988 — bassa risoluzione, bianco/nero storica
- DTM 20m — Modello Digitale del Terreno a 20 m di risoluzione
- Clicca Distanza nella sezione "Strumenti"
- Clicca sulla mappa per aggiungere punti della linea
- Il risultato aggiornato appare in tempo reale sotto i pulsanti
- Doppio click per terminare la misurazione
- Clicca Pulisci per rimuovere le misure
- Clicca Area nella sezione "Strumenti"
- Clicca sulla mappa per aggiungere i vertici del poligono
- L'area del poligono in formazione appare in tempo reale
- Doppio click per chiudere il poligono e finalizzare
- Clicca Pulisci per azzerare
Il risultato viene mostrato in m² per aree piccole e in km² per aree maggiori di 1 km².
- Colore — seleziona il colore tramite il color picker prima di disegnare
- Spessore — usa il cursore (1–8 px) per linee e bordi poligoni
- Opacità — percentuale di riempimento per i poligoni (5%–100%)
- Nome / Etichetta — testo visualizzato come label sulla feature
Il pulsante ✕ (rosso) annulla la sessione di disegno corrente senza eliminare gli elementi già creati.
Lo strumento buffer crea zone di influenza a distanza fissa attorno a geometrie esistenti.
- Inserisci la distanza in metri nel campo numerico
- Clicca Buffer disegno per applicare ai disegni correnti sulla mappa
- Oppure clicca Buffer layer per applicare ai layer vettoriali caricati
- Il buffer viene aggiunto come nuovo layer vettoriale
Il modulo Geoprocessing permette di eseguire analisi spaziali tra due layer vettoriali (A e B).
| Operazione | Simbolo | Risultato |
|---|---|---|
| Intersect | ∩ | Area comune ad A e B |
| Union | ∪ | Unione di A e B (geometria completa) |
| Clip | ✂ | Porzione di A entro i confini di B |
| Dissolve | ⬜→⬛ | Fonde le geometrie di A in un unico poligono |
- Seleziona il Layer A dal primo menu a tendina
- Seleziona il Layer B dal secondo menu (non necessario per Dissolve)
- Clicca l'operazione desiderata
- Il risultato appare come nuovo layer nel pannello destro
- Clicca ⟳ Aggiorna layer se i menu non mostrano i layer più recenti
- Apri la sezione "Inserisci Coordinate"
- Seleziona il sistema di riferimento dal menu CRS
- Inserisci i valori Est (X) e Nord (Y)
- Opzionalmente aggiungi un'etichetta per il marker
- Clicca Vai per centrare la mappa e aggiungere il marker
| Formato | Estensione | Note |
|---|---|---|
| GeoJSON | .geojson / .json | Nativo — consigliato |
| KML | .kml | Supporta stili e icone |
| KMZ | .kmz | KML compresso con JSZip |
| GPX | .gpx | Tracce GPS, waypoint |
| Shapefile | .zip (con .shp, .dbf, .prj) | ZIP con tutti i file del pacchetto SHP |
Puoi caricare i file in due modi:
- Drag & drop — trascina il file nella zona tratteggiata "Trascina qui…"
- Selezione file — usa il selettore file e poi clicca Carica
Dopo il caricamento, il layer appare nel pannello destro sotto "Layer vettoriali" con controlli di visibilità, stile, zoom e rimozione.
.shp, .dbf, .prj, .shx. Il file .prj è necessario per la reproiezione automatica.Da ogni layer nel pannello destro è possibile:
- Esporta GeoJSON — scarica il layer in formato GeoJSON
- Tabella attributi — visualizza gli attributi di tutte le feature
- Rimuovi — elimina il layer dalla mappa
- Apri la sezione "Profilo altimetrico"
- Clicca ✓ Disegna linea
- Clicca sulla mappa per tracciare il percorso (doppio click per terminare)
- Il profilo viene calcolato e mostrato in un pannello mobile
- Clicca ✕ Pulisci per azzerare
- Carica un layer lineare (GPX, GeoJSON con LineString)
- Selezionalo dal menu "Da layer caricato"
- Clicca Calcola
Il pannello altimetrico mostra:
- Distanza totale del percorso
- Quota minima e massima
- Dislivello positivo (+) e negativo (−)
- Pendenza media
I pulsanti 📷 PNG e 📄 PDF esportano il grafico del profilo.
Fonte dati quota: Open-Meteo Elevation API (SRTM/DEM globale, risoluzione ~90m).
- Trascina le immagini nella zona "Trascina JPG/PNG/WebP qui" o usa il selettore file
- Clicca Aggiungi
- Le immagini con coordinate EXIF GPS vengono posizionate automaticamente
- Cliccando sul marker sulla mappa si apre l'anteprima dell'immagine
- Usa il selettore "Immagine senza GPS"
- Clicca ✏ Manuale
- Clicca sulla mappa nel punto desiderato
- L'immagine viene posizionata alle coordinate cliccate
Il pulsante ✕ Annulla posizionamento permette di uscire dalla modalità manuale.
- Apri la sezione "Logo in mappa"
- Seleziona un file immagine (PNG, JPG, SVG)
- Scegli la posizione dal menu (Alto sinistra/destra, Basso sinistra/destra)
- Il logo appare immediatamente in sovrimpressione sulla mappa
- Clicca ✕ per rimuovere il logo
Il pannello destro PCN integra centinaia di layer dal Portale Cartografico Nazionale del Ministero dell'Ambiente:
- Carte topografiche (CTR, IGM)
- Limiti amministrativi (comuni, province, regioni)
- Aree naturali protette (parchi nazionali, SIC, ZPS)
- Reticolo idrografico
- Uso del suolo (Corine Land Cover)
- Ortofoto 1988, 2006, 2012
- DTM 20m
Il cursore "Trasparenza WMS" nella sezione PCN controlla l'opacità globale di tutti i layer WMS attivi. Il valore predefinito è 85%.
La sezione Catasto integra i servizi WMS dell'Agenzia delle Entrate tramite il WMS ufficiale GEOSERVER:
- Mappa catastale (particelle, fabbricati)
- Confini catastali
- Fogli di mappa
- Numeri particelle
Dati disponibili a scala di dettaglio (zoom > 1:5.000). La fonte è il WMS pubblico CC BY 4.0 dell'AdE.
Il SITAP (Sistema Informativo Territoriale Ambientale e Paesaggistico) offre la cartografia dei vincoli paesaggistici ai sensi del D.Lgs 42/2004:
- Aree tutelate per legge (art. 142): corsi d'acqua, montagne, boschi, zone costiere…
- Aree soggette a vincolo diretto (art. 136): immobili e aree di notevole interesse
- Piani paesaggistici regionali
Fonte: Ministero della Cultura (MiC) – SITAP.
Il pannello "WMS Regionali & Enti" integra layer da geoportali istituzionali italiani:
- Geoportali regionali — cartografie ufficiali di tutte le regioni
- ISPRA — Istituto Superiore per la Protezione e la Ricerca Ambientale
- Autorità di Bacino Distrettuali — piani assetto idrogeologico (PAI)
- Reti ecologiche, habitat, flora/fauna
- Copia l'URL del servizio WMS (es.
https://host.it/wms?) - Incollalo nel campo "WMS personalizzati" nel pannello destro
- Clicca Aggiungi WMS
- Il sistema interroga il GetCapabilities e mostra i layer disponibili
- Spunta i layer desiderati e clicca Aggiungi selezionati
/gis/proxy.php sia attivo sul server.Clicca il pulsante 🖨️ Esporta in basso nel pannello sinistro. Si apre il Layout Manager Avanzato con due aree principali:
- Pannello sinistro — impostazioni: formato, preset, testi, scala, elementi, loghi, legenda
- Anteprima layout — canvas interattivo con gli elementi posizionabili
| Formato | Dimensione | Orientamento |
|---|---|---|
| A4 Orizzontale | 297 × 210 mm | Landscape |
| A4 Verticale | 210 × 297 mm | Portrait |
| A3 Orizzontale | 420 × 297 mm | Landscape |
| A3 Verticale | 297 × 420 mm | Portrait |
| A2 Orizzontale | 594 × 420 mm | Landscape |
| A2 Verticale | 420 × 594 mm | Portrait |
Il pulsante ⟳ Ripristina layout riporta tutti gli elementi alle posizioni predefinite.
- Trascina qualsiasi blocco nell'anteprima per riposizionarlo liberamente
- 8 handle di ridimensionamento appaiono su ogni blocco selezionato (angoli + medi)
- Guide di allineamento rosse appaiono durante il trascinamento quando i bordi si allineano ad altri elementi
- Snap griglia (0.5%) — attivabile/disattivabile dal checkbox "Snap griglia"
- Snap magnetico ai bordi degli altri elementi (attrazione automatica a 0.9%)
- Pannello proprietà X/Y/W/H — valori percentuali modificabili numericamente
Sono disponibili 3 slot logo indipendenti. Per ogni slot:
- Clicca sullo slot o trascina un'immagine direttamente
- Il logo appare nel blocco corrispondente nell'anteprima layout
- Il blocco logo deve essere abilitato nel pannello "Elementi layout"
I loghi PNG con trasparenza vengono esportati senza sfondo bianco nel PDF. Il canale alpha è preservato nativamente da jsPDF.
- Clicca ⟳ Aggiorna per caricare i layer visibili nella legenda
- Abilita/disabilita singole voci con il checkbox
- Rinomina le voci modificando il testo nel campo adiacente
- Riordina trascinando le righe con la maniglia
≡
Il sistema di export attende il completo caricamento dei tile WMS prima di catturare la mappa:
- Monitoraggio eventi
tileloadstart/tileloadendper ogni sorgente - Stabilizzazione dopo 450ms senza nuove richieste tile
- Timeout di sicurezza 12 secondi (procede comunque)
Il canvas mappa viene ritagliato in modalità COVER per riempire esattamente il box del layout — nessuna barra grigia, nessuna distorsione.
I browser moderni applicano la politica Same-Origin Policy: se un'immagine WMS proviene da un dominio diverso rispetto alla pagina web, il canvas HTML5 viene marcato come "tainted" (contaminato).
Un canvas tainted non può essere esportato via toDataURL() — il browser blocca l'operazione per motivi di sicurezza. Il risultato è un export con la mappa bianca o con solo la basemap.
| Situazione | Export standard | Soluzione |
|---|---|---|
| Solo basemap (OSM, satellite…) | ✅ Funziona | — |
Layer WMS tramite proxy /gis/proxy.php | ✅ Funziona | Il proxy aggiunge header CORS |
| Layer WMS senza proxy (cross-origin) | ❌ Bianco/parziale | Usa 📸 Cattura schermata |
/gis/proxy.php) risolve automaticamente il problema CORS per i WMS istituzionali (PCN, Catasto, SITAP, WMS regionali). Per WMS di terze parti non instradati dal proxy, usa la cattura schermata.- Configura il layout (formato, testi, elementi)
- Clicca 📄 PDF per export PDF professionale con tutti gli elementi
- Oppure clicca 📷 PNG per export dell'immagine mappa con intestazione
- Il pulsante mostra "⏳ Elaborazione…" durante il rendering
- Il file viene scaricato automaticamente come
mappa_rgpbio.pdfomappa_rgpbio.png
La Cattura schermata è la soluzione consigliata quando l'export standard (PDF/PNG) produce una mappa bianca o incompleta a causa di layer WMS cross-origin non accessibili tramite il proxy.
A differenza dell'export standard — che legge i dati pixel dal canvas HTML5 — la cattura schermata utilizza la Screen Capture API del browser (getDisplayMedia) per fotografare visualmente la scheda del browser, producendo sempre un'immagine completa di tutto ciò che è visibile.
- Apri la finestra di export cliccando 🖨️ Esporta nel pannello sinistro
- Configura il layout come desideri (titolo, formato, elementi)
- Nel pannello impostazioni, spunta l'opzione 📸 Cattura schermata (consigliato WMS)
- Oppure clicca direttamente il pulsante 📸 Cattura nell'intestazione della finestra
- La finestra di export si nasconde automaticamente
- Il browser mostra la finestra di condivisione schermo: seleziona "Questa scheda" e clicca Condividi
- Il sistema attende che lo schermo sia stabile, poi cattura l'immagine automaticamente
- La finestra di export riappare con il file pronto per il download
La cattura schermata fotografa la viewport della mappa (l'area visibile dello schermo) e aggiunge automaticamente in sovrimpressione:
- Barra del titolo — in basso, con titolo, data, CRS e autore
- Pannello legenda — in alto a destra, con i layer visibili
- Scala grafica — in basso a sinistra, calibrata sulla scala corrente
La finestra di export e tutti gli overlay dell'interfaccia vengono nascosti automaticamente prima della cattura: nell'immagine finale appare solo la mappa.
La cattura può produrre entrambi i formati:
- PNG — immagine raster ad alta risoluzione, pronta per presentazioni e reportistica
- PDF — documento con la mappa catturata, inclusi titolo e metadati, formato A4/A3 come impostato nel layout
Il tag del file indica sempre la modalità usata: "Cattura schermo" per la cattura API, "Snapshot schermo" per la modalità canvas diretta.
| Browser | Supporto | Note |
|---|---|---|
| Chrome / Edge (v94+) | ✅ Completo | Supporta preferCurrentTab |
| Firefox (v116+) | ✅ Parziale | Richiede selezione manuale della scheda |
| Safari | ❌ Non supportato | API non disponibile |
| Metodo | Qualità | WMS cross-origin | Personalizzazione | Uso consigliato |
|---|---|---|---|---|
| Export standard | Alta (DPI configurabile) | ⚠️ Dipende dal proxy | Layout completo | Basemap + layer proxy |
| Snapshot canvas | Alta (canvas directo) | ⚠️ Solo layer CORS-safe | Overlay cartografico | Fallback rapido |
| Cattura schermata | Media (viewport) | ✅ Sempre funziona | Overlay cartografico | WMS cross-origin |
| Tasto / Combinazione | Funzione |
|---|---|
| + / = | Zoom in |
| - | Zoom out |
| ← → ↑ ↓ | Pan mappa |
| R | Reset rotazione Nord-up |
| Shift + trascina | Box zoom su area selezionata |
| Alt + trascina | Ruota la mappa |
| Doppio click | Zoom in centrato + termina disegno |
| Invio in Ricerca | Avvia geocoding |
| Esc | Annulla modalità corrente (disegno, buffer…) |