Exporter et importer une salle

L’onglet Export / Import (dans la barre d’icônes de gauche) enregistre toute une salle — repères, couches, formes dessinées et, si vous le souhaitez, rasters — dans un unique GeoPackage, et permet de la restaurer.

Exporter une salle

1. Ouvrez l’onglet Export / Import et choisissez ce qu’il faut inclure — vous pouvez ajouter les GeoTIFF raster et les tuiles pré-générées, ou n’exporter que le contenu vectoriel.
2. Exportez. Vous obtenez un fichier .gpkg qui s’ouvre directement dans QGIS, ArcGIS ou tout outil compatible GeoPackage.

Les salles petites et de taille normale s’exportent de façon synchrone (le fichier se télécharge dès qu’il est prêt). Les très grandes salles basculent vers une tâche de fond asynchrone — l’export s’exécute côté serveur et vous téléchargez l’artefact terminé une fois le traitement achevé. Le panneau vous indique le mode qui sera utilisé.

Importer une salle

L’import accepte un .gpkg (un export de salle) ou un manifeste de reconnexion (.json, voir ci-dessous).

1. Ouvrez l’onglet Export / Import et choisissez votre fichier.
2. Confirmez. Le contenu de la salle est remplacé par les données importées.

Attention

Importer dans une salle qui contient déjà quelque chose écrase son contenu et réinitialise la chronologie — importez dans une salle vierge si vous voulez conserver l’actuelle. L’import GeoPackage est plafonné à 2 Go ; au-delà, utilisez un manifeste de reconnexion.

Cloner une grande salle (manifeste de reconnexion)

Pour les salles trop volumineuses pour être déplacées sous forme d’un seul GeoPackage, l’export produit un petit manifeste de reconnexion (.json) au lieu des octets. Importer ce manifeste clone la salle en copiant les données côté serveur — sans retraitement ni téléchargement de plusieurs gigaoctets. Le clone reste sur la même instance, et son stockage est décompté du quota du nouveau propriétaire.

Le faire via l’API

Export / import

# Export the whole room to a GeoPackage (empty body = full room state)  — needs `read`
curl -X POST "$API/api/rooms/$ROOM/export" -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{}' -o room.gpkg

# Import a GeoPackage into the room (≤ 2 GiB)  — needs `write`
curl -X POST "$API/api/rooms/$ROOM/import" -H "Authorization: Bearer $TOKEN" \
  -F "file=@room.gpkg"

Grandes salles (asynchrone)

# Probe which mode to use
curl -s "$API/api/rooms/$ROOM/export-size" -H "Authorization: Bearer $TOKEN"
# → { "recommended": "sync" | "async" }

# Start an async export, poll it, then download the artifact
curl -X POST "$API/api/rooms/$ROOM/export-jobs" -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{}'                              # → 202 { jobId }
curl -s  "$API/api/rooms/$ROOM/export-jobs/<jobId>" -H "Authorization: Bearer $TOKEN"          # → status
curl -s  "$API/api/rooms/$ROOM/export-jobs/<jobId>/artifact" -H "Authorization: Bearer $TOKEN" -o room.gpkg

Voir la référence Export, import et clonage pour la liste complète des points de terminaison.

Étapes suivantes

Aperçu de l'APIAuthentifiez-vous et pilotez une salle en HTTP.