by QwantResearch

QwantResearch / qwantmaps

Central repository for Qwant Maps resources

220 Stars 17 Forks Last release: over 1 year ago (v0.1.2) Apache License 2.0 40 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Qwant Maps

Qwant Maps is a map application that respects your privacy. It is an opensource project, learn how you can contribute!

Qwant Maps screenshot - Serving suggestion

Qwant Maps URL

Qwant Maps provides links you can share with your friends to help them to #SwitchToQwant and #SwitchToOSM. For instance you can: - search for a specific location on the map with the following format:

  • search a specific place on the map with the following path:
    https://www.qwant.com/maps/place/osm:node:[email protected]_de_Lyon

A routing request

This endpoint points to a routing form and can pre-fill some of the fields. For instance:

https://www.qwant.com/maps/routes/?origin=latlon:48.8459543:[email protected]_de_Lyon&destination=latlon:48.8702200:2.2786330&arrival_datetime=20160613T135400&mode[]=walking#map=18.00/48.8459543/2.3714015
The parameters corresponding to this endpoint are the following:

| Name | Required| Description | | -------- | :--------: | -------- | | origin | :x: |

of some place to use as the starting point | | destination | :x: |
of some place to use as the ending point | | mode | :x: | if you want to pre-select a routing mode in the routing form. One of


Qwant Maps can be seen as 4 separated components:

  • a tile server,
  • a search engine (geocoder),
  • an API to detail points of interest and places,
  • a front end.

Tile server

A tile server is a service whose job is to give all that is needed to display a fraction of a map.

Qwant Maps provides only vector tiles so the tile server does not serve images (as it is done with raster tiles) but raw data. It is the front end, Erdapfel, that takes the data and renders it into a user browsable map.

The tile server is a combination of 2 great opensource projects:

  • kartotherian, the Wikimedia stack to have a highly available tile server. It is itself based on a number of mapbox components,
  • OpenMapTiles, for their great and flexible tile schema.

OpenMapTiles makes it possible for Qwant Maps to have an easy to define/extend vector tile schema.

All the data (see below) are imported in a PostgreSQL database using mainly imposm. All the world's vector tiles are then generated using kartotherian's tilerator and stored in Cassandra. This enables Qwant Maps to have a fast and scalable way to serve tiles.


The geographical search engine (also called geocoder) used for Qwant Maps is Mimirsbrunn.

Mimirsbrunn is a geocoder based on Elasticsearch and rust components developed by Kisio Digital.

Places API

To get more details on places and Points Of Interest (POIs), Qwant Maps uses an additional API: Idunn, that combines the information in the geocoder with external APIs to format detailed POIs data to display in the front end.

Front end

Qwant Maps's front, Erdapfel, is a Javascript single page app that allows to browse the map, search for places, see your position on the map, etc. You can also save your favorite places, using Masq.

The front end uses Mapbox GL to render the map, using both the tiles from the tile server, and Qwant Maps custom map style.


Tiles data

The main source of data for the tile server is the awesome OpenStreetMap (OSM) data :heart: but other data like natural earth, better water polygon... are also used.

All the tile's data import process is defined in a python script.

This script imports all the data in the PostgreSQL database and runs lots of post-process SQL functions (those functions are defined as postgresql triggers), so they will also be able to run on the OSM updates.

When the data is loaded in PostgreSQL, we use tilerator to generate all the tiles from the zoom level 0 to 14 and store them in Cassandra. This way, when a vector tile is requested to the tiles API kartotherian, no computation needs to be done, only a simple query by id on the highly available Cassandra to get the raw protobuf tiles stored in it.

Geocoder data

The data import process in Mimirsbrunn is defined in a python script.

First, the OSM data is given to Cosmogony which outputs a big JSON file with all the world's administrative regions.

This file is then imported in Mimir by cosmogony2mimir.

We then import addresses using addresses-importer. It downloads datasets of addresses (from OpenAddresses and OpenStreetMap mostly), deduplicate them and then import them into our geocoder using openaddresses2mimir.

The streets are imported afterwards from the OSM pbf file with osm2mimir.

Finally the POIs are extracted from the PostgreSQL database (thus we have a unified POI handling) using Fafnir.

Places API data

Idunn does not need its own data import process, but the API depends on:

  • the data of the geocoder,
  • Wikipedia data, fetched either on the Wikipedia APIs or in a custom Elasticsearch database.
OSM updates

The world keeps moving and OpenStreetMap data is getting better and better every day, so we need to update the data in all our components on a regular basis. The import of the world's data is quite a long process, so after the initial import, we have a cron job to read the OSM differential updates and apply the diff in the PostgreSQL database on a daily basis.

Once we have up-to-date data in PostgreSQL, we can import again the geocoder POIs data and regenerate the tiles impacted by the changes.

We update the remaining geocoder data (administrative regions, streets and addresses) on a monthly basis.

Global picture

global architecture

NB: To provide the Qwant Maps service, Qwant hosts instances of the tile server, the geocoder and the Idunn API on its own servers.

Please note that Qwant instances are internal components and are not meant (yet) to be used directly other than as part of Qwant Maps. You can learn more in our Terms of services

How to run


To run the tileserver, the easiest way is to use Docker.

The project kartotherian_docker provides a docker-compose with all that is needed.

This repository heavily depends on kartotherian_config that contains the real Qwant Maps business logic:


The repository docker_mimir contains a docker-compose to easily spawn the needed Docker containers and to import the needed data in them.

Places API

Idunn is quite straightforward to use as it is a simple python API (using apistar).

The readme details the way to run it.

Front end

Erdapfel is a simple node application but you can also use Docker to run it.

You will need to set a few environment variables to link it to the other Qwant Maps components. Check out the readme to know more about the config.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.