/basemaps

Basemap PMTiles generation and cartographic styles for MapLibre GL

Primary LanguageTypeScriptOtherNOASSERTION

Protomaps Basemaps

This repository has two core parts:

  • tiles/: A Planetiler build profile that generates planet.pmtiles from OpenStreetMap and Natural Earth in 2-3 hours on a modest computer.
  • base/: A TypeScript package that generates MapLibre GL styles, in multiple color themes, that can be used via npm or exported as JSON.

Usage

You will need Java 17+ and Maven installed, which is available in most package managers.

Generate and inspect a basemap PMTiles of any named area:

  1. Clone this repository.
git clone git@github.com:protomaps/basemaps.git
  1. change to the tiles directory, download dependencies and compile the JAR:
mvn clean package
  1. Download and generate monaco.pmtiles in the current directory:
java -jar target/*-with-deps.jar --download --force --area=monaco
  1. Switch to the compare/ directory to run the map compare tool:
cd compare
npm run serve

License

BSD 3-clause. The organization of layers and features used by these map styles, as well as the "look and feel" of the resulting maps, are licensed CC0. However, maps using the Protomaps web map service or another OpenStreetMap-based service will be subject to the terms of the Open Database License.