Salta ai contenuti
IT

Livelli e caricamenti

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

Campi: roomName, layerName, file e, facoltativi, description, style (JSON: color, opacity, strokeWeight, visible e attributeDisplay), display (JSON, per i raster). Comportamento in base al contenuto:

  • GeoJSON/CSV di punti → segnaposto ({ markersCreated, markers, layer: null })
  • Poligoni / linee → un livello vettoriale ({ layer: { name, featureCount, ... } })
  • GeoTIFF → un livello raster
  • Gli input vettoriali più grandi restituiscono { jobId } — interroga l’attività (sotto).
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 }

Un campo facoltativo attributeDisplay imposta i valori del popup del livello, le sue righe raster, i colori in base a un attributo e i filtri (sotto).

Impostare la visualizzazione degli attributi di un livello

Sezione intitolata “Impostare la visualizzazione degli attributi di un livello”
PATCH /api/layers/:layerId (token permission: write)
Content-Type: application/json
{ "attributeDisplay": { "version": 1, "popup": { "mode": "auto" } } }

La visualizzazione degli attributi stabilisce quali valori mostra il popup di un elemento, quali valori dei livelli raster della stanza legge sotto l’elemento (rasters), come il livello viene colorato in base a un attributo e quali filtri per intervallo offre la legenda. Il PATCH la scrive sulla mappa dal vivo e registra una voce nella cronologia. Sostituisce l’intera impostazione, quindi invia ogni parte che vuoi mantenere. "attributeDisplay": null la rimuove. I caricamenti e le creazioni in linea verificano style.attributeDisplay / attributeDisplay allo stesso modo, prima di memorizzare qualsiasi cosa.

Un PATCH richiede un livello memorizzato sul server (altrimenti 404). Un livello con 100 elementi o meno viene tenuto nella stanza come una forma disegnata, quindi riceve la sua visualizzazione degli attributi solo al caricamento, alla creazione o all’importazione.

Un valore non valido viene rifiutato e non cambia nulla:

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

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

Recuperare gli elementi per riquadro di delimitazione

Sezione intitolata “Recuperare gli elementi per riquadro di delimitazione”
GET /api/layers/:layerId/features?minLon=&minLat=&maxLon=&maxLat=&zoom=

Restituisce una FeatureCollection GeoJSON. I livelli piccoli restituiscono un oggetto completo con _metadata.complete = true; quelli molto grandi possono restituire un manifesto a blocchi (_metadata.directChunks) i cui valori path vanno recuperati e uniti:

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

I file che superano il limite di 50 MB per singola richiesta vengono caricati a blocchi (lo script di importazione lo fa per te), poi assemblati ed elaborati. process-chunked accetta gli stessi layerName, description e style di un caricamento singolo. Se style.attributeDisplay non è valido, la richiesta viene rifiutata ma i blocchi caricati restano conservati, così puoi correggerlo e inviare di nuovo la stessa richiesta.

GET /api/layers/jobs/:jobId

Interroga finché stage/status non è definitivo (complete o error):

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

Eliminare un livello è un’operazione da proprietario/sessione — un token API della stanza non può eliminare livelli.