Raum exportieren & importieren

Der Reiter Export / Import (in der linken Symbolleiste) sichert einen ganzen Raum — Marker, Ebenen, gezeichnete Formen und wahlweise Raster — als ein einziges GeoPackage und spielt eines wieder in einen Raum zurück.

Einen Raum exportieren

1. Öffnen Sie den Reiter Export / Import und wählen Sie, was enthalten sein soll — Sie können die Raster-GeoTIFFs und vorgenerierten Kacheln mitnehmen oder nur die Vektorinhalte exportieren.
2. Exportieren. Sie erhalten eine .gpkg-Datei, die sich direkt in QGIS, ArcGIS oder jedem GeoPackage-fähigen Werkzeug öffnen lässt.

Kleine und normal große Räume werden synchron exportiert (die Datei lädt herunter, sobald sie fertig ist). Sehr große Räume wechseln zu einem asynchronen Hintergrundauftrag — der Export läuft serverseitig, und Sie laden das fertige Artefakt herunter, wenn er abgeschlossen ist. Das Panel sagt Ihnen, welchen Modus ein Raum verwenden wird.

Einen Raum importieren

Der Import akzeptiert eine .gpkg (einen Raum-Export) oder ein Reconnect-Manifest (.json, siehe unten).

1. Öffnen Sie den Reiter Export / Import und wählen Sie Ihre Datei.
2. Bestätigen Sie. Der Inhalt des Raums wird durch die importierten Daten ersetzt.

Achtung

Der Import in einen Raum, der bereits Inhalte hat, überschreibt sie und setzt die Zeitleiste zurück — importieren Sie in einen frischen Raum, wenn Sie den aktuellen behalten wollen. Der GeoPackage-Import ist auf 2 GB begrenzt; darüber nutzen Sie ein Reconnect-Manifest.

Einen großen Raum klonen (Reconnect-Manifest)

Für Räume, die als einzelnes GeoPackage zu groß sind, erzeugt der Export statt der Bytes ein kleines Reconnect-Manifest (.json). Dieses Manifest zu importieren klont den Raum, indem die Daten serverseitig kopiert werden — ohne erneute Verarbeitung und ohne Download von mehreren Gigabyte. Der Klon bleibt auf derselben Instanz, und sein Speicher zählt gegen das Kontingent des neuen Eigentümers.

Über die 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"

Große Räume (asynchron)

# 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

Die vollständige Endpunktliste finden Sie in der Referenz Export, Import & Klonen.

Nächste Schritte

API-ÜberblickAuthentifizieren Sie sich und steuern Sie einen Raum über HTTP.