geo-data-viewer

Geo Data Analytics tool for VSCode IDE with kepler.gl support to generate and view maps 🗺️ without any Python 🐍, IPyWidgets ⚙️, pandas 🐼, Jupyter notebooks 📚, or ReactJS ⚛️ app code.

![Geo Data Viewer](https://github.com/RandomFractals/geo-data-viewer/blob/master/images/geo-data-viewer.png?raw=true "Geo Data Viewer")

![Geo Data Viewer Ultri Wide](https://github.com/RandomFractals/geo-data-viewer/blob/master/images/geo-data-viewer-ultri-wide.png?raw=true "Geo Data Viewer Ultri Wide")

Features

Map View 🗺️ for GeoJSON, TopoJSON, keplerg.gl JSON, KML, GPX, shapefiles, FlatGeobuf, IGC, WKT, and CSV geo data files
Create .geojson file for .topojson, .kml, .gpx, .fgb, .shp .prj and .dbf shapefiles
Dark and Light Map View 🗺️ Controls UI Themes
Dark, Light, Satellite and Outdoors Map Styles
Map Gallery with public kepler.gl map configs to try
Save map 🗺️ in html format to share with others via Slack or email
Save kepler.gl JSON data and map config for loading online via kepler.gl demo app or in this geo data tool
Load map config or geo data from kepler.gl demo app url, github repository, or gists
View map from Starred ⭐️ Gists in GistPad 📘
View CSV and JSON data with Data Preview 🈸 grid and charts 📊

Usage

Run Geo: View Map (ctrl/cmd + alt + m) command on an open geo data document to view 🗺️
Use Geo: View Map from Url (ctrl/cmd + alt + u) command to load a map from kepler.gl demo app, github repository, or a gist
Run Geo: Map Gallery (ctrl/cmd + alt + g) command to view a list of built-in public keplergl map configs 🗺️

![Geo Data Viewer Gist](https://github.com/RandomFractals/geo-data-viewer/blob/master/images/geo-data-viewer-gist.png?raw=true "Geo Data Viewer Gist")

Supported File Formats

See kepler.gl file formats documentation for the supported geo data files in addition to the geo data formats this extension provides for kepler.gl map 🗺️ views: TopoJSON, keplerg.gl JSON, KML, GPX, FlatGeobuf, shapefiles, IGC, WKT.

Map Gallery

Geo Data Viewer 🗺️ comes with built-in Map Gallery for data analysts and devs to try kepler.gl maps 🗺️ found in the wild 🌐:

![Geo Data Viewer Map Gallery](https://github.com/RandomFractals/geo-data-viewer/blob/master/images/geo-data-viewer-map-gallery.gif?raw=true "Geo Data Viewer Map Gallery")

Note: you can submit a PR with your kepler.gl maps 🗺️ data and config github repo or a gist to be added to the /data/README.md map gallery list.

Installation

Install Geo Data Viewer 🗺️ via VSCode Extensions tab (ctrl+shift+x) by searching for geo, or via VSCode marketplace search results in your browser.

Users of VSCodium, Azure Data Studio, and other VSCode-based IDEs can install Geo Data Viewer 🗺️ using .vsix extension package attached to the Assets section in published releases of this extension on github. Follow install from .vsix instructions in your VSCode extensions compatible IDE or online container service to install it.

Note: VSCodium and other VSCode extension compatible IDE flavors are not officially supported as they require additional testing in those IDE variants.

Contributions

List of Geo Data Viewer 🗺️ commands, keyboard shortcuts, augmented VSCode UI context menus, added geo data Language mappings, and supported geo data files:

![Geo Data Viewer Contributions](https://github.com/RandomFractals/geo-data-viewer/blob/master/images/geo-data-viewer-contributions.png?raw=true "Geo Data Viewer Contributions")

Configuration

Create User or Workspace Settings in vscode to change default Geo Data Viewer 🗺️ extension Settings:

Setting	Type	Default Value	Description
`geo.data.viewer.theme`	string	`dark`	Map View 🗺️ Controls UI Theme: `dark` or `light`
`geo.data.viewer.map.style`	string	`dark`	Default Map Style: `dark`, `light`, `muted` (light), `muted_night`, `satellite`, `dark_streets`, `light_streets`, `outdoors`
`geo.data.viewer.create.geojson`	boolean	`true`	Creates `.geojson` data file on disk for `topojson`, `kml`, `gpx`, `fgb` and `shp` map views

![Geo Data Viewer Settings](https://github.com/RandomFractals/geo-data-viewer/blob/master/images/geo-data-viewer-settings.png?raw=true "Geo Data Viewer Settings")

Recommended Extensions

Other VSCode extensions Geo Data Viewer 🗺️ replaces, enhances or supplements for geo spatial analysis and working with geo data formats:

Extension	Description
Data Preivew 🈸	Data Preview 🈸 extension for importing 📤, viewing 🔎, slicing 🔪, dicing 🎲, charting 📊, and exporting 📥 large JSON array/config, YAML, Apache Arrow, Avro & Excel data files.
Tabular Data Viewer 🀄	Tabular Data Viewer provides fast DSV data loading and custom Table Views 🀄 for large local and remote .csv, .tsv and .tab data files with Tabulator Table, Perspective View, and D3FC Chart Views 📊📈.
Data Table Renderers	Data Table 🈸, Flat Data Grid 中, and Data Summary 🈷️ Renderers for VSCode Notebook 📓 Cell ⌗ Data Outputs.
Leaflet 🍃 Map 🗺️	Leaflet 🍃 Map 🗺️ for Notebook 📓 Cell ⌗ Data Outputs.
Vega Viewer 📈	VSCode extension for Interactive Preview of Vega and Vega-Lite maps 🗺️ and graphs 📈.
GistPad 📘	VS Code extension for managing and sharing code snippets, notes and interactive samples using GitHub Gists.
VSCode Map Preview	VSCode extension for visually previewing geospatial file content (GeoJSON, KML, etc) on a map.
Geo Tools	Geo Tools VSCode extension allows you to easily interact with geographical data.
Hex Editor	Allows Hex Editing inside VS Code.

Dev Log

See #GeoDataViewer 🗺️ tag on Twitter for the latest and greatest updates on this vscode extension development, new features, and usage statistics.

Dev Build

$ git clone https://github.com/RandomFractals/geo-data-viewer
$ cd geo-data-viewer
$ npm install
$ code .

F5 to launch Geo Data Viewer 🗺️ extension VSCode debug session.

Support

Become a Fan to sponsor our dev efforts on this and other Random Fractals, Inc. code and data viz extensions if you find them useful, educational, or enhancing your daily dataViz dev code workflows and geo spatial analysis:

☕️ https://ko-fi.com/dataPixy 💖 https://github.com/sponsors/RandomFractals

RandomFractals / geo-data-viewer

readme