# Lodapi

> Aggregierte LoD2-Gebäude- und DGM1-Terrain-API für alle 16 deutschen Bundesländer. OGC-API-Features-kompatibel, 3D-Tiles 1.1, glTF 2.0. Eine API ersetzt 16 föderale Connector-Pfade + 3 Lizenz-Dialekte.

Basis-URLs:
- API: https://api.lodapi.de
- Docs: https://lodapi.de/docs
- OpenAPI: https://api.lodapi.de/openapi.json (live), https://lodapi.de/openapi.json (Snapshot)
- Discovery-Manifest: https://lodapi.de/.well-known/lodapi.json

## API-Endpoints

### admin

- [GET /v1/admin/usage/anonymous](https://lodapi.de/docs/endpoints/admin-anonymous-usage.md): Keyless / free-tier usage report (api_key_id IS NULL)
- [GET /v1/admin/api-keys/{api_key_id}/usage](https://lodapi.de/docs/endpoints/admin-api-key-usage.md): Per-key monthly usage report (Concierge-Billing-MVP)
- [POST /v1/admin/api-keys](https://lodapi.de/docs/endpoints/admin-create-api-key.md): Mint a new customer API key (Concierge-Billing-MVP)
- [GET /v1/admin/data-freshness](https://lodapi.de/docs/endpoints/admin-data-freshness.md): Pro-BL Daten-Aktualitätsstatus (last_sync, snapshot_date, drift_days)
- [GET /v1/admin/health](https://lodapi.de/docs/endpoints/admin-health.md): Admin-Health-Check (DB-Reachability, Pool-Auslastung, Last-Pipeline-Run)
- [GET /v1/admin/api-keys](https://lodapi.de/docs/endpoints/admin-list-api-keys.md): List customer API keys
- [GET /v1/admin/pipeline-runs](https://lodapi.de/docs/endpoints/admin-pipeline-runs.md): Pipeline-Run-Historie (run_lod2_bl + finalize) für Operator-Audit
- [POST /v1/admin/datasets](https://lodapi.de/docs/endpoints/admin-register-dataset.md): Server-to-server: Dataset + Tilesets registrieren (Bearer-Auth)
- [DELETE /v1/admin/api-keys/{api_key_id}](https://lodapi.de/docs/endpoints/admin-revoke-api-key.md): Revoke a customer API key

### buildings

- [GET /v1/buildings/{gmlid}](https://lodapi.de/docs/endpoints/get-building-detail.md): Einzelnes Gebäude per GML-ID (föderiert)
- [GET /v1/buildings/{gmlid}/roof](https://lodapi.de/docs/endpoints/get-building-roof-surfaces.md): RoofSurfaces with tilt, azimuth and area for solar analysis
- [GET /v1/buildings/3d.glb](https://lodapi.de/docs/endpoints/get-buildings-glb.md): Bbox → einzelnes GLB (z-normalisiert, föderiert)
- [GET /v1/buildings](https://lodapi.de/docs/endpoints/list-buildings-bbox.md): Föderierte LoD2-Gebäude-Suche per Bounding-Box

### datasets

- [GET /v1/datasets](https://lodapi.de/docs/endpoints/list-datasets.md): Status pro Bundesland (Snapshot, Coverage, Lizenz)

### ops

- [GET /healthz](https://lodapi.de/docs/endpoints/health-check.md): Liveness-Check (Caddy + docker-compose)

### osm-cover

- [GET /v1/osm-cover/datasets](https://lodapi.de/docs/endpoints/list-osm-cover-datasets.md): 3D-Tiles-OSM-Cover-Tilesets (thematisch geclustert, b3dm + Draco)

### terrain

- [GET /v1/terrain/elevation](https://lodapi.de/docs/endpoints/get-terrain-elevation.md): Geländehöhe an einem WGS84-Punkt aus DGM1
- [GET /v1/terrain/profile](https://lodapi.de/docs/endpoints/get-terrain-profile.md): Höhenprofil entlang einer Polyline
- [GET /v1/terrain/datasets](https://lodapi.de/docs/endpoints/list-terrain-datasets.md): Liste verfügbarer DGM1-Terrain-Datensätze (pro BL)

### terrain-mesh

- [GET /v1/terrain-mesh/datasets](https://lodapi.de/docs/endpoints/list-terrain-mesh-datasets.md): 3D-Tiles-Mesh-Tilesets für DGM1 (b3dm + Draco)

### tilesets

- [GET /v1/tilesets/{tileset_id}](https://lodapi.de/docs/endpoints/get-tileset.md): 3D-Tiles-Tileset-Detail per ID
- [GET /v1/tilesets](https://lodapi.de/docs/endpoints/list-tilesets-bbox.md): 3D-Tiles-Tilesets, die eine WGS84-Bbox schneiden
- [GET /v1/tilesets/{tileset_id}/tileset.json](https://lodapi.de/docs/endpoints/redirect-tileset-json.md): 302-Redirect zur Cesium-tileset.json auf der CDN

## Guides

- [Attribution & Lizenz-Compliance](https://lodapi.de/docs/guides/attribution.md): Wann du Lodapi-Quellen sichtbar nennen musst — und wie du den attribution[]-Block ins Frontend bringst.
- [Quickstart — Vom curl-1-Liner zum Frankfurt-3D in 10 Minuten](https://lodapi.de/docs/guides/quickstart.md): Setup-Free-Tour durch Lodapi für Web-Devs.
- [Lodapi für KI-Coding-Agenten](https://lodapi.de/docs/guides/using-with-ai-agents.md): llms.txt, .well-known-Discovery, MCP-Server-Roadmap. Lodapi ist für Cursor, Claude Code und Aider optimiert.
- [Lodapi mit CesiumJS](https://lodapi.de/docs/guides/using-with-cesium.md): Cesium-Viewer mit Lodapi-Buildings + Terrain in ~20 Zeilen.
- [Lodapi mit QGIS](https://lodapi.de/docs/guides/using-with-qgis.md): Lodapi-Daten in QGIS — GeoJSON-Layer, 3D-Map-View, OGC-API-Plugin.
- [Lodapi mit Three.js](https://lodapi.de/docs/guides/using-with-three-js.md): Three.js-Scene mit Lodapi-Buildings via GLB-Export oder 3D-Tiles-Renderer.

## Reference

- [Bundesländer-Coverage und Lizenzen](https://lodapi.de/docs/reference/bundeslaender.md)
- [API-Changelog](https://lodapi.de/docs/reference/changelog.md)
- [CRS-Konventionen](https://lodapi.de/docs/reference/crs.md)
- [Datenmodell — Buildings, Surfaces, Tilesets, Terrain](https://lodapi.de/docs/reference/data-model.md)

## Optional

- [llms-full.txt](https://lodapi.de/llms-full.txt): vollständige Doku zum Drop in Context-Windows
- [openapi.json](https://lodapi.de/openapi.json): OpenAPI-3.1-Snapshot
- [GitHub](https://lodapi.de): Repository / Code