Upload a GeoTIFF

A GeoTIFF (.tif / .tiff) brings raster data onto the map — satellite imagery, elevation models, land-cover masks, and so on. After the file uploads, CollMap asks how to display it.

Upload it in the app

1. Open the Upload Layer tab and choose your .tif / .tiff file. Name it and upload.

2. When processing finishes, the band / colormap chooser appears:

   • Single-band rasters (elevation, an index, a mask) — pick a band and a colormap (for example viridis or terrain), and optionally a value range.

     

   • Multi-band scenes (e.g. satellite imagery) — choose an RGB composite by assigning three bands to red, green, and blue.

3. Apply. The raster renders on the map; you can change its display later from the Layers panel.

The test suite uses two representative rasters: LisbonElevation.tif (~905 KB, single-band elevation → colormap) and a Sentinel-2 true-color scene of Basel (~14 MB, multi-band → RGB composite).

Note

Even the 14 MB Sentinel-2 file is under the 50 MB single-request limit, so it uploads directly. Larger rasters are chunked automatically — you’ll just see a progress bar.

Or upload via the API

Set the display up front in a display field — for a token upload every key is honored and renders immediately.

Single-band (colormap)

curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \
  -F "roomName=$ROOM" -F "layerName=elevation" -F "file=@LisbonElevation.tif" \
  -F 'display={"colormap":"terrain","band":1,"vmin":0,"vmax":1500,"opacity":0.8}'

Multi-band (RGB)

curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \
  -F "roomName=$ROOM" -F "layerName=truecolor" -F "file=@scene.tif" \
  -F 'display={"renderMode":"rgb","rgbBands":[1,2,3]}'

Change the display later with PATCH /api/rooms/$ROOM/raster-layers/<id>/display (see the Raster Layers reference).

Next steps

Export & Import a RoomSave a whole room as a GeoPackage, or restore one.