Skip to content

FAQ

Jump to bottom Edit New page
Giovanni Lughi edited this page May 25, 2026 · 15 revisions

FAQ rer3d-map

Dove trovo la documentazione sugli stili dei layers per il catalogo?

Ogni tipo di layer può seguire regole differenti per la definizione degli stili. Le chiavi di queste regole sono descritte nella documentazione di ogni tipo di layer: https://docs-v8.terria.io/guide/connecting-to-data/catalog-items/

StyleTraits

  • definisce regole valide per tutti gli elementi del layer
  • le regole seguono simplestyle-spec
  • usa le primitive di disegno di Cesium
  • supportato da GeoJSON, Gpx, WFS, Esri Feature Server

PerPropertyGeoJsonStyleTraits

  • permette di definire molteplici StyleTraits da applicare agli elementi a seconda che le loro proprietà matchino o meno certi valori
  • può essere usato insieme a StyleTraits (in questo caso StyleTraits diventa il default usato per gli elementi le cui proprietà non matchano nessuna regola di PerPropertyGeoJsonStyleTraits)
  • supportato da GeoJSON, Gpx, WFS, Esri Feature Server

TableStyleTraits

Kml/Kmz

drawingInfo

3d-tiles

Come inserisco la apikey per le mappe OSM Thunderforest?

Al momento la v8 non permette l'uso delle apikey.

Perchè la ricerca di un toponimo a seconda dei casi si posiziona a diversi livelli di zoom?

Se il toponimo selezionato corrisponde ad un oggetto puntuale la camera si avvicinerà maggiormente al suolo, se invece si tratta di un oggetto lineare rimarrà ad una maggiore distanza.

Nel passaggio da v7 a v8 cosa succede ai link salvati e ai file .geo3?

Dovrebbero comunque funzionare ma dando all'utente una serie di messaggi di errore. Appena fatto e controllato sarebbe opportuno rigenerare o risalvare con v8.

Che dimensione devono avere i loghi della Regione? E da dove vengono impostati nel portale?

  • logo grande = 340x60
  • logo piccolo = 50x40 Nel file wwwroot/config.json tramite i campi
  • brandBarElements per l'interfaccia standard (PC)
  • brandBarSmallElements per l'interfaccia da smartphone i campi sono array di loghi, che verranno affiancati, ogni elemento deve essere il testo di un componente HTML.

Come si crea il link ad un elemento del catalogo?

Il link ad un elemento di catalogo si realizza aggiungendo, in qualsiasi posizione del catalogo, in sua vece un elemento contenente solo l'id dell'elemento desiderato.

Se ad esempio si ha un elemento del genere

{
  "id": "c3f6ik",
  "name": "PalazzoAccursio",
  "type": "3d-tiles",
  "ionAccessToken": "...",
  "ionAssetId": ...
}

si potrà inserie un link in qualsiasi altro punto del catalogo con

{
  "id": "c3f6ik"
}

localId è un identificativo che, al contrario di id non genera link.

Il catalogo è inviato compresso?

Si

Come configurare le attribuzioni delle mappe base?

Nel catalogo (in questo caso nel catalogo delle basemaps), tramite la chiave attribution, come per qualsiasi layer.

Come configurare le attribuzioni del terreno caricato su Cesium ION?

Può essere impostato direttamente su Cesium ION, tramite l'apposito campo "Attribution" dell'asset terreno specifico.

L'ordine in cui definisco le parti del catalogo è rilevante?

Si, l'ordine degli elementi di initializationUrls (nel file config.json) è rilevante: ogni elemento può sovrascrivere quanto impostato in quelli che lo precedono.

Come configurare gli altri link di scarico, in basso a sinistra nella mappa

Quei link puntano alla pagina About.html quindi il testo opportuno va inserito in essa.

Perchè WMS Agenzia delle Entrate non va?

Perchè non supporta un sistema di riferimento delle coordinate compatibile (es. EPSG:4326)

Dove si trova la traduzione dell'interfaccia?

In wwwroot/languages/it/translation.json Vedi anche https://docs-v8.terria.io/guide/customizing/client-side-config/#languageconfiguration

Dove si trova la traduzione di Help e Guida?

In wwwroot/languages/it/languageOverrides.json

