What You’ll Learn in This Guide
1. Create your first map
Sign in to your Neural Earth Studio account.
Navigate to the Maps page — this page lists all your existing maps.
Click + New Map in the top-right corner.
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
Inside your new map, click + Add Data in the left-hand column.
A pop-up window titled “Add data to this map” will appear.
Choose how to add your data:
Load files (for file uploads).
Import Tileset (for vector, raster, or WMS tile URLs).
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.
Once uploaded, your dataset will automatically begin loading and saving into your map.
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:
Select the Tileset type: Vector Tile, Raster Tile, or WMS.
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://orhttps://, the system assumeshttps://.
Provide a Name for your dataset (e.g., “NOAA Flood Zones” or “Population data”).
If available, include a Tileset metadata URL (recommended).
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 | ✅ | Must be valid URL |
Raster Tile | Cloud-optimized GeoTIFF tilesets | ✅ | Limited STAC support |
WMS | Web Map Service endpoint | ✅ | Must be valid service URL |
