Upload GeoJSON | Mappinest Docs

Create a dataset

Open Datasets in the console and select Add Dataset. You can upload one GeoJSON document or create a blank layer and draw its first features in Dataset Studio.

Add a GeoJSON Dataset

Replace with a screenshot of the Add Dataset dialog showing the file drop area and Start drawing action. Suggested file: mappinest-frontend/public/raster/docs/datasets/dataset-upload.png.

Accepted input

Input	Requirement
File extension	`.geojson` or `.json`
Document shape	One GeoJSON `Feature` or `FeatureCollection`
Source coordinates	WGS84 longitude and latitude (`EPSG:4326`)
Source file size	Up to 20 MiB
Published feature count	Up to 12,000 features
Canonical published size	Up to 20 MiB

A .json file must still contain valid GeoJSON. Arbitrary JSON documents are not accepted. Shapefile upload is not available in the current Dataset flow.

Feature IDs

Existing feature IDs may be strings or finite numbers and are normalized to strings. Missing IDs are generated during import. IDs must be unique after normalization and can contain up to 512 characters.

Geometry support

The import accepts Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, and GeometryCollection geometry. A feature may also have null geometry. Coordinates must use a consistent XY or XYZ shape within each feature geometry. Nested GeometryCollections can contain up to 32 levels.

Properties and nesting

Feature properties must be an object, null, or omitted. Mappinest normalizes null or missing properties to an empty object. Property values can contain JSON strings, booleans, null, finite numbers, arrays, and nested objects. Property JSON can contain up to 32 levels.

Upload workflow

Select Add Dataset on the Datasets page.
Drag a .geojson or .json file into the dialog, or select Browse.
Select Upload. The console creates the dataset and transfers the source file.
Wait while Mappinest validates, normalizes, and publishes the GeoJSON.
Open the row action menu and select Edit in Studio, Download GeoJSON, or View details.

The dataset name starts with the uploaded filename without its extension. The Dataset ID is generated in your account namespace and remains stable when later revisions are published.

Import status

The upload dialog reports transfer and import-start errors. After processing starts, follow the status in the Datasets table. Refresh the list if the final worker result is not visible yet. A ready dataset has a published revision that can be opened in Studio or read through the Dataset API. An invalid source is not published.

Download GeoJSON

Open the Dataset row menu and select Download GeoJSON to export the latest committed revision. Downloads are available for empty and ready datasets. They are blocked while an import is running or after an import failure.

Local drafts

A Studio draft exists only in the current browser and is not part of the download. Publish the draft to include it, or discard it before downloading the latest committed revision. Each account can complete up to 50 console GeoJSON downloads per UTC day.

Delete a dataset

Open the Dataset row menu, select Delete, and confirm the action. The console verifies the current revision before deleting the dataset. If another change was published first, refresh the row and review the latest revision before trying again. Dataset deletion cannot be undone.

Start from scratch

Select Start drawing when you do not have a source file. Mappinest creates an empty dataset named Untitled Dataset with revision 1 and opens Dataset Studio. Rename it, draw points, lines, or polygons, add properties, and select Publish to create the next revision.