egeberkyurtkoruyan / 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

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.

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 🗺️

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 🌐:

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:

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

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