osm_map_processing/README.md

Overview
=
This project contains useful info/tools for processing OSM maps into the mapwriter file format (.map)

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

Licencing
=
All code is licensed Apache 2.0 and all non-code is licensed Creative Commons CC-BY-SA-3.0
Added notes that were used to create the tool 2016-01-12 19:12:34 +00:00			`Overview`
			`=`
initial project creation 2016-01-12 19:11:05 +00:00			`This project contains useful info/tools for processing OSM maps into the mapwriter file format (.map)`
Added notes that were used to create the tool 2016-01-12 19:12:34 +00:00
			`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`
Added licencing 2016-01-12 22:51:36 +00:00
			`Licencing`
			`=`
			`All code is licensed Apache 2.0 and all non-code is licensed Creative Commons CC-BY-SA-3.0`