Skip to main content

How to create your first Map and add your first Dataset

Learn how to create your first map in Neural Earth Studio and start adding data layers to visualize and analyze geospatial information.

Santiago Cucalon avatar
Written by Santiago Cucalon
Updated over 4 months ago

What You’ll Learn in This Guide


1. Create your first map

  1. Sign in to your Neural Earth Studio account.

  2. Navigate to the Maps page — this page lists all your existing maps.

  3. Click + New Map in the top-right corner.

  4. A new blank map will open in your browser tab, ready for setup.

💡 Pro Tip: Each new map automatically saves to your account. You can return to it anytime from the Maps page.


2. Add your first data layer

  1. Inside your new map, click + Add Data in the left-hand column.

  2. A pop-up window titled “Add data to this map” will appear.

  3. Choose how to add your data:

    • Load files (for file uploads).

    • Import Tileset (for vector, raster, or WMS tile URLs).

  4. To upload files:

    • Drag and drop your file(s) into the upload window, or click Browse to select files from your computer.

    • Supported file types: CSV, JSON, GeoJSON, Arrow, Parquet, and saved Map JSON.

    • Maximum file size: 250 MB.

  5. Once uploaded, your dataset will automatically begin loading and saving into your map.

  6. You’ll see the new dataset listed in the left-hand column with its name and total row count.

💡 Pro Tip: After your dataset loads, you can style it, adjust visibility, or combine it with other layers for deeper analysis.


3. Upload vector, raster, or WMS tiles

To import external map layers, click Import Tileset in the same Add Data pop-up. Then follow these steps:

  1. Select the Tileset type: Vector Tile, Raster Tile, or WMS.

  2. Enter a valid URL for your tileset.

    • The URL must contain at least one dot (e.g., example.com).

    • No spaces; valid characters include letters, numbers, -, _, /, {}, ., ?, =, &.

    • If the URL doesn’t include http:// or https://, the system assumes https://.

  3. Provide a Name for your dataset (e.g., “NOAA Flood Zones” or “Population data”).

  4. If available, include a Tileset metadata URL (recommended).

  5. Click Load tileset to import your data.

💡 Pro Tip: For WMS uploads, ensure the URL is a valid WMS service endpoint. The Load tileset button will remain disabled until a valid URL is entered.


4. File format guidelines and limits

Neural Earth Studio supports a variety of common geospatial and tabular file types for flexible data ingestion. Each format has specific capabilities and size considerations depending on your data source.

The following table outlines all supported file formats, their descriptions, and important usage notes.

File Type

Description

Supported

Notes

CSV

Tabular data with coordinates or location columns

Max 250 MB

JSON / GeoJSON

Structured geographic data

Automatically parsed

Arrow / Parquet

High-performance data formats

Ideal for large datasets

Map JSON

Saved Neural Earth Studio map file

Restores prior map setups

Vector Tile

External tile server with {x}, {y}, {z} placeholders

Must be valid URL

Raster Tile

Cloud-optimized GeoTIFF tilesets

Limited STAC support

WMS

Web Map Service endpoint

Must be valid service URL

Did this answer your question?