NDS MapViewer
Visualize NDS.Live, NDS.Classic, and GeoJSON map data on a 3D Cesium globe
with live style editing, feature inspection, and layer management — all from
a single mapviewer command. No Docker knowledge required.
Beta — This Python package is in early development. The CLI interface may change between releases. Feedback and bug reports are welcome via the NDS developer portal.
Full documentation: https://developer.nds.live/tools/mapviewer
Features
- 3D globe visualization powered by Cesium via erdblick
- Multiple data formats — NDS.Live, GeoJSON, NDS.Classic (member edition)
- Live style editing — modify map styles in real time with YAML-based rules
- Feature inspection — click any map feature to explore its attributes and relations
- Local and remote data — view SmartLayer folders, FileStore files, or remote services
- Guided setup — interactive wizard for creating data source configs
- Config management — save, switch, and delete configs from the RunScreen (
c)
Getting Started
The recommended way to set up your NDS.Live environment (credentials, Docker registry, pip index) is via ndslive-setup:
pip install ndslive-setup
ndslive-setup
This interactive wizard configures everything you need in one step, including installing nds-mapviewer.
Installation
If you prefer to install manually (or ndslive-setup already configured your environment):
pip install nds-mapviewer
Requires Python 3.10+ and Docker.
Usage
mapviewer # HomeScreen (or auto-loads ~/.nds/config.yaml)
mapviewer /path/to/data.ndslive # View a local FileStore
mapviewer /path/to/folder # View a local SmartLayer folder
mapviewer /path/to/geojson/ # View a GeoJSON folder
mapviewer --demo # Try it with NDS Islands sample data
mapviewer mywork # Load a saved config by name
mapviewer /path/a.ndslive /path/b # Multiple sources at once
All commands accept -e community|member and -i VERSION.
If ~/.nds/config.yaml exists, mapviewer (with no arguments) loads it
automatically and goes straight to the RunScreen.
Editions
| Edition | Formats | Access |
|---|---|---|
| community | NDS.Live, GeoJSON, open formats | Free — nds.live |
| member | + NDS.Classic | NDS membership |
Open-Source Building Blocks
- mapget — tile-based map data server with caching
- erdblick — Cesium web frontend with live style editing and inspection tools
License
The MapViewer is a proprietary product of the NDS Association. License terms and conditions are governed by the account type used to access the Docker image — registering for a community or member account includes accepting the applicable licensing terms for the MapViewer and its components.
1 maintainer
Release files for nds-mapviewer 2025.6.2.post44
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nds_mapviewer-2025.6.2.post44.tar.gz | 51.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nds_mapviewer-2025.6.2.post44-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 95.5 kB
Release files / nds_mapviewer-2025.6.2.post44.tar.gz
| Download URL | nds_mapviewer-2025.6.2.post44.tar.gz |
|---|---|
| Size | 51.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dfe0f80fb41abf23e928d02d0ece92f9573619daf08b1a0033db168d045fc603
|
|
BLAKE2b-256 checksum How to use checksums |
e40cd32f683129084e48d88871bee00a1bcf376b6986d72772e8f260b555e650
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / nds_mapviewer-2025.6.2.post44-py3-none-any.whl
| Download URL | nds_mapviewer-2025.6.2.post44-py3-none-any.whl |
|---|---|
| Size | 43.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2c38bda53b547dd2e0d2faf9b2f1d669f775976449bd51e2b8b888e58aa0d993
|
|
BLAKE2b-256 checksum How to use checksums |
4b947a35bd5a45929a45225066a48c740ec28d249ebf50820a0ecea0d2662955
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
