This package has the code to read in a file that is in the Open Street Map format (.osm files). OSM uses an XML format.
Version 0.4 of the api is no longer supported.
This version of the format does away with segments. Ways are sequences of nodes. As such it matches the format that we require for the Garmin maps much closer than the previous version of the api. Ways cannot branch or have out of order segments, so all the code that deals with that is not required.
The following features of the OSM format need to be addressed to create the map.
The main way of getting a garmin feature code from the OSM tags on a point is to have a table that maps OSM key/value pairs to the Garmin type/sub-type codes. This is fine in many cases, but we will eventually need something more.
A file called feature_map.csv holds the table. In addition it also holds the minimum resolution that the feature will appear at. This determines at which zoom levels a feature appears.
With this style converter you can have several named styles which can be built into mkgmap. A style consists of a number of different files held in a directory. The different files mean that there is a lot more flexibility available.