Ihre Lidardaten veröffentlichen
Der Katalog liest Ihren STAC-Katalog jede Nacht und macht Ihre Dateien dort zugänglich, wo sie liegen, ohne sie zu kopieren. Diese Seite zeigt, wie Sie Ihre Daten beschreiben, damit sie alle seine Funktionen nutzen.
- Veröffentlichen Sie Ihre Dateien als COPC (Punktwolken) oder COG (Rastermodelle), frei zugänglich.
- Beschreiben Sie sie in einem STAC-Katalog, statisch oder als API, mit den Metadaten dieser Seite.
- Teilen Sie uns die Adresse Ihres Katalogs mit.
Was Ihre Daten davon haben
| Funktion | Wo | Was es braucht |
|---|---|---|
| Suche nach Gebiet und Datum | STAC-API, QGIS, Python | bbox, geometry und datetime in jedem Item |
| Filter: Dichte, Auflösung, Darstellung… | API, STAC Browser | Die Properties der Item-Tabelle |
| Kachelkarte: Auswahl, Download, Gesamtgrösse | STAC Browser | bbox; file:size für die Grössen |
| Punktwolke in 3D | 3D-Viewer | Öffentliche COPC-Datei mit CORS-Header |
| Rastermodell auf der Karte | 3D-Viewer, QGIS | Öffentliche COG-Datei mit CORS-Header; product:type und lidar:render |
| Kennzahlen der Collection: Dateien, Jahre, Punkte, Volumen | Überall | pc:count und file:size in allen Items |
| Lizenz, Produzent, Schlüsselwörter | Überall | Die Metadaten Ihrer Collections |
1. Ihre Dateien
| Punktwolken | Rastermodelle | |
|---|---|---|
| Format | COPC (.copc.laz) | Cloud Optimized GeoTIFF (COG) |
| Inhalt | Lidar-Punktwolke | Digitales Terrain- (DTM), Oberflächen- (DOM) oder Vegetationsmodell (DVM), als Höhen oder als Darstellung (Schummerung, Neigung…) |
| Anforderung | Grund |
|---|---|
| HTTPS ohne Authentifizierung, unter einer öffentlichen Adresse | Die Werkzeuge lesen Ihre Dateien direkt. Eine private oder lokale Adresse (http://10.0.0.1/…) wird nicht übernommen. |
Teilabfragen (Header Range, Antwort 206) | Die Werkzeuge lesen nur den benötigten Teil der Datei. |
| Koordinatensystem in der Datei (WKT im COPC-Header, Georeferenzierung des GeoTIFF) | Ohne Koordinatensystem können die Werkzeuge Ihre Daten weder zuschneiden noch umprojizieren. |
CORS-Header Access-Control-Allow-Origin: * Empfohlen | Web-Viewer, darunter der 3D-Viewer, können Ihre Dateien lesen. |
2. Ihr Katalog
| Form | Adresse, die Sie uns mitteilen | Bereitzustellende Links |
|---|---|---|
| Statischer Katalog | …/catalog.json | child zu Unterkatalogen und Collections, item zu den Items. |
| STAC-API | Startseite der API | child oder data zu /collections; items in jeder Collection, next für die folgenden Seiten; search empfohlen. |
- Eine Collection pro Produkt und Erfassung (Punktwolke 2024, DTM 2024…), ohne andere Daten: Eine Collection wird anhand ihrer Items erkannt.
- Die zeitliche Ausdehnung jeder Collection ist angegeben.
- Die Tiefe der Struktur ist frei. Eine Collection, die über mehrere Wege erreichbar ist, wird nur einmal veröffentlicht.
- Teile, die nicht veröffentlicht werden sollen (Entwürfe, Tests): Nennen Sie uns ihre Kennungen.
Dateinamen
Jedes veröffentlichte Item wird nach seiner Datei benannt: SITN_2022_2546-1212.copc.laz → sitn-2022-2546-1212.
Mit eindeutigen und stabilen Namen bleiben die Links von einer Aktualisierung zur nächsten gültig.
3. Metadaten
Ihre Dateien deklarieren
Jede Datei ist ein Asset ihres Items, mit ihrem Medientyp (type):
| Produkt | type des Assets | product:type des Items |
|---|---|---|
| Punktwolke | application/vnd.laszip+copc | – |
| Terrainmodell | image/tiff; application=geotiff; profile=cloud-optimized | mnt (oder dtm) Pflicht |
| Oberflächenmodell | mns (oder dsm) Pflicht | |
| Vegetationsmodell | mnc (oder dcm) Pflicht |
Fehlt type, genügt ein Dateiname auf .copc.laz oder .cog.tif. Ohne product:type wird ein COG nicht übernommen: Es könnte ein Orthofoto sein.
Geben Sie bei einer Collection von Rastermodellen auch deren Typen in summaries["product:type"] an.
Items
| Feld | Stufe | Verwendung |
|---|---|---|
geometry und bbox, in WGS84 (Länge, Breite) | Pflicht | Suche nach Gebiet, Kachelkarte |
datetime, oder start_datetime und end_datetime | Pflicht | Erfassungsdatum, Filter nach Jahr |
Absoluter self-Link | Pflicht | Link zu Ihrem Item |
title | Empfohlen | Angezeigter Name |
Absolute href für die Assets | Empfohlen | |
file:size (im Asset) | Empfohlen | Grösse der Dateien und Downloads |
proj:code, zum Beispiel EPSG:2056 | Empfohlen | Filter Système de coordonnées |
mission | Empfohlen | Filter Mission |
Punktwolken: pc:count, pc:density, pc:type | Empfohlen | Filter Nombre de points, Densité (points/m²), Type de nuage de points |
Punktwolken: pc:schemas, classification:classes (im Asset) | Empfohlen | Beschreibung der Attribute und Klassen |
Rastermodelle: gsd (Auflösung in Metern) | Empfohlen | Filter Résolution (m) |
Rastermodelle: lidar:render | Empfohlen | Filter Type de rendu, Anzeige auf der Karte (siehe unten) |
stac_extensions | Empfohlen | Jede verwendete Extension ist dort deklariert |
Extensions: Projection, Pointcloud,
Classification, Product,
File. Liste der Filter: /queryables.
Rastermodelle: Darstellungstyp
Geben Sie in lidar:render an, was die Datei enthält. Der Viewer streckt die Höhen (raw) und zeigt Darstellungen unverändert an.
| Wert | Darstellung |
|---|---|
raw | Rohdaten: Höhen |
hillshade | Schummerung |
multidirectional-hillshade | Mehrfachschummerung |
ambient-occlusion | Ambient Occlusion / Sky-View-Faktor |
slope | Neigung |
slope-aspect | Exposition und Neigung |
archaeology | Archäologische Darstellung (Local Relief Model) |
color | Farbige Darstellung |
other | Andere Darstellung |
Ohne lidar:render wird die Darstellung aus dem Titel oder dem Dateinamen abgeleitet («hillshade», «ombrage», «slope»…), sonst raw (other, wenn alle Bänder 8 Bit haben).
Collections
Geben Sie title, description, extent, license (SPDX-Kennung, oder other mit einem license-Link),
providers und keywords an. Lizenz, Anbieter und Schlüsselwörter werden unverändert übernommen.
4. Beispiel
Ein minimaler statischer Katalog:
catalog.json Links child → lidar2024/collection.json
lidar2024/collection.json Links item → kachel-2546-1212.json
lidar2024/kachel-2546-1212.json
Ein Punktwolken-Item:
{
"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": "kachel-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": "Kachel 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/kachel-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
}
}
}
Bei einem Rastermodell ändern sich nur die Properties und das 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/dtm-2024.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": ["data"]
}
}
5. Was wir veröffentlichen
<Name> Collection unter Ihrem Namen
├── <Name> – Nuage de points ein Item pro COPC-Datei
└── <Name> – Modèles raster ein Item pro COG-Datei
- Items: Ihre Metadaten, die Datei unter dem Schlüssel
dataund ein Link zu Ihrem Item. Punktwolken haben einen Link «Voir en 3D». Ein fehlendes Feld wird wenn möglich ergänzt (title,proj:codeausproj:epsg,gsdaus dem Asset). - Collections: Ihre Beschreibung nennt die Anzahl Dateien, die Jahre und, wenn alle Ihre Items sie angeben, die Anzahl Punkte und das Volumen.
- Kachelindex: einer pro Collection Ihres Katalogs, unter deren Titel. Auf der Karte einer Collection wählt man darin Kacheln aus und lädt dann deren Dateien herunter oder sieht sie in 3D an.
- Aktualisierungen: jede Nacht. Eine aus Ihrem Katalog entfernte Datei wird auch aus unserem entfernt. Ist Ihr Katalog nicht erreichbar, bleibt Ihre letzte Veröffentlichung erhalten. Der Status jedes Anbieters steht im Erfassungsbericht.
6. Mitmachen
Ihren Katalog prüfen
- Die
catalog.jsonoder die Startseite der API antwortet über HTTPS, ohne Authentifizierung. - Die Dateien sind COPC oder COG, unter einer öffentlichen Adresse, beantworten Teilabfragen und deklarieren ihr Koordinatensystem.
- Jedes Item hat eine
bboxin WGS84, ein Datum und einen absolutenself-Link. - Die Rastermodelle haben eine Property
product:type. - Der Katalog ist gültig.
# Teilabfragen: Die Antwort muss «206 Partial Content» sein
curl -sI -H "Range: bytes=0-99" https://example.ch/data/lidar2024/2546-1212.copc.laz
# Validierung des Katalogs
pip install stac-validator
stac-validator https://example.ch/stac/catalog.json --recursive
Uns Ihren Katalog mitteilen
- Senden Sie den Verantwortlichen des Katalogs den anzuzeigenden Namen, die Adresse Ihres Katalogs und, falls nötig, die nicht zu veröffentlichenden Teile.
- Wir prüfen Ihren Katalog und teilen Ihnen pro Collection mit, ob sie übernommen wird oder weshalb nicht.
- Ihre Daten werden bei der nächsten Aktualisierung veröffentlicht, danach jede Nacht.
| Meldung der Prüfung | Korrektur |
|---|---|
LAZ/LAS non COPC | Die Dateien in COPC umwandeln |
TIFF non COG | Die Dateien in COG umwandeln |
COG sans product:type de modèle | product:type (mnt, mns oder mnc) zu den Items hinzufügen |
archive zip | Die Dateien ohne Archiv veröffentlichen |
URL non publique | Die Dateien unter einer öffentlichen Adresse bereitstellen |