https://github.com/worldbank/static-web-maps

A pipeline for creating an interactive web map portal from geospatial point data. The key feature is that it creates a static website (i.e., no back-end services) that can be hosted on the web or from an usb drive. Based on the kepler.gl framework.
https://github.com/worldbank/static-web-maps

h3 kepler-gl web-maps

Last synced: 12 days ago
JSON representation

A pipeline for creating an interactive web map portal from geospatial point data. The key feature is that it creates a static website (i.e., no back-end services) that can be hosted on the web or from an usb drive. Based on the kepler.gl framework.

• Host: GitHub
• URL: https://github.com/worldbank/static-web-maps
• Owner: worldbank
• License: mpl-2.0
• Created: 2025-07-16T19:16:52.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2026-02-06T23:22:09.000Z (4 months ago)
• Last Synced: 2026-02-07T08:50:16.436Z (4 months ago)
• Topics: h3, kepler-gl, web-maps
• Language: JavaScript
• Homepage:
• Size: 2.75 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: docs/CODE_OF_CONDUCT.md
  • Citation: CITATION.cff

Awesome Lists containing this project

README

          
# Static Web Maps

## Use case

You have high resolution geospatial point data, and you want to create an interactive website for users to be able to explore this data. The website has to be "static" (i.e., it is pre-made, and stays the same for every person that visits it), so that there are no back-end services or complicated hosting set ups. It can be served from the simplest of hosting services (e.g., github pages), on an intranet, or can even be stored, accessed and used from a laptop or a USB drive. Data does not need to be shared or processed by external parties.

When hosted on an USB drive your user simply has to open an html, and can then explore data-intensive maps interactively in a browser.

This application provides the website template and code for structuring your data to generate this ready-to-use interactive mapping portal. The mapping is done in browser by the [kepler.gl](https://kepler.gl) library.

**Question: What kind of maps does this produce?**

The tool is currently set up to produce 2D and 3D hexagonal bin maps.

**Question: Wait, doesn't kepler.gl already provide this functionality?**

Not currently. If you only have one dataset to plot, and you're free to upload it to an external service, then you could use the kepler.gl [demo](https://kepler.gl/demo) to export a single web map as a static html page. In contrast, you can use [static-web-maps](https://github.com/worldbank/static-web-maps) locally on many datasets, and it will create a drop-down within the map portal itself so that your user can switch between as many maps as needed. 

## Usage

#### 1. **Prepare your data**

Assign [h3](https://h3geo.org/docs/highlights/indexing) spatial indices to your data, at your desired level of resolution. You can do this in Python with [h3-py](https://github.com/uber/h3-py). Collapse your data in ways that will make sense to your users. Format your data into CSVs as in the [examples](data/example-csv).

#### 2. **Construct website**

Follow the instuctions in the [user guide](docs/user-guide.md).