Awesome
mapeo-mobile
Monitor and document the world around you
Mapeo Mobile is a mobile app (currently Android only) for offline mapping and monitoring.
Table of Contents
⚠ Compatibility & Stability
Mapeo Mobile v2 is unable to sync with Mapeo Mobile v1, due to a change in the way synchronization works. You will need to update all devices to v2 or higher in order to continue syncing.
Due to this sync change, Mapeo Mobile v2 is also unable to sync with Mapeo Desktop v4 or v3. You will need to update Mapeo Desktop to v5 or higher in order to continue syncing.
Mapeo Mobile is currently in Beta. This means that there might be frequent changes to the user interface and there may be changes that break the ability to sync with older versions unless every device updates. We understand that this is an inconvenience if many users are offline and unable to update more easily, and when the sync protocol is more stable we will move Mapeo out of beta and work on a way of updating offline clients offline during sync.
Mapeo Mobile is already being used in the field with dozens of local community partners and is stable and reliable enough for real-world usage, and we work hard to ensure that no data is lost during updates.
You will also see Alpha releases on the releases page. These should be regarded as unstable and likely to crash / not work. We use the Alpha releases for internal testing and once it is stable enough we release it as a Beta. If you don't mind things breaking we really welcome others being able to test the latest Alpha and sending us feedback about any bugs you find.
Install
Download the latest release APK file and install manually on your Android phone.
Usage
Custom presets
Presets must be placed in this folder:
/sdcard/Android/data/com.mapeo/files/presets/default
This folder (default) should contain these files directly in under this
default folder (i.e. no sub-folder with a different name):
presets.json
icons/
myIcon-medium@1x.png
myIcon-medium@2x.png
myIcon-medium@3x.png
...etc
Offline Maps
First find out the bouding box of the map area that will be downloaded using the boundingbox online tool. Use the CSV Copy & Paste option to display the coordinates in the correct format.
Then install mapbox-style-downloader:
npm i -g mapbox-style-downloader
Get a Mapbox API token and select a Mapbox style.
Use mapbox-style-downloader to download styles, tiles, glyphs, and sprites for offline use:
mapbox-style download mapbox://styles/mapbox/streets-v9 \
--asar \
--token='MAPBOX_API_TOKEN' \
-o styledir \
-z 8 \
-Z 13 \
-b '-60.1364 1.5626 -58.0627 3.475'
Check that everything was downloaded correctly with mapbox-style serve inside the styledir directory.
Connect phone to computer or move the files to a SD card or USB drive (an adapter will be needed).
Offline maps must be placed in this folder:
/sdcard/Android/data/com.mapeo/files/styles/default
⚠ with different mapeo releases
com.mapeochanges, ex.:com.mapeo.debug
From the computer adb push can be used. Make sure you have adb installed. Use like so:
adb push /path/to/styledir/* /sdcard/Android/data/com.mapeo/files/styles/default
This folder should contain these files directly under this default folder:
style.json
fonts/
tiles/
my-offline-tiles.asar
...maybe more
Translations
Mapeo is designed to be used in any language, but we rely on volunteers like you to help with translations. You can see current translation status on the Crowdin project page.
If you would like to add translations in your language, you can sign up to Crowdin and being translating immediately.
If you would like your language added to the translations list, please request it.
Maintainers
Community
Connect with the Mapeo community for support & to contribute!
Contributing
PRs accepted.
Small note: If editing the README, please conform to the standard-readme specification.
Supporters
We are extremely grateful to companies that embrace open source and support Mapeo Mobile with services-in-kind:
License
GPLv3 © 2019 Digital Democracy