43 lines
1.6 KiB
Markdown
43 lines
1.6 KiB
Markdown
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
|