Archived

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.

Mike C 9dd1714535 Fixup README formatting

2017-01-20 12:39:55 -05:00

1.6 KiB

Raw Blame History

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 minuse 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

1.6 KiB Raw Blame History