Catalogue LiDAR suisse

Publier vos données lidar

Le catalogue lit votre catalogue STAC chaque nuit et donne accès à vos fichiers là où ils sont, sans les copier. Cette page indique comment décrire vos données pour qu'elles profitent de toutes ses fonctions.

  1. Publiez vos fichiers en COPC (nuages de points) ou en COG (modèles raster), en accès libre.
  2. Décrivez-les dans un catalogue STAC, statique ou API, avec les métadonnées de cette page.
  3. Transmettez-nous l'adresse de votre catalogue.

Ce que vos données y gagnent

FonctionOùCe qu'il faut
Recherche par zone et par dateAPI STAC, QGIS, Pythonbbox, geometry et datetime sur chaque item
Filtres : densité, résolution, rendu…API, STAC BrowserLes propriétés du tableau des items
Carte des tuiles : sélection, téléchargement, taille totaleSTAC Browserbbox ; file:size pour les tailles
Nuage de points en 3DVisualiseur 3DFichier COPC public, avec en-tête CORS
Modèle raster sur la carteVisualiseur 3D, QGISFichier COG public, avec en-tête CORS ; product:type et lidar:render
Chiffres de la collection : fichiers, années, points, volumePartoutpc:count et file:size sur tous les items
Licence, producteur, mots-clésPartoutLes métadonnées de vos collections

1. Vos fichiers

