From OpenStreetMap Wiki
Jump to navigation Jump to search
OpenMapTiles using the KlokanTech Streets style.png
Author MapTiler and other contributors.
License BSD
Platforms Windows, Linux, macOS, and Docker
Source code

OpenMapTiles using the KlokanTech Streets style

OpenMapTiles is a project aiming to create world maps from open data. It consists of a set of tools allowing everyone to create their own vector map tiles from OpenStreetMap data for hosting, self-hosting, or offline use. It is available as free software on There is also a spin-off project called with ready-to-use pre-generated map tiles and MapTiler Cloud for map hosting.

OpenMapTile is a successor to OSM2VectorTiles.


The OpenMapTiles project consists of several components. The major ones are Open Vector Tile Schema, tools for creating vector tiles from OSM data and Open Map Styles.

Open Vector Tile Schema describes data layers and attributes. It is documented and easily extendable.

Tools for creating vector tiles from OSM data takes OSM data as an input and produces MBTiles containing PBF as an output.

Open Map Styles are ready-to-use map styles for vector scheme. They are available under a free license and therefore can be modified and reused.

Displaying map

The final map can be displayed in the browser using most popular JavaScript libraries like Mapbox GL JS, OpenLayers, Leaflet, in mobile applications using Mapbox GL Native (for both Android and iOS), using WMTS and WMS services, or as a static map for print and export.

OpenMapTiles on-the-fly language change


OpenMapTiles supports more than 50 languages. The names are taken from OpenStreetMap and enhanced by adding data from Wikidata. There is an option to display names in a selected language, a native language for each country, or a combination of the selected and native language.


The big advantage of vector tiles is the separation of data and styles. Therefore it is possible to use the same data with more styles, which can be adjusted on-the-fly.

OpenMapTiles use Mapbox Style Specification, where a style is a JSON object.

   "id": "building",
   "type": "fill",
   "source": "openmaptiles",
   "source-layer": "building",
   "minzoom": 4,
   "paint": {
     "fill-color": "#ccc",
     "fill-outline-color": "#333",
     "fill-opacity": 0.5
Maputnik color adjustment

The style can be edited in any text editor or visually in Maputnik, an open-source visual style editor.

Supported coordinate systems

OpenMapTiles also supports other coordinate systems than Mercator. The result is compatible with JavaScript viewers, mobile SDK, as WMTS or WMS,

OpenMapTiles Map Server

OpenMapTiles Map Server is a software package for Docker. It contains all the parts of OpanMapTiles you need for running your own map. The setup is easy and straightforward; you can serve your own maps in less than 10 minutes.


There is a graphical setup for Windows and Mac called Kitematic. On Linux, all you have to do is to run those two commands as root:

curl -sSL | sh

docker run --rm -it -v $(pwd):/data -p 8080:80 klokantech/openmaptiles-server

The first script will download and install Docker, the second will run OpenMapTiles Map Server on your localhost on port 8080.

Once installed, there is a web wizard for settings, where you can choose which region you want to serve, the style used, and if you want to run additional services.

Since rendering one's own tiles is time and resource consuming, offers pre-rendered tiles for the whole world.

There is a free plan for open-source and open-data websites, non-commercial personal projects, and testing purposes. There are also paid plans, which come with premium styles, hillshading, contour lines, a terrain model, and satellite imagery.

Tiles can be selected by regions, countries, continents, or the whole planet. There is also an option for extract defined by bounding box.

MapTiler Cloud

MapTiler Cloud (formally known as provides hosting of map tiles from It is also run by Klokan Technologies. It provides vector tiles (for Mapbox SDK, native MVT clients) as well as raster tiles (Leaflet, OpenLayers, XYZ), map WMTS services for QGIS and ArcGIS and static maps for thumbnailing or output printing.

The policy is similar to there is a free plan for non-commercial and testing purposes as well as the paid one, which comes with premium styles, hillshading, contour lines, and satellite imagery.

The whole service is cached on CDN with more than 100 places. The core runs in two fully redundant datacenters in Europe and North America, which have DDOS protection and load-balancers with failover and more.


OpenMapTiles requires attribution on screen in the form "© MapTiler © OpenStreetMap contributors", see their terms.

Source code

OpenMapTiles is developed by Klokan Technologies and available as free software under a combination of BSD and MIT licenses.

It is the successor of OSM2VectorTiles, which was a student bachelor thesis at HSR Rapperswil.

The source code is available on GitHub.

Bug reporting

Bug reports, as well as other issues, should be reported through the GitHub repositories.