Pubblicare i Suoi dati lidar
Il catalogo legge ogni notte il Suo catalogo STAC e dà accesso ai Suoi file là dove si trovano, senza copiarli. Questa pagina indica come descrivere i Suoi dati affinché sfruttino tutte le sue funzioni.
- Pubblichi i Suoi file in COPC (nuvole di punti) o in COG (modelli raster), ad accesso libero.
- Li descriva in un catalogo STAC, statico o API, con i metadati di questa pagina.
- Ci trasmetta l'indirizzo del Suo catalogo.
Che cosa ottengono i Suoi dati
| Funzione | Dove | Che cosa serve |
|---|---|---|
| Ricerca per zona e per data | API STAC, QGIS, Python | bbox, geometry e datetime su ogni item |
| Filtri: densità, risoluzione, rendering… | API, STAC Browser | Le proprietà della tabella degli item |
| Mappa delle tessere: selezione, download, dimensione totale | STAC Browser | bbox; file:size per le dimensioni |
| Nuvola di punti in 3D | Visualizzatore 3D | File COPC pubblico, con intestazione CORS |
| Modello raster sulla mappa | Visualizzatore 3D, QGIS | File COG pubblico, con intestazione CORS; product:type e lidar:render |
| Cifre della collezione: file, anni, punti, volume | Ovunque | pc:count e file:size su tutti gli item |
| Licenza, produttore, parole chiave | Ovunque | I metadati delle Sue collezioni |
1. I Suoi file
| Nuvole di punti | Modelli raster | |
|---|---|---|
| Formato | COPC (.copc.laz) | Cloud Optimized GeoTIFF (COG) |
| Contenuto | Nuvola di punti lidar | Modello digitale del terreno (MNT), della superficie (MNS) o della chioma (MNC), in altitudini o come rendering (ombreggiatura, pendenze…) |
| Requisito | Motivo |
|---|---|
| HTTPS senza autenticazione, a un indirizzo pubblico | Gli strumenti leggono direttamente i Suoi file. Un indirizzo privato o locale (http://10.0.0.1/…) non è ripreso. |
Richieste parziali (intestazione Range, risposta 206) | Gli strumenti leggono solo la parte utile del file. |
| Sistema di coordinate nel file (WKT dell'intestazione COPC, georeferenziazione del GeoTIFF) | Senza di esso, gli strumenti non possono né ritagliare né riproiettare i Suoi dati. |
Intestazione CORS Access-Control-Allow-Origin: * Raccomandato | I visualizzatori web, tra cui il visualizzatore 3D, possono leggere i Suoi file. |
2. Il Suo catalogo
| Forma | Indirizzo da trasmetterci | Link da fornire |
|---|---|---|
| Catalogo statico | …/catalog.json | child verso i sottocataloghi e le collezioni, item verso gli item. |
| API STAC | Pagina iniziale dell'API | child o data verso /collections; items su ogni collezione, next per le pagine seguenti; search raccomandato. |
- Una collezione per prodotto e per acquisizione (nuvola di punti 2024, MNT 2024…), senza altri dati: una collezione è riconosciuta in base ai suoi item.
- L'estensione temporale di ogni collezione è indicata.
- La profondità della struttura è libera. Una collezione raggiunta da più percorsi è pubblicata una sola volta.
- Parti da non pubblicare (bozze, test): ci indichi i loro identificatori.
Nomi dei file
Ogni item pubblicato prende il nome del suo file: SITN_2022_2546-1212.copc.laz → sitn-2022-2546-1212.
Nomi univoci e stabili mantengono validi i link da un aggiornamento all'altro.
3. Metadati
Dichiarare i Suoi file
Ogni file è un asset del suo item, con il suo tipo di media (type):
| Prodotto | type dell'asset | product:type dell'item |
|---|---|---|
| Nuvola di punti | application/vnd.laszip+copc | – |
| Modello del terreno | image/tiff; application=geotiff; profile=cloud-optimized | mnt (o dtm) Obbligatorio |
| Modello della superficie | mns (o dsm) Obbligatorio | |
| Modello della chioma | mnc (o dcm) Obbligatorio |
In mancanza di type, basta un nome di file che termina con .copc.laz o .cog.tif. Senza product:type, un COG non è ripreso: potrebbe essere un'ortofoto.
Su una collezione di modelli raster, dichiari anche i suoi tipi in summaries["product:type"].
Item
| Campo | Livello | Utilizzo |
|---|---|---|
geometry e bbox, in WGS84 (longitudine, latitudine) | Obbligatorio | Ricerca per zona, mappa delle tessere |
datetime, o start_datetime e end_datetime | Obbligatorio | Data di acquisizione, filtro per anno |
Link self assoluto | Obbligatorio | Link verso il Suo item |
title | Raccomandato | Nome visualizzato |
href assoluti per gli asset | Raccomandato | |
file:size (sull'asset) | Raccomandato | Dimensione dei file e dei download |
proj:code, per esempio EPSG:2056 | Raccomandato | Filtro Système de coordonnées |
mission | Raccomandato | Filtro Mission |
Nuvole di punti: pc:count, pc:density, pc:type | Raccomandato | Filtri Nombre de points, Densité (points/m²), Type de nuage de points |
Nuvole di punti: pc:schemas, classification:classes (sull'asset) | Raccomandato | Descrizione degli attributi e delle classi |
Modelli raster: gsd (risoluzione in metri) | Raccomandato | Filtro Résolution (m) |
Modelli raster: lidar:render | Raccomandato | Filtro Type de rendu, visualizzazione sulla mappa (vedi sotto) |
stac_extensions | Raccomandato | Vi è dichiarata ogni estensione utilizzata |
Estensioni: Projection, Pointcloud,
Classification, Product,
File. Elenco dei filtri: /queryables.
Modelli raster: tipo di rendering
Indichi in lidar:render che cosa contiene il file. Il visualizzatore adatta la scala dei colori alle altitudini (raw) e mostra i rendering tali e quali.
| Valore | Rendering |
|---|---|
raw | Dato grezzo: altitudini |
hillshade | Ombreggiatura (hillshade) |
multidirectional-hillshade | Ombreggiatura multidirezionale |
ambient-occlusion | Occlusione ambientale / Sky view factor |
slope | Pendenze |
slope-aspect | Esposizione e pendenze |
archaeology | Rendering archeologico (local relief model) |
color | Rendering a colori |
other | Altro rendering |
Senza lidar:render, il rendering è dedotto dal titolo o dal nome del file («hillshade», «ombrage», «slope»…), altrimenti raw (other se tutte le sue bande sono a 8 bit).
Collezioni
Indichi title, description, extent, license (identificatore SPDX, o other con un link license),
providers e keywords. Licenza, fornitori e parole chiave sono ripresi tali e quali.
4. Esempio
Un catalogo statico minimo:
catalog.json link child → lidar2024/collection.json
lidar2024/collection.json link item → tessera-2546-1212.json
lidar2024/tessera-2546-1212.json
Un item di nuvola di punti:
{
"type": "Feature",
"stac_version": "1.1.0",
"stac_extensions": [
"https://stac-extensions.github.io/pointcloud/v2.0.0/schema.json",
"https://stac-extensions.github.io/projection/v2.0.0/schema.json",
"https://stac-extensions.github.io/file/v2.1.0/schema.json"
],
"id": "tessera-2546-1212",
"geometry": { "type": "Polygon", "coordinates": [[[6.94, 46.99], [6.96, 46.99], [6.96, 47.00], [6.94, 47.00], [6.94, 46.99]]] },
"bbox": [6.94, 46.99, 6.96, 47.00],
"properties": {
"datetime": "2024-04-15T00:00:00Z",
"title": "Tessera 2546-1212",
"proj:code": "EPSG:2056",
"pc:type": "lidar",
"pc:count": 31250000,
"pc:density": 25.0
},
"links": [
{ "rel": "self", "href": "https://example.ch/stac/lidar2024/tessera-2546-1212.json" }
],
"assets": {
"data": {
"href": "https://example.ch/data/lidar2024/2546-1212.copc.laz",
"type": "application/vnd.laszip+copc",
"roles": ["data"],
"file:size": 401234567
}
}
}
Per un modello raster, cambiano solo le proprietà e l'asset:
"properties": { "datetime": "2024-04-15T00:00:00Z", "product:type": "mnt", "lidar:render": "raw", "gsd": 0.5, "proj:code": "EPSG:2056" },
"assets": {
"data": {
"href": "https://example.ch/data/lidar2024/mnt-2024.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": ["data"]
}
}
5. Che cosa pubblichiamo
<Nome> collezione a Suo nome
├── <Nome> – Nuage de points un item per file COPC
└── <Nome> – Modèles raster un item per file COG
- Item: i Suoi metadati, il file sotto la chiave
datae un link verso il Suo item. Le nuvole di punti hanno un link «Voir en 3D». Un campo mancante è completato se possibile (title,proj:codedaproj:epsg,gsddell'asset). - Collezioni: la loro descrizione indica il numero di file, gli anni e, se tutti i Suoi item li dichiarano, il numero di punti e il volume.
- Indice delle tessere: uno per collezione del Suo catalogo, con il suo titolo. Sulla mappa di una collezione vi si selezionano delle tessere, poi se ne scaricano i file o li si visualizza in 3D.
- Aggiornamenti: ogni notte. Un file rimosso dal Suo catalogo è rimosso dal nostro. Se il Suo catalogo non è raggiungibile, la Sua ultima pubblicazione è mantenuta. Lo stato di ogni fornitore figura nel rapporto di raccolta.
6. Aderire al catalogo
Verificare il Suo catalogo
- Il
catalog.jsono la pagina iniziale dell'API risponde in HTTPS, senza autenticazione. - I file sono in COPC o in COG, a un indirizzo pubblico, rispondono alle richieste parziali e dichiarano il loro sistema di coordinate.
- Ogni item ha un
bboxin WGS84, una data e un linkselfassoluto. - I modelli raster hanno una proprietà
product:type. - Il catalogo è valido.
# Richieste parziali: la risposta deve essere «206 Partial Content»
curl -sI -H "Range: bytes=0-99" https://example.ch/data/lidar2024/2546-1212.copc.laz
# Validazione del catalogo
pip install stac-validator
stac-validator https://example.ch/stac/catalog.json --recursive
Trasmetterci il Suo catalogo
- Invii ai responsabili del catalogo il nome da visualizzare, l'indirizzo del Suo catalogo e, se necessario, le parti da non pubblicare.
- Controlliamo il Suo catalogo e Le indichiamo, per collezione, se è ripresa o perché non lo è.
- I Suoi dati sono pubblicati all'aggiornamento successivo, poi ogni notte.
| Messaggio del controllo | Correzione |
|---|---|
LAZ/LAS non COPC | Convertire i file in COPC |
TIFF non COG | Convertire i file in COG |
COG sans product:type de modèle | Aggiungere product:type (mnt, mns o mnc) agli item |
archive zip | Pubblicare i file senza archivio |
URL non publique | Servire i file a un indirizzo pubblico |