Dove trovo la documentazione su come controllare il portale tramite URL (es. per visualizzare un determinato layer all'apertura)?

https://docs-v8.terria.io/guide/deploying/controlling-with-url-parameters/

Segue un esempio in cui, tramite l'URL si specifica di aprire il portale in un punto preciso:

https://mappe.regione.emilia-romagna.it/#start=%7B%22initSources%22%3A+%5B%7B%22initialCamera%22%3A+%7B%22lookAt%22%3A+%7B%22targetLongitude%22%3A+11.367275%2C%22targetLatitude%22%3A+44.503572%2C%22targetHeight%22%3A+0%2C%22heading%22%3A+0%2C%22pitch%22%3A+90%2C%22range%22%3A+1000%7D%7D%7D%5D%7D

Come posso convertire un catalogo fatto per la v7 in modo che funzioni con la v8?

Convertire il catalogo v7 usando uno dei seguenti due metodi:

  1. l'interfaccia web https://catalog-converter.terria.io/
  2. lo script da console https://github.com/TerriaJS/catalog-converter

Tenere presente che la chiave show permette, per ogni elemento del catalogo, di indicare se di default, una volta aggiunto al workbench, debba essere attivo (cioè visibile) oppure no.

Per definire quali sono gli elementi che di default devono essere aperti nel workbench al caricamento, va usato il campo workbench che una volta per tutto il file json, permette di indicare gli id degli elementi da mettere nel workbench (ogni id è un elemento dell'array "workbench"); ad esempio:

"workbench": [
  "ttjh8y",
  "ySZw6F"
],

https://docs-v8.terria.io/guide/customizing/initialization-files/

Quali campi sono usati dalla ricerca nel catalogo?

name, id e descrizione

Il region mapping confronta i nomi dei campi in modo case-insensitive?

Si, cioè un carattere minuscolo è considerato uguale alla sua versione maiuscola, e vice versa.

Il region mapping permette che diverse definizioni usino chiavi con lo stesso nome (alias)?

No, ad esempio se la definizione di COMUNI usa come chiave il campo "ISTAT", non è possibile usare una chiave con lo stesso nome anche per la definizione di PROVINCE.

Quali sono gli alias attualmente attivi?

Località = LOC2011 Censimento = SEZ2011 Comuni (codice) = COMUNE, PRO_COM, PROCOM Comuni (nome) = PRO_COM_T, PROCOMT, ISTAT Province (codice) = COD_PROV, CODPROV Province (nome) = COD_PROV_T, CODPROV_T, ISTAT_PROV

È possibile disattivare il messaggio "Il dataset non è disponibile a questa scala" per layer specifici del catalogo?

Si, impostando per il layer specifico, nel catalogo, "hideLayerAfterMinScaleDenominator": false

È possibile mostrare il messaggio anche se si è troppo distanti?

Si, definendo un messaggio per il layer specifico, nel catalogo, il campo scaleZoomOut in scaleDatasetNotVisible

Quando, con lo Strumento di Misura, si aggiunge un punto, questo viene aggiunto sempre in coda alla linea o poligono?

Si.

Come mai nella legenda di un layer non si vedono tutti i simboli che erano stati definiti?

I simboli della legenda devono essere tutti diversi (anche eventualmente in modo impercettibile).

Come mai se uso il comando clean nell'url non vedo le mappe base?

Perchè il comando clean rimuove tutte le impostazioni definite nel file di catalogo di default e tra questi anche la definizione delle mappe base. Per ovviare a questo problema, dopo la clean va ricaricato il catalogo delle mappe base (di default o uno specifico).

Posso avere nei cataloghi più definizioni di layer con lo stesso id?

Se il campo type del layer è lo stesso è possibile, i campi dei layer vengono fusi e, in caso di sovrapposizioni, gli ultimi sovrascrivono i precedenti. Se invece i type sono differenti viene sollevato errore poichè non è possibile fondere layer con stesso id ma type differente (esempio wms vs esri-mapServer).

Come è calcolata l'area 3D restituita dallo "Misuratore ad aree"?

I passaggi, in sintesi, del calcolo dell'area 3D, sono:

  1. scomposizione del poligono in triangoli usando l'algoritmo di triangolazione riportato in http://www.geometrictools.com/Documentation/TriangulationByEarClipping.pdf
  2. calcolo dell'area dei triangoli con la formula di Erone;
  3. somma delle aree dei triangoli.

In uno spazio 3D i triangoli ottenuti hanno il vantaggio di trovarsi sempre su un piano, qualsiasi siano le coordinate. L'area ottenuta è maggiore (o uguale) di quella che si ottiene considerando il poligono come una figura 2D o proiettata perché si tiene conto delle diverse quote dei vertici del poligono. Gli unici dati necessari al calcolo sono le coordinate (x,y,z) dei punti che definiscono i poligoni.

Impostando il campo attribution di un layer di tipo ion-imagery nel catalogo non vedo effetti. Come devo fare?

Il campo va impostato direttamente nell'interfaccia di Cesium ION invece che nel catalogo.

Perchè il bottone Posizione sullo smartphone non da alcun effetto?

La prima volta che viene usata la funzione Posizione verrà chiesto all'utente di autorizzare l'uso del GPS. Per usare Posizione bisogna fornire l'autorizzazione, chiudere il browser e riaprirlo. Questa procedura è necessaria solo la prima volta che si usa la funzione.

Come posso attivare la ricerca anche tra i dati di un layer del catalogo?

Aggiungendo alla definizione del layer nel catalogo la proprietà nameOfCatalogItemSearchField tramite il quale specificare il nome del campo del layer da utilizzare per la ricerca. Il campo deve essere di tipo testuale. Questa funzionalità al momento è attiva soltanto per i layer di tipo GeoJSON e WFS.

Che tipo di layer è il i3s?

Si può modificare la dimensione della selezione del click puntuale sulla mappa per lo strumento informativo?

Si, modificando il valore di pickSize nel file config.json.

Si può modificare lo spessore di default di linee e polilinee rappresentate sulla mappa?

Si, tramite il parametro polylineWidth nel file config.json.

Come impostare quali visualizzatori di mappe presentare nel geoportale?

Usando il parametro mapViewers nel file config.json. Tale parametro vuole un array di visualizzatori, ad esempio: ["3d", "2d"].

Qual è il comando di riavvio del docker rer3d-map?

docker restart $(docker ps -a -q)

Posso fare collegamenti fra diversi file di catalogo?

Si, ecco la documentazione: https://docs.terria.io/guide/connecting-to-data/catalog-type-details/terria-reference/

Add a custom footer
Add a custom sidebar

Clone this wiki locally