mapeo-mobile

Monitor and document the world around you

Mapeo Mobile is a mobile app (currently Android only) for offline mapping and monitoring.

Compatibility & Stability
Install
Usage
Translations
Maintainers
Contributing
License

⚠ 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.mapeo changes, 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!

Discord

Contributing

See the contributing file!

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:

digidem / mapeo-mobile

readme