Resource

Analyses.

Soll-Ist, Volumen, Lichtraum-Check, Anomalie-Detection. Asynchrone Operation — du bekommst sofort eine ID zurück und der Worker rechnet im Hintergrund. Webhook beim Fertigwerden.

POST/v1/analyses

Analyse starten

Triggert eine Analyse-Pipeline. Type bestimmt erforderliche Felder.

Body

Name	Typ	Beschreibung
type*	soll_ist \| volume \| clearance \| anomaly \| classification	Analyse-Typ
project_id*	string	Projekt-ID
pointcloud_id*	string	Quell-Pointcloud
soll_model_id	string?	Pflicht für type=soll_ist
polygon	GeoJSON?	Pflicht für type=volume
track_axis_id	string?	Pflicht für type=clearance
profile	string?	Lichtraum-Profil (z.B. DB_G1)
tolerance_cm	int?	Toleranz für Soll-Ist / Lichtraum

Beispiel-Response

{
  "id": "ANL_pK9z2D",
  "type": "clearance",
  "status": "queued",
  "project_id": "PRJ_aT3Dd9",
  "pointcloud_id": "PCL_xY9Vn4",
  "queue_position": 1,
  "estimated_seconds": 320
}

Beispiel-Request

curl https://api.geospatial.gddc-sh.de/v1/analyses \
  -H "Authorization: Bearer $GDDC_TOKEN" \
  -d '{
    "type": "soll_ist",
    "project_id": "PRJ_b5Lx2K",
    "pointcloud_id": "PCL_aBc123",
    "soll_model_id": "SLM_q9Dr1H",
    "tolerance_cm": 5
  }'

GET/v1/analyses/{id}

Analyse holen

Aktueller Status und Ergebnis (sobald done).

Path-Parameter

Name	Typ	Beschreibung
id*	string	ANL_…

Beispiel-Response

{
  "id": "ANL_pK9z2D",
  "type": "clearance",
  "status": "done",
  "duration_ms": 312_400,
  "result": {
    "violations_count": 14,
    "violations": [
      {
        "km": 12.402,
        "class": "vegetation",
        "encroachment_cm": 47,
        "lat": 53.864823,
        "lon": 10.682401,
        "alt": 22.4,
        "snapshot_url": "https://tiles.../snap_001.png"
      },
      "..."
    ],
    "heatmap_url": "https://files.geospatial.gddc-sh.de/ANL_pK9z2D_heatmap.png?...",
    "report_geojson_url": "https://files.geospatial.gddc-sh.de/ANL_pK9z2D.geojson?..."
  }
}

Beispiel-Request

curl https://api.geospatial.gddc-sh.de/v1/analyses/ANL_pK9z2D \
  -H "Authorization: Bearer $GDDC_TOKEN"

GET/v1/analyses

Analysen listen

Filterbar nach Project / Type / Status.

Query-Parameter

Name	Typ	Beschreibung
project_id	string?	Filter
type	string?	Filter auf Analyse-Typ
status	string?	queued \| running \| done \| failed

Beispiel-Response

{
  "items": [
    { "id": "ANL_pK9z2D", "type": "clearance", "status": "done" },
    { "id": "ANL_qR2x4L", "type": "volume",    "status": "running" }
  ],
  "next_cursor": null
}

Beispiel-Request

curl "https://api.geospatial.gddc-sh.de/v1/analyses?project_id=PRJ_aT3Dd9" \
  -H "Authorization: Bearer $GDDC_TOKEN"