Riferimento agli attributi
Per garantire l’interoperabilità e la facilità d’uso, tutti i livelli all’interno dell’ecosistema Toril GIS condividono una struttura di attributi standardizzata. Questa uniformità consente uno stile coerente, filtri e l’etichettatura multilingua tra diversi set di dati.
Fonti Dati e Formati di Esportazione
La tabella seguente descrive la struttura autorevole così come esiste nel database PostGIS principale. A seconda di come si consumano questi dati, gli attributi possono subire trasformazioni.
Sebbene supportiamo principalmente GeoPackage (.gpkg), i dati possono essere esportati in numerosi altri formati (come GeoJSON (.geojson) e Shapefile (.shp)). Nota bene: i cambiamenti nella struttura dei dati sono inevitabili durante l’esportazione a causa delle diverse specifiche dei formati. Siate pronti a una potenziale perdita di metadati nidificati o al troncamento degli attributi nei formati legacy.
Dizionario degli Attributi
| Nome | Tipo | Descrizione |
|---|---|---|
| Identità e Classificazione | ||
uuid |
UUID | ESTREMAMENTE IMPORTANTE. Questa è la chiave primaria e il “collante” dell’intero database. Tutti i dati relazionali — comprese le traduzioni in diverse lingue e il lore collegato — sono connessi tramite questo campo. Non cambiare o rigenerare mai l’UUID per gli oggetti esistenti, poiché ciò romperebbe l’integrità del database e tutti i collegamenti. |
layer_id |
Text | Identificatore interno che collega l’elemento al suo livello specifico (es. srf_civ_populated_places_pt). |
feature_class |
Text | Classificazione del tipo di elemento (es. “City”, “Forest”, “Ruins”). Questo è il campo principale per lo stile tematico. Per l’elenco completo dei valori ammessi, vedere Lavorare con layer e stili. |
feature_rank |
Integer | Scala di importanza che corrisponde ai livelli di zoom delle mappe web. Toril GIS si concentra principalmente su scale globali e regionali. Attualmente, l’intervallo è da 0 a 10 (dove 0 indica importanza globale), sebbene non sia un limite rigido. Tecnicamente, il sistema supporta valori più alti: ad esempio, 20 rappresenterebbe oggetti iper-locali come una singola casa. Vedere Lavorare con layer e stili. |
| Metadati del Progetto | ||
source |
Text | Codice di riferimento che rimanda alla mappa o al libro originale. Maggiori informazioni in Fonti dei dati. |
dnd_editions |
Array | Edizioni del gioco in cui questo elemento è presente (es. 2e, 3e, 5e). Consulta la guida alla Compatibilità tra edizioni D&D per vedere come queste si mappano sulla cronologia di Toril. |
timeframe |
Text | Riservato per filtri cronologici ad alta precisione (es. anni specifici). Questo campo è attualmente sperimentale e poco utilizzato, ma sarà vitale per le future versioni temporali/storiche della mappa. |
is_visible |
Boolean | Interruttore di visibilità principale. Se impostato su FALSE, l’elemento viene ignorato dagli stili standard. |
is_labeled |
Boolean | Interruttore globale per il rendering delle etichette. Consente di disattivare le etichette per elementi specifici anche se lo stile del livello ha l’etichettatura abilitata. |
needs_review |
Boolean | Uso Interno Sviluppatore. Un flag che indica che l’elemento richiede una verifica manuale, la regolazione delle coordinate o il controllo del lore. Gli utenti finali possono generalmente ignorarlo. |
review_notes |
Text | Uso Interno Sviluppatore. Istruzioni specifiche, problemi o note “to-do” riguardanti l’accuratezza dei dati dell’elemento. |
| Dati Spaziali e di Sistema | ||
geog |
Geography | Geometria canonica memorizzata in Toril GCS. Questi sono i dati spaziali master. Tutte le operazioni dovrebbero alla fine riflettersi in questa colonna. |
geog_extent |
JSONB | Bounding box pre-calcolato e altre misurazioni sia nel sistema Imperiale che in quello Metrico. |
location_paths |
JSONB | Percorsi gerarchici multilingua (es. {"en": ["Mhair Jungles", "Chult", "Faerûn"]}). Nel Progetto QGIS, gli attributi virtuali come location usano questi dati per renderizzare percorsi puliti come “Mhair Jungles → Chult → Faerûn”. |
last_edited |
Date | La data dell’ultima modifica per semplificare il tracciamento delle versioni. |
last_editor |
Text | Il nome utente o il processo responsabile dell’ultimo aggiornamento. |
extra |
JSONB | Archivio flessibile per attributi unici per specifici livelli. Se in futuro avessimo bisogno di aggiungere altri attributi, potranno essere memorizzati qui senza modificare la struttura del database principale. |
| Contenuto Multilingua | ||
name_{lang} |
Text |
Contenuto Autorevole. L’inglese (name_en) è la lingua master e la fonte primaria di verità. Tutti gli elementi hanno garantiti gli attributi in inglese. Le altre lingue (come name_it o name_ru) sono secondarie e dovrebbero tornare all’inglese se vuote. |
name_abb_{lang} |
Text | Nome abbreviato usato per spazi ristretti sulla mappa. Questi sono utilizzati nelle Regole di Etichettatura. |
name_alt_{lang} |
Array | Alias noti, nomi storici o varianti di ortografia nella lingua specificata. |
descr_{lang} |
Text | Descrizione testuale del lore dell’elemento. |
url_{lang} |
Text | Link a risorse lore rilevanti (es. Wiki o articoli di fonti primarie) in quella lingua specifica. |
Note Tecniche
Attributi Virtuali in QGIS
Il Progetto QGIS Toril GIS (il nostro ambiente di visualizzazione principale) include diversi Campi Virtuali. Questi non sono memorizzati nel database ma vengono calcolati al volo dagli attributi sopra elencati. Esempio: location – un attributo virtuale che formatta il JSON di location_paths in una stringa leggibile per suggerimenti e popup.
Localizzazione e Scala
Ogni campo di contenuto segue il pattern {field}_{lang_code}. Mentre l’attuale focus è su inglese (en) e russo (ru), lo schema è pronto per scalare su qualsiasi lingua. Allo stesso modo, la logica feature_rank garantisce che anche aggiungendo maggiori dettagli (fino ai singoli edifici), la mappa globale rimanga pulita e performante.