Catalogo LiDAR svizzero

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.

  1. Pubblichi i Suoi file in COPC (nuvole di punti) o in COG (modelli raster), ad accesso libero.
  2. Li descriva in un catalogo STAC, statico o API, con i metadati di questa pagina.
  3. Ci trasmetta l'indirizzo del Suo catalogo.

Che cosa ottengono i Suoi dati

FunzioneDoveChe cosa serve
Ricerca per zona e per dataAPI STAC, QGIS, Pythonbbox, geometry e datetime su ogni item
Filtri: densità, risoluzione, rendering…API, STAC BrowserLe proprietà della tabella degli item
Mappa delle tessere: selezione, download, dimensione totaleSTAC Browserbbox; file:size per le dimensioni
Nuvola di punti in 3DVisualizzatore 3DFile COPC pubblico, con intestazione CORS
Modello raster sulla mappaVisualizzatore 3D, QGISFile COG pubblico, con intestazione CORS; product:type e lidar:render
Cifre della collezione: file, anni, punti, volumeOvunquepc:count e file:size su tutti gli item
Licenza, produttore, parole chiaveOvunqueI metadati delle Sue collezioni

1. I Suoi file

Nuvole di puntiModelli raster
FormatoCOPC (.copc.laz)Cloud Optimized GeoTIFF (COG)
ContenutoNuvola di punti lidarModello digitale del terreno (MNT), della superficie (MNS) o della chioma (MNC), in altitudini o come rendering (ombreggiatura, pendenze…)
RequisitoMotivo
HTTPS senza autenticazione, a un indirizzo pubblicoGli 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: * RaccomandatoI visualizzatori web, tra cui il visualizzatore 3D, possono leggere i Suoi file.

2. Il Suo catalogo

Catalogocatalog.json o API CollezioneLiDAR 2024 – nuvola di punti CollezioneLiDAR 2024 – MNT Itembbox, datetime, pc:density… Itembbox, datetime, product:type… 2546-1212.copc.lazsul Suo server mnt-2024.tifsul Suo server itemasset un item per file, una collezione per prodotto e per acquisizione
FormaIndirizzo da trasmetterciLink da fornire
Catalogo statico…/catalog.jsonchild verso i sottocataloghi e le collezioni, item verso gli item.
API STACPagina iniziale dell'APIchild o data verso /collections; items su ogni collezione, next per le pagine seguenti; search raccomandato.

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):

Prodottotype dell'assetproduct:type dell'item
Nuvola di puntiapplication/vnd.laszip+copc–
Modello del terrenoimage/tiff; application=geotiff; profile=cloud-optimizedmnt (o dtm) Obbligatorio
Modello della superficiemns (o dsm) Obbligatorio
Modello della chiomamnc (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

CampoLivelloUtilizzo
geometry e bbox, in WGS84 (longitudine, latitudine)ObbligatorioRicerca per zona, mappa delle tessere
datetime, o start_datetime e end_datetimeObbligatorioData di acquisizione, filtro per anno
Link self assolutoObbligatorioLink verso il Suo item
titleRaccomandatoNome visualizzato
href assoluti per gli assetRaccomandato
file:size (sull'asset)RaccomandatoDimensione dei file e dei download
proj:code, per esempio EPSG:2056RaccomandatoFiltro Système de coordonnées
missionRaccomandatoFiltro Mission
Nuvole di punti: pc:count, pc:density, pc:typeRaccomandatoFiltri Nombre de points, Densité (points/m²), Type de nuage de points
Nuvole di punti: pc:schemas, classification:classes (sull'asset)RaccomandatoDescrizione degli attributi e delle classi
Modelli raster: gsd (risoluzione in metri)RaccomandatoFiltro Résolution (m)
Modelli raster: lidar:renderRaccomandatoFiltro Type de rendu, visualizzazione sulla mappa (vedi sotto)
stac_extensionsRaccomandatoVi è 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.

ValoreRendering
rawDato grezzo: altitudini
hillshadeOmbreggiatura (hillshade)
multidirectional-hillshadeOmbreggiatura multidirezionale
ambient-occlusionOcclusione ambientale / Sky view factor
slopePendenze
slope-aspectEsposizione e pendenze
archaeologyRendering archeologico (local relief model)
colorRendering a colori
otherAltro 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

6. Aderire al catalogo

Verificare il Suo catalogo

# 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

  1. Invii ai responsabili del catalogo il nome da visualizzare, l'indirizzo del Suo catalogo e, se necessario, le parti da non pubblicare.
  2. Controlliamo il Suo catalogo e Le indichiamo, per collezione, se è ripresa o perché non lo è.
  3. I Suoi dati sono pubblicati all'aggiornamento successivo, poi ogni notte.
Messaggio del controlloCorrezione
LAZ/LAS non COPCConvertire i file in COPC
TIFF non COGConvertire i file in COG
COG sans product:type de modèleAggiungere product:type (mnt, mns o mnc) agli item
archive zipPubblicare i file senza archivio
URL non publiqueServire i file a un indirizzo pubblico