Esportare e importare una stanza

La scheda Esporta / importa (nella barra di icone di sinistra) salva un’intera stanza — segnaposto, livelli, forme disegnate e, se vuoi, raster — in un unico GeoPackage, e ne ripristina uno in una stanza.

Esportare una stanza

1. Apri la scheda Esporta / importa e scegli che cosa includere — puoi aggiungere i GeoTIFF raster e le tile pre-generate, oppure esportare solo il contenuto vettoriale.
2. Esporta. Ottieni un file .gpkg che si apre direttamente in QGIS, ArcGIS o in qualsiasi strumento compatibile con GeoPackage.

Le stanze piccole e di dimensioni normali si esportano in modo sincrono (il file viene scaricato non appena è pronto). Le stanze molto grandi passano a un’attività asincrona in background — l’esportazione viene eseguita sul server e scarichi l’artefatto finito al termine. Il pannello ti indica quale modalità userà una stanza.

Importare una stanza

L’importazione accetta un .gpkg (un’esportazione di stanza) o un manifesto di riconnessione (.json, vedi sotto).

1. Apri la scheda Esporta / importa e scegli il tuo file.
2. Conferma. Il contenuto della stanza viene sostituito dai dati importati.

Attenzione

Importare in una stanza che contiene già dati li sovrascrive e azzera la cronologia — importa in una stanza nuova se vuoi conservare quella attuale. L’importazione GeoPackage è limitata a 2 GB; oltre tale soglia, usa un manifesto di riconnessione.

Clonare una stanza di grandi dimensioni (manifesto di riconnessione)

Per le stanze troppo grandi da spostare come singolo GeoPackage, l’esportazione produce un piccolo manifesto di riconnessione (.json) invece dei byte. Importare quel manifesto clona la stanza copiando i dati sul server — senza rielaborazione e senza scaricare svariati gigabyte. Il clone resta sulla stessa istanza e il suo spazio viene conteggiato sulla quota del nuovo proprietario.

Farlo tramite l’API

Esporta / importa

# 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"

Stanze grandi (asincrono)

# 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

Vedi il riferimento Esportazione, importazione e clonazione per l’elenco completo degli endpoint.

Passaggi successivi

Panoramica dell'APIAutenticati e pilota una stanza via HTTP.