Jens
faeb58ef6d
3.2 KiB
API Specification v1.0
Basispad: /api/v1
Projects
GET /projects
Geeft alle projecten terug.
POST /projects
Maakt een project aan.
Body:
{
"name": "Geel gebouwdetectie demo",
"description": "Detectie en QA/QC van gebouwen in Geel",
"region": "Kempen"
}
GET /projects/{project_id}
Geeft projectdetails terug.
DELETE /projects/{project_id}
Verwijdert een project en gekoppelde metadata. Bestanden moeten veilig afgehandeld worden.
Areas
GET /projects/{project_id}/areas
Geeft analysegebieden van een project.
POST /projects/{project_id}/areas
Maakt analysegebied aan.
Body:
{
"name": "Geel Centrum",
"geometry": { "type": "Polygon", "coordinates": [] }
}
GET /areas/{area_id}
Geeft gebieddetails.
Datasets
POST /projects/{project_id}/datasets/upload
Uploadt raster of vector dataset.
Multipart:
- file
- name
- dataset_type
- source
GET /projects/{project_id}/datasets
Lijst datasets.
GET /datasets/{dataset_id}
Datasetdetails.
GET /datasets/{dataset_id}/metadata
Metadata.
POST /datasets/{dataset_id}/extract-metadata
Start metadata extraction job.
Reference Data
POST /projects/{project_id}/reference/grb/fetch
Haalt GRB-data op voor een area.
Body:
{
"area_id": "uuid",
"layers": ["buildings"]
}
POST /projects/{project_id}/reference/osm/fetch
Haalt OSM-data op voor een area.
Raster
POST /datasets/{dataset_id}/raster/clip
Clipt raster op area.
POST /datasets/{dataset_id}/raster/tile
Maakt tiles voor AI-inference.
Body:
{
"tile_size": 640,
"overlap": 64,
"area_id": "uuid"
}
POST /datasets/{dataset_id}/raster/indices/ndvi
V2: berekent NDVI.
Vector
POST /datasets/{dataset_id}/vector/clip
Clipt vectorlaag op area.
POST /datasets/{dataset_id}/vector/buffer
Maakt buffers.
POST /datasets/{dataset_id}/vector/validate
Valideert geometrieën.
Analysis
POST /analysis/object-detection
Start objectdetectie.
Body:
{
"project_id": "uuid",
"area_id": "uuid",
"dataset_id": "uuid",
"model_id": "uuid-or-default",
"classes": ["building"],
"confidence_threshold": 0.35
}
POST /analysis/segmentation
Start segmentatie.
POST /analysis/change-detection
Start change detection.
GET /analysis/{analysis_run_id}
Geeft runstatus en resultaten.
GET /analysis/{analysis_run_id}/detections
Geeft detecties als GeoJSON FeatureCollection.
GET /analysis/{analysis_run_id}/segmentations
Geeft segmentaties als GeoJSON FeatureCollection.
QA/QC
POST /analysis/{analysis_run_id}/quality-check
Vergelijkt AI-resultaten met referentiedataset.
Body:
{
"reference_dataset_id": "uuid",
"iou_threshold": 0.5,
"class_mapping": {
"building": "building"
}
}
GET /quality-checks/{quality_check_id}
Geeft QA/QC-resultaten.
Exports
POST /exports/geojson
Exporteert analysis output naar GeoJSON.
POST /exports/yolo
Exporteert annotaties naar YOLO-formaat.
POST /exports/coco
Exporteert annotaties naar COCO-formaat.
GET /exports/{export_id}/download
Download exportbestand.
Jobs
GET /jobs/{job_id}
Geeft jobstatus.
GET /projects/{project_id}/jobs
Geeft jobs van een project.