🗺️ MAPS.ME — Offline OpenStreetMap maps for iOS and Android
Switch branches/tags
Clone or download
Permalink
Failed to load latest commit information.
3party [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
android [android] Generated new strings Sep 21, 2018
api [linux] Fixed project build with g++ 4.8. Oct 21, 2015
base [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
cmake Fixed warn: mangled name for .. will change in C++17 because the exce… Jun 25, 2018
coding [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
data [search][generator] Replace diet:vegetarian, diet:vegan with cuisine Sep 21, 2018
debian Updated desktop EULA. Sep 23, 2015
docs [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
drape [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
drape_frontend [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
editor [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
feature_list [base] Replaced the namespace my with base. Sep 18, 2018
generator Review fixes. Sep 20, 2018
geocoder [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
geometry [base] Replaced the namespace my with base. Sep 18, 2018
indexer unused-private-field clang warning fix in includes. Sep 20, 2018
installer/win [fonts] Replace WenQuanYi MicroHei with Droid Sans Fallback Sep 22, 2015
iphone [android] Generated new strings Sep 21, 2018
kml [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
local_ads [base] Replaced the namespace my with base. Sep 18, 2018
map [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
mapshot Added shaders library Jun 28, 2018
metrics [base] Replaced the namespace my with base. Sep 18, 2018
openlr [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
partners_api [base] Replaced the namespace my with base. Sep 18, 2018
platform [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
pyhelpers Updated the spec in accordance with what Victor said. Sep 13, 2017
qt [base] Replaced the namespace my with base. Sep 18, 2018
qt_tstfrm Usage of shaders library Jun 28, 2018
routing Routing benchmark test build fix. Sep 21, 2018
routing_common Tests on vehicle model on speeds in city and out of cities. Sep 20, 2018
search [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
shaders [base] Replaced the namespace my with base. Sep 18, 2018
skin_generator [base] Replaced the namespace my with base. Sep 18, 2018
software_renderer [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
storage [base] Removed the MY_ prefix from the scope guard. Sep 19, 2018
testing [base] Replaced the namespace my with base. Sep 18, 2018
tizen [base] Replaced the namespace my with base. Sep 18, 2018
tools City roads section and tests. Sep 11, 2018
track_analyzing Review fixes. Sep 20, 2018
track_generator [base] Replaced the namespace my with base. Sep 18, 2018
tracking [base] Replaced the namespace my with base. Sep 18, 2018
traffic [base] Replaced the namespace my with base. Sep 18, 2018
transit [base] Replaced the namespace my with base. Sep 18, 2018
ugc [base] Replaced the namespace my with base. Sep 18, 2018
xcode [android][ios] Updated version to 8.4.0 Sep 21, 2018
.clang-format [clang-format] Updated clang-format rules for ObjC. Oct 4, 2017
.gitattributes [mopub] [ios] Added Mopub framework. Apr 13, 2017
.gitignore remove *sw* from gitignore Aug 27, 2018
.gitmodules [twine] Make twine a submodule, and update it to 1.0.3 Mar 30, 2018
CMakeLists.txt Track generator tool Sep 13, 2018
CONTRIBUTORS Update CONTRIBUTORS Nov 20, 2015
LICENSE [docs] Updated license and texts Sep 29, 2015
NOTICE Fixed NOTICE and README. Sep 30, 2015
README.md Replace http with https for openstreetmap.org links Mar 16, 2018
configure.sh [android] Added network config for open source Sep 21, 2018
defines.hpp [search] Add cuisine search categories. Sep 18, 2018
partners_strings.txt Removed partners from strings Sep 12, 2018
precompiled_headers.hpp [base] Unified stl_add and stl_helpers. Sep 14, 2018
strings.txt [android] Added new strings Sep 21, 2018

README.md

MAPS.ME

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.

Submodules

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

Translations

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

Compilation

To compile the project, you would need to initialize private key files. Run configure.sh 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 INSTALL.md.

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

Building maps

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

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 STYLES.md for the format description, instructions on building a style and some links.

Development

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 CONTRIBUTING.md 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.

Feedback

Please report bugs and suggestions to the issue tracker, or by mail to bugs@maps.me.

Authors and License

This source code is Copyright (C) 2015 My.com 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.