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.
- Publiez vos fichiers en COPC (nuages de points) ou en COG (modèles raster), en accès libre.
- Décrivez-les dans un catalogue STAC, statique ou API, avec les métadonnées de cette page.
- Transmettez-nous l'adresse de votre catalogue.
Ce que vos données y gagnent
| Fonction | Où | Ce qu'il faut |
|---|---|---|
| Recherche par zone et par date | API STAC, QGIS, Python | bbox, geometry et datetime sur chaque item |
| Filtres : densité, résolution, rendu… | API, STAC Browser | Les propriétés du tableau des items |
| Carte des tuiles : sélection, téléchargement, taille totale | STAC Browser | bbox ; file:size pour les tailles |
| Nuage de points en 3D | Visualiseur 3D | Fichier COPC public, avec en-tête CORS |
| Modèle raster sur la carte | Visualiseur 3D, QGIS | Fichier COG public, avec en-tête CORS ; product:type et lidar:render |
| Chiffres de la collection : fichiers, années, points, volume | Partout | pc:count et file:size sur tous les items |
| Licence, producteur, mots-clés | Partout | Les métadonnées de vos collections |
1. Vos fichiers
| Nuages de points | Modèles raster | |
|---|---|---|
| Format | COPC (.copc.laz) | Cloud Optimized GeoTIFF (COG) |
| Contenu | Nuage de points lidar | Modèle numérique de terrain (MNT), de surface (MNS) ou de canopée (MNC), en altitudes ou en rendu (ombrage, pentes…) |
| Exigence | Pourquoi |
|---|---|
| HTTPS sans authentification, à une adresse publique | Les 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
| Forme | Adresse à nous transmettre | Liens à fournir |
|---|---|---|
| Catalogue statique | …/catalog.json | child vers les sous-catalogues et collections, item vers les items. |
| API STAC | Page d'accueil de l'API | child ou data vers /collections ; items sur chaque collection, next pour les pages suivantes ; search recommandé. |
- Une collection par produit et par acquisition (nuage de points 2024, MNT 2024…), sans autres données : une collection est reconnue d'après ses items.
- L'étendue temporelle de chaque collection est renseignée.
- La profondeur de l'arborescence est libre. Une collection atteinte par plusieurs chemins n'est publiée qu'une fois.
- Parties à ne pas publier (brouillons, tests) : indiquez-nous leurs identifiants.
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) :
| Produit | type de l'asset | product:type de l'item |
|---|---|---|
| Nuage de points | application/vnd.laszip+copc | – |
| Modèle de terrain | image/tiff; application=geotiff; profile=cloud-optimized | mnt (ou dtm) Obligatoire |
| Modèle de surface | mns (ou dsm) Obligatoire | |
| Modèle de canopée | mnc (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
| Champ | Niveau | Utilisation |
|---|---|---|
geometry et bbox, en WGS84 (longitude, latitude) | Obligatoire | Recherche par zone, carte des tuiles |
datetime, ou start_datetime et end_datetime | Obligatoire | Date d'acquisition, filtre par année |
Lien self absolu | Obligatoire | Lien vers votre item |
title | Recommandé | Nom affiché |
href absolus pour les assets | Recommandé | |
file:size (sur l'asset) | Recommandé | Taille des fichiers et des téléchargements |
proj:code, par exemple EPSG:2056 | Recommandé | Filtre Système de coordonnées |
mission | Recommandé | Filtre Mission |
Nuages de points : pc:count, pc:density, pc:type | Recommandé | 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:render | Recommandé | Filtre Type de rendu, affichage sur la carte (ci-dessous) |
stac_extensions | Recommandé | 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.
| Valeur | Rendu |
|---|---|
raw | Donnée brute : altitudes |
hillshade | Ombrage hillshade |
multidirectional-hillshade | Ombrage multidirectionnel |
ambient-occlusion | Occlusion ambiante / Sky view factor |
slope | Pentes |
slope-aspect | Orientation et pentes |
archaeology | Rendu archéologique (local relief model) |
color | Rendu coloré |
other | Autre 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
- Items : vos métadonnées, le fichier sous la clé
dataet un lien vers votre item. Les nuages de points ont un lien « Voir en 3D ». Un champ manquant est complété si possible (title,proj:codedepuisproj:epsg,gsdde l'asset). - Collections : leur description donne le nombre de fichiers, les années et, si tous vos items les déclarent, le nombre de points et le volume.
- Index des tuiles : un par collection de votre catalogue, sous son titre. Sur la carte d'une collection, on y sélectionne des tuiles, puis on télécharge leurs fichiers ou on les voit en 3D.
- Mises à jour : chaque nuit. Un fichier retiré de votre catalogue est retiré du nôtre. Si votre catalogue est inaccessible, votre dernière publication est conservée. L'état de chaque fournisseur figure dans le rapport de collecte.
6. Nous rejoindre
Vérifier votre catalogue
- Le
catalog.jsonou la page d'accueil de l'API répond en HTTPS, sans authentification. - Les fichiers sont en COPC ou en COG, à une adresse publique, répondent aux requêtes partielles et déclarent leur système de coordonnées.
- Chaque item a une
bboxen WGS84, une date et un lienselfabsolu. - Les modèles raster ont une propriété
product:type. - Le catalogue est valide.
# 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
- Envoyez aux responsables du catalogue le nom à afficher, l'adresse de votre catalogue et, si besoin, les parties à ne pas publier.
- Nous contrôlons votre catalogue et vous indiquons, par collection, si elle est reprise ou pourquoi elle ne l'est pas.
- Vos données sont publiées à la mise à jour suivante, puis chaque nuit.
| Message du contrôle | Correction |
|---|---|
LAZ/LAS non COPC | Convertir les fichiers en COPC |
TIFF non COG | Convertir les fichiers en COG |
COG sans product:type de modèle | Ajouter product:type (mnt, mns ou mnc) aux items |
archive zip | Publier les fichiers sans archive |
URL non publique | Servir les fichiers à une adresse publique |