Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Java Python HTML Shell NSIS Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Making maps for Garmin GPS units ================================ The goal of the project is to take the map data from OpenStreetMap <http://www.openstreetmap.org> and to generate a map in the Garmin file format so that it can be loaded onto Garmin GPS units. The original motivation was to help plan mapping sessions, but now the maps are becoming useful in their own right. Using ===== This program requires Java 1.6 or above to run. Producing a map is simple. Save OpenStreetMap data from JOSM or by any other method to a file and copy it to the mkgmap directory. In the following examples this file is called data.osm. Run the command: java -jar mkgmap.jar data.osm This will produce a file called 63240001.img. You can copy the map to your Garmin GPS unit in any way you know how. It is best to use a SD card, since then if anything goes wrong you can remove it from the unit and all should be well again. Copy it to the file "Garmin/gmapsupp.img" on the card. On many modern Garmin devices, you can use a different name so that you can have more than one set of maps. *NOTE* this will overwrite any other map you have on there, make sure that you are not overwriting a valuable map. Another way would be to use a USB memory card writer and for a large map this is quicker as many GPS's have a slow USB connection. There are also various programs that can send a map to the device. You should (depending on the particular Garmin model) see a OSM copyright message on starting up, and the map name 'OSM Street map' should appear in the map setup section. For more help see: http://www.mkgmap.org.uk/doc/index.html Invoking mkgmap -------------- Most of the default names mentioned in the previous section can be altered by suitable options. Run java -jar mkgmap.jar --help=options to obtain an up to date and complete listing of options. Processing more than one file at a time --------------------------------------- The Garmin map format was designed so that a map is made of a number of tiles, and if your map has more data than can fit into a single tile, you will have to split the map. See: http://www.mkgmap.org.uk/doc/splitter.html for a program that can do this. You can compile all of the map tiles that are created by splitter all at once, by simply listing them all on the command line. Acknowledgements ================ This project is almost entirely based on the file format specification document written by John Mechalas at the SourceForge project at http://sourceforge.net/projects/garmin-img. The 'imgdecode' program from the same source was also very important in checking that I was on the right lines to producing a good file. Thanks. Steve