||1 year ago|
|.github||1 year ago|
|data||1 year ago|
|layers||1 year ago|
|qa||2 years ago|
|.env||1 year ago|
|.env-postgres||1 year ago|
|.gitignore||1 year ago|
|BENCHMARKING.md||3 years ago|
|CONTRIBUTING.md||2 years ago|
|LICENSE.md||5 years ago|
|Makefile||1 year ago|
|QUICKSTART.md||1 year ago|
|README.md||1 year ago|
|UPDATE.md||1 year ago|
|docker-compose.yml||1 year ago|
|openmaptiles.yaml||1 year ago|
|postgres.conf||1 year ago|
|quickstart.sh||1 year ago|
OpenMapTiles is an extensible and open tile schema based on the OpenStreetMap. This project is used to generate vector tiles for online zoomable maps. OpenMapTiles is about creating a beautiful basemaps with general layers containing topographic information. More information openmaptiles.org and openmaptiles.com.
We encourage you to collaborate, reuse and adapt existing layers, or add your own layers. You may use our approach for your own vector tile project. Feel free to fork the repo and experiment. The repository is built on top of the openmaptiles/openmaptiles-tools to simplify vector tile creation.
Please keep in mind that OpenMapTiles schema should display general topographic content. If creating a new layer or expanding an existing layer with a specific theme, please create a fork and invite other community members to cooperate on your topic. OpenMapTiles schema is used in many projects all over the world and the size of the final vector tiles needs to be considered in any update.
- 🔗 Schema https://openmaptiles.org/schema
- 🔗 Docs https://openmaptiles.org/docs
- 🔗 Production package: https://openmaptiles.com/production-package/
- 🔗 Hosting https://www.maptiler.com/cloud/
- 🔗 Create own layer https://github.com/openmaptiles/openmaptiles-skiing
- 🔗 Discuss at the #openmaptiles channel at OSM Slack
You can start from several GL styles supporting the OpenMapTiles vector schema.
We also ported over our favorite old raster styles (TM2).
OpenMapTiles consists out of a collection of documented and self contained layers you can modify and adapt. Together the layers make up the OpenMapTiles tileset.
To work on OpenMapTiles you need Docker.
Build the tileset.
git clone https://github.com/openmaptiles/openmaptiles.git cd openmaptiles # Build the imposm mapping, the tm2source project and collect all SQL scripts make
You can execute the following manual steps (for better understanding)
or use the provided
Prepare the Database
Now start up the database container.
Download OpenStreetMap data extracts and store the PBF file in the
make download-geofabrik area=albania
Import OpenStreetMap data with the mapping rules from
build/mapping.yaml (which has been created by
make). Run after any change in layers definition. Also create borders table using extra processing with osmborder tool.
make import-osm make import-borders
Import labels from Wikidata. If an OSM feature has Key:wikidata, OpenMapTiles check corresponding item in Wikidata and use its labels for languages listed in openmaptiles.yaml. So the generated vector tiles includes multi-languages in name field.
This step uses Wikidata Query Service to download just the Wikidata IDs that already exist in the database.
Work on Layers
Each time you modify layer SQL code run
make clean make make import-sql
Now you are ready to generate the vector tiles. Using environment variables
you can limit the bounding box and zoom levels of what you want to generate (
Products or services using maps derived from OpenMapTiles schema need to visibly credit "OpenMapTiles.org" or reference "OpenMapTiles" with a link to https://openmaptiles.org/. Exceptions to attribution requirement can be granted on request.
For a browsable electronic map based on OpenMapTiles and OpenStreetMap data, the credit should appear in the corner of the map. For example:
For printed and static maps a similar attribution should be made in a textual description near the image, in the same fashion as if you cite a photograph.