https://github.com/sodascience/map-explorer
Map Explorer is a Vue.js web application for rendering GeoJSON maps with dynamic region coloring based on external data.
https://github.com/sodascience/map-explorer
choropleth data-analysis data-visualization geojson
Last synced: 6 months ago
JSON representation
Map Explorer is a Vue.js web application for rendering GeoJSON maps with dynamic region coloring based on external data.
- Host: GitHub
- URL: https://github.com/sodascience/map-explorer
- Owner: sodascience
- License: mit
- Created: 2025-04-28T18:05:58.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-06-27T15:00:54.000Z (7 months ago)
- Last Synced: 2025-06-27T15:46:33.847Z (7 months ago)
- Topics: choropleth, data-analysis, data-visualization, geojson
- Language: Vue
- Homepage: https://sodascience.github.io/map-explorer/
- Size: 8.62 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Map Explorer
[](https://www.repostatus.org/#active)
## Overview
This repository contains a Vue.js web application that renders GeoJSON maps with dynamic region coloring. The application imports geographic boundary data in GeoJSON format and applies colors to regions based on external datasets (see `/public`). It can use any GeoJSON as the basis for the map and it can use a dataset to determine the coloring of the region.
Everything runs locally in the browser with [duckdb-wasm](https://github.com/duckdb/duckdb-wasm) as the underlying SQL online analytical processing (OLAP) database.
## Features
- Import custom GeoJSON files for map boundaries
- Upload datasets to determine region coloring
- Browser-based processing with no server required
- Real-time filtering and mapping of very large datasets
## Quick Start
### Online Demo
Visit the GitHub Pages website of this project [here](https://sodascience.github.io/map-explorer/) and check out the example.
You can import your own GeoJSON and data files to determine the coloring of the regions, using the "Import Data". In the datafile make sure that given an applied filtering each row maps a region to value.
### Local Development
**Prerequisites**
- Node.js and npm installed
**Installation**
1. Clone or fork the repository:
```sh
git clone https://github.com/sodascience/map-explorer.git
```
2. Navigate to the project directory:
```sh
cd map-explorer
```
3. Install dependencies:
```sh
npm install
```
4. Start the development server:
```sh
npm run dev
```
## Embedding
If you want to embed this application into your own website you can do so by including it into an iframe, like so:
```html
```
## Contact
This is a project by the [ODISSEI Social Data Science (SoDa)](https://odissei-soda.nl) team.
Do you have questions, suggestions, or remarks on the technical implementation? Create an issue in the [issue tracker](https://github.com/sodascience/map-explorer/issues) or feel free to contact [Niek de Schipper](https://github.com/trbknl).
