sharpred / garmin

Generate garmin map images from OSM data

Introduction

This project is for creating Garmin maps from OSM data. See https://wiki.openstreetmap.org/wiki/Mkgmap/help/How_to_create_a_map for complete instructions.

The map data (*.pbf) files in this folder were downloaded from https://download.geofabrik.de

Locations

Canary Islands

Great Britain

Ireland

Other European Countries

Split the PBF file into tiles

Use a command like;

java -Xmx2000M -jar splitter.jar regions/canary-islands-latest.osm.pbf --output-dir=out/canaryislands

Get the bounds data

Bounds can be downloaded from http://osm.thkukuk.de/data/bounds-latest.zip

Get the precompiled sea data

Seah data can be downloaded from http://osm.thkukuk.de/data/sea-latest.zip

Splitter Commands used

java -Xmx2000M -jar splitter.jar regions/canary-islands-latest.osm.pbf --output-dir=out/canaryislands --mapid=73240001
java -Xmx2000M -jar splitter.jar regions/spain-latest.osm.pbf --output-dir=out/spain --mapid=93240001


java -Xmx2000M -jar splitter.jar regions/ireland-and-northern-ireland-latest.osm.pbf --output-dir=out/ireland --mapid=53240001
java -Xmx2000M -jar splitter.jar regions/great-britain-latest.osm.pbf --output-dir=out/gb --mapid=83240001

java -Xmx2000M -jar splitter.jar regions/italy-latest.osm.pbf --output-dir=out/italy --mapid=13240001
java -Xmx2000M -jar splitter.jar regions/dach-latest.osm.pbf --output-dir=out/dach --mapid=23240001
java -Xmx2000M -jar splitter.jar regions/sweden-latest.osm.pbf --output-dir=out/sweden --mapid=33240001
java -Xmx2000M -jar splitter.jar regions/sweden-latest.osm.pbf --output-dir=out/sweden --mapid=43240001
java -Xmx2000M -jar splitter.jar regions/ireland-and-northern-ireland-latest.osm.pbf --output-dir=out/ireland --mapid=53240001

Jan 2021 run

I used

java -Xmx2000M -jar splitter.jar \
  regions/great-britain-latest.osm.pbf \
  --output-dir=out/gb \
  --mapid=83240001 \
  --description="OSM GB Jan 2021"

java -Xmx2000M -jar mkgmap.jar \ 
 --route \
 --add-pois-to-areas \
 --precomp-sea=data/sea-latest.zip \
 --bounds=data/bounds-latest.zip \
 --index \
 --gmapsupp \
 --cycle-map \
 --output-dir=images/gb/ \
 -c out/gb/template.args \
 --mapname=83240001 \
 out/gb/8324*.osm.pbf

use run.sh to run everything in one script. Edit the file to change the description of the resultant map. The file images/gmapsupp.img should be copied to the Garmin folder of the SD card in your Garmin device.

Splitter subsequent runs

If you use the generated areas.tiles file and areas.poly file, it makes subsequent processing quicker. See

java -Xmx2000M -jar splitter.jar regions/canary-islands-latest.osm.pbf --output-dir=out/canaryislands --precomp-sea=data/sea-latest.zip --polygon-file=out/canaryislands/areas.poly --split-file=out/canaryislands/areas.list --description="OSM Canary Islands Map"

note also that precomp-sea can be used in the same way it is used for mkgmap

note the description passed to the command (this gets stored in the generated template.args file)

MkgMap Command

Create the Garmin Map

Use a command like;

java -Xmx2000M -jar mkgmap.jar --route --add-pois-to-areas --bounds=bounds --index --cycle-map  --gmapsupp out/canaryislands/6324*.osm.pbf --output-dir=images/canaryislands

Concatenate two maps (had problems getting this to work)

Use a command like;

java -Xmx2000M -jar mkgmap.jar --gmapsupp your-existing-map.img map-you-want-to-add.img

I had problems getting maps to concatenate using mkgmap so I changed the mapid for each location used and then created a single map image. even with this I had memory issues creating a large map with all locations, so best just to create separate images for the locations you need.

java -Xmx2000M -jar mkgmap.jar --route --add-pois-to-areas --precomp-sea=data/sea-latest.zip --bounds=data/bounds-latest.zip --index --gmapsupp tiles/*.osm.pbf --cycle-map --output-dir=images/

Using pregenerated template data

You can pass the template.args file created by splitter as an argument to mkgmap. See

java -Xmx2000M -jar mkgmap.jar --route --add-pois-to-areas --precomp-sea=data/sea-latest.zip --bounds=data/bounds-latest.zip --index --gmapsupp --cycle-map --output-dir=images/gb/ -c out/gb/template.args --mapname=83240001 out/gb/8324*.osm.pbf