GET /v1/vegetation/datasets — Vegetations-Datasets
Discovery-Endpoint für den Vegetations-Layer (ADR-0020): aus dem nDOM (DOM − DGM1) abgeleitete Vegetation in vier Themes. Pro Bundesland der jüngste Snapshot.
Jedes Dataset bündelt vier Themes mit unterschiedlicher Natur:
| Theme | kind | Inhalt | url zeigt auf |
|---|---|---|---|
cdsm | raster_cog | Canopy-DSM — Vegetationshöhe über Grund (gebäudemaskiert, ≥ 2 m) | COG-Verzeichnis-Base (Sampling-Quelle) |
tdsm | raster_cog | Trunk-Zone-DSM — Kronenunterkante (25 % der Kronenhöhe) | COG-Verzeichnis-Base |
trees | 3dtiles | Einzelbaum-Instanzen (SolitaryVegetationObject, glTF + EXT_mesh_gpu_instancing) | tileset.json |
plantcover | 3dtiles | Rest-Vegetation als trianguliertes Mesh (PlantCover, RTIN + Draco) | tileset.json |
Die Raster-Themes (cdsm/tdsm) sind die Quelle für GET /v1/vegetation/canopy. Die 3D-Tiles-Themes (trees/plantcover) lädt ein Viewer direkt (Cesium, three.js 3d-tiles-renderer). Alle Artefakte werden statisch von Caddy unter tiles.lodapi.de/veg/<bl>/<snapshot>/<theme>/ ausgeliefert.
plantcover-Format ist snapshot-abhängig. Ab Snapshot2026-07-20(be/he/ni) tragen dieplantcover-b3dm ein per-Vertex-COLOR_0mithag(Kronenhöhe über Grund) imR-Kanal und der Klassenfarbe inG/B, gehärtete E3-Mesh-Rezeptur (Vorhang-Anteil 0 %) und eine amtliche Brückenmaske (ADR-0022/0023). Ältere Snapshots (2026-07-16,2021-*) tragen keins davon. Der stilleCOLOR_0-Vertrag (wieR/G/Bzu lesen sind — Fade-Shader vs. reiner Vertex-Color-Renderer) steht in04_engineering/pipelines/3d-tiles-feature-attributes.md#vegetations-layer--per-vertex-attribute-plantcover-b3dm. Vor dem Konsum unbedingt gegen densnapshot-Wert prüfen. Dastrees-Theme ist davon unberührt (keinCOLOR_0).
Status: beta. Nur veröffentlichte Datasets (
import_finished_atgesetzt) erscheinen.crs+tile_size_mbeschreiben das COG-Sampling-Grid.
Wann verwenden
- Verschattungs-/Solar-/Wärme-Analysen:
cdsm/tdsmals UMEP/SOLWEIG-Input. - 3D-Visualizer, die Bäume + Bodenvegetation zu LoD2 + Gelände zeigen.
- Vor
GET /v1/vegetation/canopyprüfen, welche BL live sind.
Examples
curl
curl -s https://api.lodapi.de/v1/vegetation/datasets \
| jq '.datasets[] | {bl: .bundesland_code, crs, themes: [.themes[] | {name, kind, url}]}'Python-SDK
from lodapi import Client
c = Client()
for ds in c.vegetation.datasets().datasets:
print(ds.bundesland_code, ds.crs, [(t.name, t.kind) for t in ds.themes])Attribution
Lizenz je Dataset (license). Berlin-DOM ist DL-DE Zero — keine Attributionspflicht. Andere BL pro Quelle prüfen.