Zum Inhalt springen
DE

Ebenen & Uploads

POST /api/layers/upload (token permission: upload)
Content-Type: multipart/form-data

Felder: roomName, layerName, file sowie optional description, style (JSON: color, opacity, strokeWeight, visible und attributeDisplay), display (JSON, für Raster). Verhalten je nach Inhalt:

  • Punkt-GeoJSON/CSV → Marker ({ markersCreated, markers, layer: null })
  • Polygone / Linien → eine Vektorebene ({ layer: { name, featureCount, ... } })
  • GeoTIFF → eine Rasterebene
  • Größere Vektoreingaben liefern { jobId } — fragen Sie den Auftrag ab (siehe unten).
Terminal window
curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \
-F "roomName=$ROOM" -F "layerName=my-layer" -F "file=@data/my-layer.geojson"
POST /api/rooms/:roomId/layers (token permission: write)
Content-Type: application/json
{ "name": "drawn", "description": "study area",
"geojson": { "type": "FeatureCollection", "features": [] },
"color": "e11d48", "opacity": 0.35, "strokeWeight": 3, "visible": true }

Ein optionales Feld attributeDisplay legt die Popup-Werte, die Rasterzeilen, die Farben nach Attribut und die Filter der Ebene fest (siehe unten).

PATCH /api/layers/:layerId (token permission: write)
Content-Type: application/json
{ "attributeDisplay": { "version": 1, "popup": { "mode": "auto" } } }

Die Attributdarstellung legt fest, welche Werte das Popup eines Objekts zeigt, welche Werte der Rasterebenen des Raums es unter dem Objekt liest (rasters), wie die Ebene nach einem Attribut eingefärbt wird und welche Bereichsfilter die Legende anbietet. Das PATCH überträgt sie live auf die Karte und legt einen Eintrag in der Zeitleiste an. Es ersetzt die ganze Einstellung; senden Sie also jeden Teil mit, den Sie behalten wollen. "attributeDisplay": null entfernt sie. Uploads und das Anlegen aus Inline-GeoJSON prüfen style.attributeDisplay bzw. attributeDisplay auf dieselbe Weise, bevor irgendetwas gespeichert wird.

Ein PATCH braucht eine auf dem Server gespeicherte Ebene (sonst 404). Eine Ebene mit 100 Objekten oder weniger wird im Raum wie eine gezeichnete Form gehalten und erhält ihre Attributdarstellung daher nur beim Hochladen, Anlegen oder Importieren.

Ein fehlerhafter Wert wird abgelehnt, und nichts ändert sich:

{ "error": "invalid_attribute_display",
"details": ["classification.breaks_not_increasing", "classification.colors_length"] }
GET /api/layers/:roomName (token permission: read)

→ { "layers": [ { "id", "name", "featureCount", ... } ] }

GET /api/layers/:layerId/features?minLon=&minLat=&maxLon=&maxLat=&zoom=

Liefert eine GeoJSON-FeatureCollection. Kleine Ebenen liefern ein vollständiges Objekt mit _metadata.complete = true; sehr große können ein Stück-Manifest (_metadata.directChunks) liefern, dessen path-Werte Sie abrufen und zusammenführen:

GET /api/layers/:layerId/features/chunks/:chunkIndex
POST /api/layers/upload-chunk (token permission: upload)
POST /api/layers/process-chunked (token permission: upload)

Dateien über der Grenze von 50 MB je Anfrage werden in Stücken hochgeladen (das Import-Skript erledigt das für Sie), danach zusammengesetzt und verarbeitet. process-chunked nimmt dieselben Felder layerName, description und style an wie ein einzelner Upload. Ein fehlerhaftes style.attributeDisplay wird abgelehnt, während die hochgeladenen Stücke erhalten bleiben — Sie können es also korrigieren und dieselbe Anfrage erneut senden.

GET /api/layers/jobs/:jobId

Fragen Sie ab, bis stage/status endgültig ist (complete oder error):

{ "stage": "processing", "progress": 60, "message": "…" }
DELETE /api/layers/:layerId (user session only)

Eine Ebene zu löschen ist ein Eigentümer-/Sitzungsvorgang — ein Raum-API-Token kann keine Ebenen löschen.