Skip to content
🗺️ MAPS.ME — Offline OpenStreetMap maps for iOS and Android
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
3party [storage] Fixing the (logical) race on the diffs cancellation result. Mar 18, 2019
android [strings] Generated strings. Mar 18, 2019
base Several explicit constructors per the Cppcheck report. Mar 11, 2019
cmake [ios] tls certificate code improvements Oct 17, 2018
coding [coding] Removed JoinFoldersToPath. Mar 19, 2019
debian Updated desktop EULA. Sep 23, 2015
docs Update directories in CONTRIBUTING.MD Mar 12, 2019
drape_frontend Review fixes Mar 20, 2019
editor [coding] Removed JoinFoldersToPath. Mar 19, 2019
feature_list Review fixes. Mar 18, 2019
geocoder [geocoder] Fix test Mar 11, 2019
installer/win [fonts] Replace WenQuanYi MicroHei with Droid Sans Fallback Sep 22, 2015
iphone [iOS] Added appropriate keyboardDismissMode for the search tabs Mar 18, 2019
kml [KML] Added new access rules AuthorOnly for web edited bookmarks. Jan 17, 2019
mapshot [vulkan] Fixed Linux compilation Mar 1, 2019
metrics [core] Small fixes. Jan 23, 2019
openlr [coding] Removed JoinFoldersToPath. Mar 19, 2019
partners_api clang-format Feb 13, 2019
pyhelpers Add version to all PYBINDINGS modules. Jan 15, 2019
qt_tstfrm Usage of shaders library Jun 28, 2018
routing_common [routing] Fix warnings from static analyzer Feb 27, 2019
search [search] [assessment-tool] Stopped filling unknown positions in sampl… Mar 21, 2019
shaders [coding] Removed JoinFoldersToPath. Mar 19, 2019
skin_generator [base] Replaced the namespace my with base. Sep 18, 2018
stats [cmake] Add precompiled headers support Jun 15, 2018
std Review fixes. Apr 24, 2018
testing [base] Replaced the namespace my with base. Sep 18, 2018
tizen [coding] Renamed the StringUtf8Multilang files. Dec 13, 2018
track_analyzing [indexer] Disallow copy and move of FeatureType, remove FeatureType::… Mar 18, 2019
track_generator Track generator bindings. Mar 11, 2019
tracking Add version to all PYBINDINGS modules. Jan 15, 2019
xcode [iOS] retrun armv7 support Mar 18, 2019
.gitignore [Vulkan] Added SPIR-V shaders generator Mar 1, 2019
.gitmodules [vulkan] Fixed submodule Mar 1, 2019
NOTICE Fixed NOTICE and README. Sep 30, 2015 Replace http with https for links Mar 16, 2018
precompiled_headers.hpp [base] Unified stl_add and stl_helpers. Sep 14, 2018


MAPS.ME is an open source cross-platform offline maps application, built on top of crowd-sourced OpenStreetMap data. It was publicly released for iOS and Android.


This repository contains submodules. Clone it with git clone --recursive. If you forgot, run git submodule update --init --recursive.


If you want to improve app translations or add more search synonyms, please check our wiki.


To compile the project, you would need to initialize private key files. Run and press Enter to create empty files, good enough to build desktop and Android debug packages.

For detailed installation instructions and Android/iOS building process, see

Nightly builds for Android are published to and Dropbox: release, debug.

Building maps

To create one or many map files, first build the project, then use script from tools/unix to create a single mwm file from pbf/o5m/bz2 source, or to generate multiple countries at once from a planet o5m file. See detailed instructions in

Map styles

MAPS.ME uses its own binary format for map styles, drules_proto.bin, which is compiled from MapCSS using modified Kothic library. Feature set in MWM files depends on a compiled style, so make sure to rebuild maps after releasing a style.

For development, use MAPS.ME Designer app along with its generator tool: these allow for quick rebuilding of a style and symbols, and for producing a zoom-independent feature set in MWM files.

See for the format description, instructions on building a style and some links.


You would need Qt 5 for development, most other libraries are included into the repository: see 3party directory. The team uses mostly XCode and Qt Creator, though these are not mandatory. We have an established coding style.

See for the repository initialization process, the description of all the directories of this repository and other development-related information.

All contributors must sign a Contributor Agreement, so both our and their rights are protected.


Please report bugs and suggestions to the issue tracker, or by mail to

Authors and License

This source code is Copyright (C) 2015 B.V. (Mail.Ru Group), published under Apache Public License 2.0, except third-party libraries. See NOTICE and data/copyright.html files for more information.

You can’t perform that action at this time.