Upload a Shapefile

A Shapefile isn’t one file — it’s a set of sidecar files that must travel together. CollMap accepts them as a single .zip.

What the zip must contain

• Directoryyour-shapefile.zip

  • roads.shp the geometry
  • roads.shx the shape index
  • roads.dbf the attributes
  • roads.prj the coordinate system

Caution

Zip the files themselves, not the folder that contains them. A common mistake is zipping a parent directory, which puts the files one level down inside the archive — CollMap then can’t find the .shp. Select the files and compress the selection.

Uploading a bare .shp on its own is rejected — the .dbf and .prj are required for attributes and projection.

Upload it in the app

1. Open the Upload Layer tab and choose your .zip.

2. Name the layer and upload. Large shapefiles process in the background with a progress bar.

   

3. When it finishes you’ll see a success confirmation, and the features render on the map.

   

The test suite uses a real OpenStreetMap extract — gis_osm_waterways_07_1.zip (a ~355 KB archive of about 2,200 waterway lines) — as its shapefile example; any well-formed zip works the same way.

Or upload via the API

cURL

curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \
  -F "roomName=$ROOM" -F "layerName=waterways" -F "file=@gis_osm_waterways_07_1.zip"
# → { "jobId": "job-…" }  — poll GET /api/layers/jobs/<jobId> until complete

Next steps

Upload a GeoPackageBring in a multi-layer .gpkg.