Salta ai contenuti
IT

Attributi dei livelli — valori, colori e filtri

Un livello vettoriale caricato conserva ogni colonna del tuo file, e la mappa le mette a frutto: un clic su un elemento ne elenca i valori e può anche leggere i livelli raster della stanza sotto l’elemento; un livello può essere colorato in base a uno dei suoi attributi, con le righe corrispondenti nella legenda; e chiunque guardi la mappa può filtrare il livello dalla legenda — senza cambiare nulla per nessun altro.

Un clic su un elemento di un livello caricato apre un popup con gli attributi di quell’elemento: i primi otto, e Mostra tutti per vederne fino a 50. Le colonne tecniche come fid vengono omesse. I numeri seguono la tua lingua (0.452 in inglese, 0,452 in italiano) senza separatore delle migliaia, così ID e anni si leggono come sono scritti.

Il popup di un elemento con valori etichettati: classe di salute, valori NDVI con quattro decimali, punteggio del rilevatore e superficie della chioma in metri quadrati.

Funziona per ogni livello caricato. Un livello può anche essere configurato per mostrare solo i valori scelti, con etichette, decimali e unità — vedi Configurarlo. Le forme che disegni nella stanza non hanno attributi.

Un livello può anche essere configurato in modo che il suo popup legga i livelli raster della stanza sotto l’elemento cliccato, in una parte a sé, Valori dai livelli raster: l’NDVI medio della chioma di un albero da un raster NDVI, l’altezza media delle chiome di un popolamento forestale, l’indice di siccità sotto un campo. Funziona per qualsiasi livello vettoriale e qualsiasi livello raster della stessa stanza, anche quelli nascosti.

Ogni riga legge una banda di un raster, in uno di due modi:

  • La cella sotto il clic, per qualsiasi elemento.
  • Una statistica sulla forma cliccata, per i poligoni: media, mediana, 10° o 90° percentile, minimo, massimo o deviazione standard delle sue celle, oppure quante di esse contengono dati. Una cella conta quando il suo centro cade dentro la forma, buchi esclusi. Una forma troppo piccola per contenere il centro di una cella legge la cella sottostante.

Per linee e punti compaiono solo le righe della cella sotto il clic. Le statistiche usano la forma completa dell’elemento, non la parte disegnata sullo schermo.

I numeri sono i valori memorizzati del raster, non i colori sulla mappa. Le celle senza dati vengono escluse, e una forma senza alcun dato mostra Nessun dato, mai 0. Una riga senza un’etichetta propria prende il nome del raster e di ciò che legge, per esempio NDVI delle chiome: media sulla forma.

A differenza dei valori propri dell’elemento, le righe raster vengono lette dal server a ogni clic:

La riga mostra Significato
Lettura… il valore sta arrivando
Preparazione dei dati… il raster non viene letto da un po’, quindi il server prima lo recupera; la riga chiede di nuovo da sola
Nessun dato il raster non ha un valore in quel punto
Fuori dal raster l’elemento si trova oltre il bordo del raster
Livello raster non trovato · Più livelli raster hanno questo nome la riga nomina un raster che la stanza non ha, o un nome condiviso da due raster
Il raster non ha la banda N la riga chiede una banda che il raster non ha
Forma troppo grande da leggere la forma ha più di 5000 vertici, o copre più celle di quante una lettura possa contenerne
Impossibile caricare la forma · Non ancora pronto; riapri il popup più tardi · Impossibile leggere questa volta la lettura non è riuscita; riprova più tardi

Chiunque possa vedere la stanza vede queste righe, compresi i visitatori di una stanza pubblica. Le presentazioni non le mostrano.

Invece di un solo colore, un livello può prendere i suoi colori da un attributo:

Tipo Adatto a Esempio
Graduato numeri, in classi tra soglie NDVI sotto 0,20; 0,20–0,25; 0,25–0,30 … — un valore uguale a una soglia appartiene alla classe superiore
Categorico valori con un nome codici di uso del suolo, ciascuno con il proprio colore, e un colore per tutto il resto
Continuo numeri, su una scala di colori continua elevazione dal blu al marrone

Gli elementi senza valore — mancante, vuoto o non numerico — ricevono un proprio colore «nessun valore». La legenda elenca le classi del livello sotto la sua riga, oppure la scala di colori con i valori agli estremi.

Nella legenda, le righe delle classi di un livello colorato sono interruttori: fai clic su una per nasconderne o mostrarne gli elementi. Un livello può anche offrire filtri per intervallo — due cursori per il valore più basso e quello più alto mostrati, applicati quando li rilasci.

La legenda con le classi di salute di un livello, una disattivata, e un cursore del punteggio del rilevatore ristretto a 0,50–1,00.

