Upload a GeoPackage

A GeoPackage (.gpkg) is a single-file database that can hold many layers at once — points, lines, and polygons together. It’s the format CollMap itself uses for room export, so it round-trips cleanly.

Upload it in the app

1. Open the Upload Layer tab and choose your .gpkg file.
2. Name it and upload. Every table in the GeoPackage is imported as its own layer; point tables become markers.

The test suite ships a world-travel-room.gpkg fixture (~1.5 MB) containing 25 world cities as markers plus their boundary polygons, with dates that populate the timeline — a good example of how much a single .gpkg can carry. There’s also a small geopackage-format-example.gpkg if you want to inspect the structure.

Tip

GeoPackages are produced by QGIS, ArcGIS, ogr2ogr, and most GIS tools — export any project as a .gpkg and upload it here.

Or upload via the API

cURL (as a layer)

curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \
  -F "roomName=$ROOM" -F "layerName=world-travel" -F "file=@world-travel-room.gpkg"

cURL (whole-room import)

To restore a GeoPackage that represents an entire room (as produced by room export), use the room import endpoint instead — see Export & Import a Room:

curl -X POST "$API/api/rooms/$ROOM/import" -H "Authorization: Bearer $TOKEN" \
  -F "file=@room.gpkg"

Next steps

Upload a GeoTIFFBring in raster imagery and elevation data.