Couches et imports
Importer un fichier de couche
Section intitulée « Importer un fichier de couche »POST /api/layers/upload (token permission: upload)Content-Type: multipart/form-dataChamps : 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).
curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \ -F "roomName=$ROOM" -F "layerName=my-layer" -F "file=@data/my-layer.geojson"Créer une couche depuis du GeoJSON en ligne
Section intitulée « Créer une couche depuis du GeoJSON en ligne »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"] }Lister les couches
Section intitulée « Lister les couches »GET /api/layers/:roomName (token permission: read)→ { "layers": [ { "id", "name", "featureCount", ... } ] }
Récupérer les entités par emprise
Section intitulée « Récupérer les entités par emprise »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/:chunkIndexGros fichiers : envoi par blocs
Section intitulée « Gros fichiers : envoi par blocs »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.
Suivre une tâche de traitement
Section intitulée « Suivre une tâche de traitement »GET /api/layers/jobs/:jobIdInterrogez jusqu’à ce que stage/status soit terminal (complete ou error) :
{ "stage": "processing", "progress": 60, "message": "…" }Supprimer une couche
Section intitulée « Supprimer une couche »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.