kemonine/osm_map_processing
Archived
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Update docs to be more useful

Browse source
This commit is contained in:
Mike C 2017-01-20 12:38:42 -05:00
parent c67b371856
commit 9e06727ecb
2 changed files with 56 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
README.md
View file

@ -1,31 +1,39 @@
Overview Overview
= =
This project contains useful info/tools for processing OSM maps into the mapwriter file format (.map) 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.
Manual Procedure Dependencies / Prereqs
= =
To run this program you'll need the following
Prep * A Linux environment
== * Python 3.x installed
- Download updated maps: http://download.geofabrik.de/north-america.html and http://download.geofabrik.de/north-america/canada.html * Java 1.8 or higher installed (OpenJDK works)
- Pull latest osmosis from http://wiki.openstreetmap.org/wiki/Osmosis * wget installed
- Pull latest mapsforge for osmosis from https://github.com/mapsforge/mapsforge/blob/master/docs/Downloads.md * bunzip2 installed (usually part of bzip2 package)
Process maps for device Installation
== =
- Setup osmosis in a directory (unzip release -- ZIPBOMB ALERT!!!!) 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.
- Create plugins directory under osmosis
- Move mapsforge release jar to osmosis/lib/default/ Running
- Decompress maps (if they were previously compressed) =
- ./osmosis bin/osmosis --rb file=../maps/a_map.osm.pbf --mapfile-writer file=../maps/a_map.map 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.
-* If you run out of heap space add JAVACMD_OPTIONS="-Xmx16g" to the start of the line
-* If increasing the heap doesn't work, append type=hd to end of command Program Usage
-* You can merge maps using --merge passed to osmosis (before --mapfile-writer) using n-1 instances of --merge where n is the number of --rb or --rx options passed =
usage: process_maps.py [-h] [--map-list MAP_LIST] [--no-sleep] [--use-ram]
General Notes
= optional arguments:
Used to generate above info -h, --help show this help message and exit
* https://github.com/mapsforge/mapsforge/blob/master/docs/Getting-Started-Map-Writer.md --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 Licencing
= =

25
manual_processing.md Normal file
View file

@ -0,0 +1,25 @@
Manual Procedure
=
Prep
==
- Download updated maps: http://download.geofabrik.de/north-america.html and http://download.geofabrik.de/north-america/canada.html
- Pull latest osmosis from http://wiki.openstreetmap.org/wiki/Osmosis
- Pull latest mapsforge for osmosis from https://github.com/mapsforge/mapsforge/blob/master/docs/Downloads.md
Process maps for device
==
- Setup osmosis in a directory (unzip release -- ZIPBOMB ALERT!!!!)
- Create plugins directory under osmosis
- Move mapsforge release jar to osmosis/lib/default/
- Decompress maps (if they were previously compressed)
- ./osmosis bin/osmosis --rb file=../maps/a_map.osm.pbf --mapfile-writer file=../maps/a_map.map
* If you run out of heap space add JAVACMD_OPTIONS="-Xmx16g" to the start of the line
* If increasing the heap doesn't work, append type=hd to end of command
* You can merge maps using --merge passed to osmosis (before --mapfile-writer) using n-1 instances of --merge where n is the number of --rb or --rx options passed
General Notes
=
Used to generate above info
* https://github.com/mapsforge/mapsforge/blob/master/docs/Getting-Started-Map-Writer.md