GET /v1/buildings/{gmlid}

Einzelnes Gebäude per GML-ID (föderiert)

stable seit v0.1.0 buildings auth: none

GET /v1/buildings/{gmlid} — Building-Detail

Liefert ein einzelnes Gebäude mit voller LoD2-Geometrie (GeoJSON-encoded MultiPolygonZ, aggregiert über alle Surfaces des building_id). Föderiert: das Bundesland wird aus dem GML-ID-Präfix abgeleitet; ist das Präfix mehrdeutig, probiert die API alle aktiven BL durch.

Examples

curl

curl -s https://api.lodapi.de/v1/buildings/DEHE06200001chAX | jq

Python — Felder lesen

# pip install lodapi
from lodapi import Client

with Client() as c:
    b = c.buildings.get("DEHE06200001chAX")
    print(f"BL: {b.bundesland_code}")
    print(f"building_id: {b.building_id}, LoD: {b.lod}")
    print(f"GML-ID: {b.gmlid}")

Parameters

ParameterInTypeRequiredBeschreibung
gmlidpathstringyesGML-ID des Gebäudes (BL-Präfix oder pure UUID)

Response

200 OK · application/json — Schema #/components/schemas/BuildingDetail.

Felder:

FeldBedeutung
gmlidEcho der Anfrage
bundesland_codeQuell-BL (2 Buchstaben)
building_idInterner Building-Key, über den die Surfaces aggregiert werden
lodLoD-Level ("LoD2" in Phase 1)
geometryGeoJSON-Geometrie (MultiPolygonZ, WGS84), aggregiert über alle Surfaces des building_id

Fehler

StatusBedingung
404gmlid in keinem BL gefunden

Stolperdrähte

  • GML-IDs sind nicht stabil über Snapshots — wenn die Behörde reparst, ändert sich die ID. Persistenz braucht ein eigenes Mapping.
  • Nur Geometrie + Klassifikation: Der Slim-Datenbestand enthält keine per-Building-Sachattribute. Die Response trägt {gmlid, bundesland_code, building_id, geometry, lod} — es gibt kein properties-Mapping.
  • Geometrie ist building-aggregiert: die geometry fasst alle Surfaces (Wall/Ground/Roof) des building_id zusammen. Für Surface-Level-Einzelflächen mit surface_class ist /v1/buildings (bbox) der Pfad.

Verwandte Endpoints

Verwandt

  • /v1/buildings
  • /v1/buildings/3d.glb

Bereit?

Der erste Call geht sofort.

LoD2-Gebäude für alle 16 Bundesländer, kostenlos und ohne Konto. Pro auf Anfrage 30 Tage testen.