Skip to content

Upload file as layer

POST
/api/maps/{original_map_id}/layers

Uploads spatial data, processes it, and adds it as a layer to the specified map.

Supported formats:

  • Vector: Shapefile (as .zip), GeoJSON, GeoPackage, FlatGeobuf
  • Raster: GeoTIFF, DEM
  • Point cloud: LAZ, LAS

Once uploaded, Mundi transforms, reprojects, styles, and creates optimized formats for display in the browser. Vector data is converted to PMTiles while raster data is converted to cloud-optimized GeoTIFFs. Point cloud data is compressed to LAZ 1.3.

Returns the new layer details including its unique layer ID. The layer can optionally not be added to the map, but will be faster to add to an existing map later.

original_map_id
required
Original Map Id
string
request
Request
Body_upload_layer_to_map
object
file
required
File
string format: binary
layer_name
Layer Name
string
add_layer_to_map
Add Layer To Map
boolean
default: true

Successful Response

LayerUploadResponse
object
dag_child_map_id
required
Dag Child Map Id

The ID of the new map created that contains the changes. Use this ID for further operations on the modified map.

string
dag_parent_map_id
required
Dag Parent Map Id

The ID of the original map which was copied to create the new map.

string
id
required
Id

Unique identifier for the newly uploaded layer

string
name
required
Name

Display name of the layer as it appears in the map

string
type
required
Type

Layer type (vector, raster, or point_cloud)

string
url
required
Url

Direct URL to access the layer data (PMTiles for vector, COG for raster)

string
message
Message

Status message confirming successful upload

string
default: Layer added successfully

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string