lukasmartinelli/natural-earth-vector-tiles repository overview

⁠Natural Earth Vector Tiles

Prerendered Natural Earth⁠ vector tiles encoded in the Mapbox vector tile specification⁠ for use with Mapbox GL or other clients. Currently in heavy development

:open_file_folder: Download the vector tiles from the releases page⁠.

Please also checkout our project to create vector tiles from Open Street Map⁠.

⁠Use Vector Tiles

You can use mbview⁠ to take a look at the MBTiles vector tiles locally. To display the vector tiles with Mapbox GL you need a tileserver.

Tileservers:

• tessera⁠
• tileserver-gl-light⁠
• tileserver-gl⁠

⁠Run Workflow

The entire project is structured components using Docker containers to work together. Ensure you meet the prerequisites.

• Install Docker⁠
• Install Docker Compose⁠

Start up the PostgreSQL database with the PostGIS extension.

docker-compose up -d postgres

Now import the Natural Earth and WWF data set (can take several minutes).

docker-compose run import-naturalearth
docker-compose run import-wwf

Import the required database schema (views, prepared tables and helper functions).

docker-compose run db-schema

Export the vector tiles for the planet (can take up to 15min). The exported vector tiles are stored in data/natural_earth.mbtiles.

docker-compose run export-vectortiles

To visualize and work with the vector tiles you can spin up Mapbox Studio in a Docker container and visit localhost:3000.

docker-compose up mapbox-studio

⁠License

The produced vector tiles are licensed under the Open Database License⁠ and are made with data originating from Natural Earth⁠.

The source code is Copyright (c) Lukas Martinelli under BSD-3 as defined in License⁠. The vector data source in src/vector-data-source is partially derived from mapbox/natural-earth-tm2⁠ and therefore retains Copyright (c) Mapbox under BSD-3 as defined in License⁠.