Aller au contenu
FR

Couches et imports

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

Champs : roomName, layerName, file, et éventuellement description, style (JSON : color, opacity, strokeWeight, visible et attributeDisplay), display (JSON, pour les rasters). Comportement selon le contenu :

  • GeoJSON/CSV de points → repères ({ markersCreated, markers, layer: null })
  • Polygones / lignes → une couche vectorielle ({ layer: { name, featureCount, ... } })
  • GeoTIFF → une couche raster
  • Les entrées vectorielles volumineuses renvoient { jobId } — interrogez la tâche (ci-dessous).
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 champ attributeDisplay facultatif définit les valeurs de la bulle, ses lignes raster, les couleurs selon un attribut et les filtres de la couche (ci-dessous).

Définir l’affichage des attributs d’une couche

Section intitulée « Définir l’affichage des attributs d’une couche »
PATCH /api/layers/:layerId (token permission: write)
Content-Type: application/json
{ "attributeDisplay": { "version": 1, "popup": { "mode": "auto" } } }

L’affichage des attributs indique quelles valeurs la bulle d’une entité affiche, quelles valeurs des couches raster de la salle elle lit sous l’entité (rasters), comment la couche est colorée selon un attribut et quels filtres de plage la légende propose. Le PATCH l’applique à la carte en direct et ajoute une entrée à la chronologie. Il remplace tout le réglage : envoyez donc chaque partie que vous voulez garder. "attributeDisplay": null le supprime. Les imports et les créations depuis du GeoJSON en ligne vérifient style.attributeDisplay / attributeDisplay de la même façon, avant tout enregistrement.

Un PATCH demande une couche enregistrée sur le serveur (sinon 404). Une couche de 100 entités ou moins est gardée dans la salle comme une forme dessinée ; elle ne reçoit donc son affichage des attributs qu’à l’import, à la création ou à l’import d’une salle.

Une valeur mal formée est refusée, et rien ne change :

{ "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=

Renvoie une FeatureCollection GeoJSON. Les petites couches renvoient un objet complet avec _metadata.complete = true ; les très grandes peuvent renvoyer un manifeste de blocs (_metadata.directChunks) dont vous récupérez et fusionnez les valeurs path :

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

Les fichiers dépassant le plafond de 50 Mo par requête sont envoyés par blocs (le script d’import s’en charge pour vous), puis assemblés et traités. process-chunked accepte les mêmes layerName, description et style qu’un import en une seule requête. Un style.attributeDisplay mal formé est refusé, mais les blocs déjà envoyés sont conservés : vous pouvez donc le corriger et renvoyer la même requête.

GET /api/layers/jobs/:jobId

Interrogez jusqu’à ce que stage/status soit terminal (complete ou error) :

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

Supprimer une couche est une opération de propriétaire/session — un jeton d’API de salle ne peut pas supprimer de couches.