Nuages de pointsModèles raster
FormatCOPC (.copc.laz)Cloud Optimized GeoTIFF (COG)
ContenuNuage de points lidarModèle numérique de terrain (MNT), de surface (MNS) ou de canopée (MNC), en altitudes ou en rendu (ombrage, pentes…)
ExigencePourquoi
HTTPS sans authentification, à une adresse publiqueLes outils lisent vos fichiers directement. Une adresse privée ou locale (http://10.0.0.1/…) n'est pas reprise.
Requêtes partielles (en-tête Range, réponse 206)Les outils ne lisent que la partie utile du fichier.
Système de coordonnées dans le fichier (WKT de l'en-tête COPC, géoréférencement du GeoTIFF)Sans lui, les outils ne peuvent ni découper ni reprojeter vos données.
En-tête CORS Access-Control-Allow-Origin: * RecommandéLes visualiseurs web, dont le visualiseur 3D, peuvent lire vos fichiers.

2. Votre catalogue

Cataloguecatalog.json ou API CollectionLiDAR 2024 – nuage de points CollectionLiDAR 2024 – MNT Itembbox, datetime, pc:density… Itembbox, datetime, product:type… 2546-1212.copc.lazsur votre serveur mnt-2024.tifsur votre serveur itemasset un item par fichier, une collection par produit et par acquisition
FormeAdresse à nous transmettreLiens à fournir
Catalogue statique…/catalog.jsonchild vers les sous-catalogues et collections, item vers les items.
API STACPage d'accueil de l'APIchild ou data vers /collections ; items sur chaque collection, next pour les pages suivantes ; search recommandé.

Noms de fichiers

Chaque item publié est nommé d'après son fichier : SITN_2022_2546-1212.copc.laz → sitn-2022-2546-1212. Des noms uniques et stables gardent les liens valables d'une mise à jour à l'autre.

3. Métadonnées

Déclarer vos fichiers

Chaque fichier est un asset de son item, avec son type de média (type) :

Produittype de l'assetproduct:type de l'item
Nuage de pointsapplication/vnd.laszip+copc–
Modèle de terrainimage/tiff; application=geotiff; profile=cloud-optimizedmnt (ou dtm) Obligatoire
Modèle de surfacemns (ou dsm) Obligatoire
Modèle de canopéemnc (ou dcm) Obligatoire

À défaut de type, un nom de fichier en .copc.laz ou en .cog.tif suffit. Sans product:type, un COG n'est pas repris : ce pourrait être une orthophoto. Sur une collection de modèles raster, déclarez aussi ses types dans summaries["product:type"].

Items

ChampNiveauUtilisation
geometry et bbox, en WGS84 (longitude, latitude)ObligatoireRecherche par zone, carte des tuiles
datetime, ou start_datetime et end_datetimeObligatoireDate d'acquisition, filtre par année
Lien self absoluObligatoireLien vers votre item
titleRecommandéNom affiché
href absolus pour les assetsRecommandé
file:size (sur l'asset)RecommandéTaille des fichiers et des téléchargements
proj:code, par exemple EPSG:2056RecommandéFiltre Système de coordonnées
missionRecommandéFiltre Mission
Nuages de points : pc:count, pc:density, pc:typeRecommandéFiltres Nombre de points, Densité (points/m²), Type de nuage de points
Nuages de points : pc:schemas, classification:classes (sur l'asset)RecommandéDescription des attributs et des classes
Modèles raster : gsd (résolution en mètres)RecommandéFiltre Résolution (m)
Modèles raster : lidar:renderRecommandéFiltre Type de rendu, affichage sur la carte (ci-dessous)
stac_extensionsRecommandéChaque extension utilisée y est déclarée

Extensions : Projection, Pointcloud, Classification, Product, File. Liste des filtres : /queryables.

Modèles raster : type de rendu

Indiquez dans lidar:render ce que contient le fichier. Le visualiseur étire les altitudes (raw) et affiche les rendus tels quels.

ValeurRendu
rawDonnée brute : altitudes
hillshadeOmbrage hillshade
multidirectional-hillshadeOmbrage multidirectionnel
ambient-occlusionOcclusion ambiante / Sky view factor
slopePentes
slope-aspectOrientation et pentes
archaeologyRendu archéologique (local relief model)
colorRendu coloré
otherAutre rendu

Sans lidar:render, le rendu est déduit du titre ou du nom du fichier (« hillshade », « ombrage », « slope »…), sinon raw (other si toutes ses bandes sont en 8 bits).

Collections

Renseignez title, description, extent, license (identifiant SPDX, ou other avec un lien license), providers et keywords. Licence, fournisseurs et mots-clés sont repris tels quels.

4. Exemple

Un catalogue statique minimal :

catalog.json                     liens child → lidar2024/collection.json
lidar2024/collection.json        liens item  → tuile-2546-1212.json
lidar2024/tuile-2546-1212.json

Un item de nuage de points :

{
  "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": "tuile-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": "Tuile 2546-1212",
    "proj:code": "EPSG:2056",
    "pc:type": "lidar",
    "pc:count": 31250000,
    "pc:density": 25.0
  },
  "links": [
    { "rel": "self", "href": "https://exemple.ch/stac/lidar2024/tuile-2546-1212.json" }
  ],
  "assets": {
    "data": {
      "href": "https://exemple.ch/data/lidar2024/2546-1212.copc.laz",
      "type": "application/vnd.laszip+copc",
      "roles": ["data"],
      "file:size": 401234567
    }
  }
}

Pour un modèle raster, seuls changent les propriétés et 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://exemple.ch/data/lidar2024/mnt-2024.tif",
    "type": "image/tiff; application=geotiff; profile=cloud-optimized",
    "roles": ["data"]
  }
}

5. Ce que nous publions

<Nom>                          collection à votre nom
├── <Nom> – Nuage de points    un item par fichier COPC
└── <Nom> – Modèles raster     un item par fichier COG

6. Nous rejoindre

Vérifier votre catalogue

# Requêtes partielles : la réponse doit être « 206 Partial Content »
curl -sI -H "Range: bytes=0-99" https://exemple.ch/data/lidar2024/2546-1212.copc.laz

# Validation du catalogue
pip install stac-validator
stac-validator https://exemple.ch/stac/catalog.json --recursive

Nous transmettre votre catalogue

  1. Envoyez aux responsables du catalogue le nom à afficher, l'adresse de votre catalogue et, si besoin, les parties à ne pas publier.
  2. Nous contrôlons votre catalogue et vous indiquons, par collection, si elle est reprise ou pourquoi elle ne l'est pas.
  3. Vos données sont publiées à la mise à jour suivante, puis chaque nuit.
Message du contrôleCorrection
LAZ/LAS non COPCConvertir les fichiers en COPC
TIFF non COGConvertir les fichiers en COG
COG sans product:type de modèleAjouter product:type (mnt, mns ou mnc) aux items
archive zipPublier les fichiers sans archive
URL non publiqueServir les fichiers à une adresse publique