This repository has been archived on 2024-07-04. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
2017-01-20 14:24:41 -05:00
bin/osmosis Bump mapsforge writer plugin versions 2017-01-20 12:06:37 -05:00
lists Added Michigan only map 2016-08-28 12:18:31 -04:00
.gitignore Tweak gitignore for tmp folder 2017-01-20 12:06:51 -05:00
LICENSE-APACHE-2.0.txt Added licencing 2016-01-12 17:51:36 -05:00
LICENSE-CC-BY-SA-3.0.html Added licencing 2016-01-12 17:51:36 -05:00
manual_processing.md Update docs to be more useful 2017-01-20 12:38:42 -05:00
poi-mapping.xml Bump mapsforge writer version, prep for mapsforge POI output 2016-08-28 13:07:03 -04:00
process_maps.py Added ability to adjust heap size -- most useful when using --use-ram argument 2017-01-20 14:24:41 -05:00
README.md Fix typo in README 2017-01-20 12:40:34 -05:00

Overview

This project contains useful info/tools for processing OSM maps into the mapwriter file format (.map). It was developed to help generating offline map files for Locus on Android.

Dependencies / Prereqs

To run this program you'll need the following

  • A Linux environment
  • Python 3.x installed
  • Java 1.8 or higher installed (OpenJDK works)
  • wget installed
  • bunzip2 installed (usually part of bzip2 package)

Installation

Head over to releases tab and download the latest. Extract the file and you're good to go. Everything is self-contained minus the above dependencies.

Running

To run the program, cd to the directory where you extracted the release and run './process_maps.py' with at least one '--map-list /path/to/list.txt parameter'. See the lists directory for examples on how to format the map list files.

Program Usage

usage: process_maps.py [-h] [--map-list MAP_LIST] [--no-sleep] [--use-ram]

optional arguments:
  -h, --help           show this help message and exit
  --map-list MAP_LIST  a text file with one map URL per line, can be specified
                       more than once
  --no-sleep           don't sleep between downloads -- WARNING you can easily
                       run into throttling on mirrors if you use this option
  --use-ram            use RAM for mapsforge processing -- WARNING mapsforge
                       uses 10x the map size in RAM for processing (ie. 100Mb
                       map = 1Gb RAM usage), you want a LOT of RAM for this
                       option

Licencing

All code is licensed Apache 2.0 and all non-code is licensed Creative Commons CC-BY-SA-3.0