Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A basic style for mkgmap designed for on-road cycling.

This style is intended to remove many features not relevant and result in the smallest possible file for import into a simple cycling GPS such as Garmin's Edge 520.

For example, the principality of Andorra (468 km²):


Example execution

java -Xms512m -Xmx4096m -jar mkgmap.jar -c mkgmap.options andorra-latest.osm.pbf

Large Areas

Using this style mkgmap requires OSM data as input, but at this time it's unclear as to if a subset of this data (eg: just those elements such as roads, etc) is available so full OSM data is used as input.

Unfortunately large areas cannot be processed with mkgmap unless there is a lot of RAM availbale to the JVM. However, a large Garmin output file can still be created by processing OSM data in chunks and then merging the created images. In order to do this simple use of the mapname command line argument is required (otherwise all maps are output with the default name and merging is not possible due to this overlap).

Note that the author has been unable to have mkgmap successfully merge multipe image outputs but GMapTool has been found to work.

Merging Execution

For example, merge three Southern French departments:

java -Xms512m -Xmx4096m -jar mkgmap.jar -c mkgmap.options --mapname=1 aquitaine-latest.osm.pbf
java -Xms512m -Xmx4096m -jar mkgmap.jar -c mkgmap.options --mapname=2 midi-pyrenees-latest.osm.pbf
java -Xms512m -Xmx4096m -jar mkgmap.jar -c mkgmap.options --mapname=3 languedoc-roussillon-latest.osm.pbf
gmt -j 1.img 2.img 3.img -o gmapsupp.img

Example renders

Below are example renders (with QMapShack) of Andorra using Openfietsmap & mkgmap-bike-onroad for comparison:

mkgmap-bike-onroad: Eg1

Openfietsmap: Eg1

mkgmap-bike-onroad: Eg2

Openfietsmap: Eg2

mkgmap-bike-onroad: Eg3

Openfietsmap: Eg3


A basic style for mkgmap designed for on-road cycling




No releases published
You can’t perform that action at this time.