I filtri sono solo tuoi:

  • Cambiano solo la tua mappa. Nella stanza non viene salvato nulla, non c’è nessuna voce nella cronologia e tutti gli altri — compreso chi sta presentando — continuano a vedere ogni elemento.
  • Anche i visualizzatori possono filtrare.
  • Ricaricare la pagina, o passare alla diapositiva successiva di una presentazione, mostra di nuovo tutto.
  • Un intervallo ristretto nasconde anche gli elementi senza valore; l’intervallo completo non nasconde nulla.
  • Un elemento escluso da un filtro non viene disegnato e non risponde ai clic.

Nella stanza non c’è ancora un editor per questo. Un livello riceve queste impostazioni — la sua visualizzazione degli attributi — in uno di tre modi:

  • Al caricamento, tramite l’API: aggiungi attributeDisplay allo style di POST /api/layers/upload o di POST /api/layers/process-chunked, oppure come campo di POST /api/rooms/:roomId/layers per il GeoJSON in linea.
  • Su un livello già presente nella stanza: invia PATCH /api/layers/:layerId con {"attributeDisplay": …}, usando un token della stanza con write. La mappa si aggiorna subito e la cronologia registra la modifica; null rimuove l’impostazione. Un PATCH sostituisce l’intera impostazione, quindi invia ogni parte che vuoi mantenere. Funziona per i livelli con più di 100 elementi; uno più piccolo viene tenuto nella stanza come una forma disegnata e riceve la sua impostazione al caricamento o all’importazione.
  • Con un GeoPackage della stanza: quando esporti e importi una stanza, ogni livello conserva la sua visualizzazione degli attributi, e lo stesso vale quando cloni una stanza.

Un esempio per chiome di alberi che portano un valore NDVI e un punteggio del rilevatore:

{
"version": 1,
"popup": {
"mode": "fields",
"fields": [
{ "key": "health_class", "label": "Health class" },
{ "key": "ndvi_mean", "label": "NDVI mean", "decimals": 4 },
{ "key": "detector_score", "label": "Detector score", "decimals": 3 },
{ "key": "area_m2", "label": "Crown area", "decimals": 1, "unit": "m²" }
]
},
"classification": {
"type": "graduated",
"field": "ndvi_mean",
"breaks": [0.2, 0.25, 0.3, 0.4],
"colors": ["#a50026", "#f46d43", "#fee08b", "#66bd63", "#006837"],
"labels": ["Dead", "Severely stressed", "Stressed", "Healthy", "Very healthy"],
"nullColor": "#9aa0a6",
"nullLabel": "No NDVI"
},
"filters": [
{ "type": "range", "field": "detector_score", "label": "Detector score",
"min": 0.2, "max": 1, "step": 0.01, "decimals": 2 }
],
"rasters": [
{ "layer": { "name": "Crown NDVI (2 m raster)" }, "stat": "mean",
"label": "NDVI, 2 m raster: crown mean", "decimals": 4 },
{ "layer": { "name": "Crown NDVI (2 m raster)" }, "stat": "value",
"label": "NDVI, 2 m raster: under the click", "decimals": 4 }
]
}

Le due righe rasters leggono il livello raster della stanza chiamato «Crown NDVI (2 m raster)»: la media sulla chioma cliccata e la cella sotto il clic.

Salvato come crowns-display.json, lo applichi a un livello con:

Terminal window
curl -X PATCH "$API/api/layers/$LAYER_ID" -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" -d "{\"attributeDisplay\": $(cat crowns-display.json)}"
Parte Che cosa fa Limiti
popup.mode auto: prima i campi elencati, poi tutti gli altri · fields: solo quelli elencati · none: nessun valore (le righe raster compaiono comunque) —
popup.fields key e, facoltativi, label, decimals (0–10) e unit fino a 40
classification graduated: breaks, colors con un colore in più delle soglie, labels facoltativo · categorical: categories con value, color e label, più otherColor · continuous: stops con value e color · tutti e tre: nullColor e nullLabel per gli elementi senza valore 19 soglie, 64 categorie, da 2 a 16 stop
filters filtri range su campi numerici: min e max e, facoltativi, step, decimals, unit e initial (l’intervallo mostrato all’inizio) fino a 4
rasters righe lette da un livello raster della stanza: layer (il suo name esatto, il suo id, o entrambi), band (predefinita 1), stat (value per la cella sotto il clic; mean, median, p10, p90, min, max, std o count sulla forma) e, facoltativi, label, decimals (0–10) e unit fino a 8, nessuna uguale a un’altra

Una riga raster trova il suo raster prima tramite l’id, poi tramite il nome esatto. Preferisci il nome: clonare o importare una stanza dà ai raster nuovi ID, e il nome li ritrova comunque.

I colori sono #rgb o #rrggbb. Le etichette possono essere lunghe fino a 64 caratteri e le unità fino a 16; l’intera impostazione occupa al massimo 24 KiB. Un’impostazione che l’app non può usare viene rifiutata con 400 invalid_attribute_display e un elenco di codici di errore in details, e non viene memorizzato nulla — correggila e inviala di nuovo.