---
operation_id: list_vegetation_datasets
method: GET
path: /v1/vegetation/datasets
summary: Vegetations-Datasets (CDSM/TDSM-COGs + Baum-/PlantCover-3D-Tiles)
tags: [vegetation]
stability: beta
since_version: 0.1.0
auth: none
data_product: vegetation
snapshot_aware: true
attribution_block: false
rate_limit_tier: public
related:
  - /v1/vegetation/canopy
  - /v1/terrain/elevation
  - /v1/osm-cover/datasets
---
# `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 Snapshot `2026-07-20` (be/he/ni) tragen die `plantcover`-b3dm ein per-Vertex-`COLOR_0` mit `hag` (Kronenhöhe über Grund) im `R`-Kanal und der Klassenfarbe in `G`/`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 **stille `COLOR_0`-Vertrag** (wie `R`/`G`/`B` zu lesen sind — Fade-Shader vs. reiner Vertex-Color-Renderer) steht in `04_engineering/pipelines/3d-tiles-feature-attributes.md#vegetations-layer--per-vertex-attribute-plantcover-b3dm`. Vor dem Konsum unbedingt gegen den `snapshot`-Wert prüfen. Das `trees`-Theme ist davon unberührt (kein `COLOR_0`).

> **Status: beta.** Nur veröffentlichte Datasets (`import_finished_at` gesetzt) erscheinen. `crs` + `tile_size_m` beschreiben das COG-Sampling-Grid.

## Wann verwenden

- Verschattungs-/Solar-/Wärme-Analysen: `cdsm`/`tdsm` als UMEP/SOLWEIG-Input.
- 3D-Visualizer, die Bäume + Bodenvegetation zu LoD2 + Gelände zeigen.
- Vor `GET /v1/vegetation/canopy` prüfen, welche BL live sind.

## Examples

### curl

```bash
curl -s https://api.lodapi.de/v1/vegetation/datasets \
  | jq '.datasets[] | {bl: .bundesland_code, crs, themes: [.themes[] | {name, kind, url}]}'
```

### Python-SDK

```python
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.