Subversion Repositories mkgmap

= List of options =
Note that option order is significant:  An option only applies to
subsequent input files.  (So if you are using splitter, you probably
want to put most of your options before '-c template.args'.)

General options:

;--help=topic
:       Print help on the given topic.  If the topic is omitted then a
list of all the help topics is printed instead.
<p>
;--version 
:       Output program version to stderr.
<p>
filename
;--input-file=filename
:       Read input data from the give file.  This option (or just a
filename) may be given more than once.
<p>
;--gmapsupp
:       Create a gmapsupp.img file that can be uploaded to a Garmin or
placed in "/Garmin" in a microSD card (such as by mounting the
device in USB mass storage mode).  It can be used on ready
compiled img files, if the input files are not already compiled
then they are compiled first and then the gmapsupp is created.
<p>
;-c filename
;--read-config=filename
:       The given file is opened and each line is an option setting of
the form option=value, any option that could be used on the command
line can be used, however you omit the leading '--'.  The short
option names with a single '-' cannot be used, simply use the
long name instead.
<p>
;--output-dir=filename
:     The directory in which all output files are written. It defaults
to the current working directory, ie. the directory the command is
executed from.
<p>
;-n name
;--mapname=name
:       Set the name of the map. Garmin maps are named by 8 digit
numbersList.  The default is 63240001.  It is best to use a different
name if you are going to be making a map for others to use so
that it is unique and does not clash with others.
<p>
;--description=text
:       Sets the descriptive text for the map. This may be displayed in
QLandkarte, MapSource on on a GPS etc, where it is normally shown
below the family name. Example: --description="Germany, Denmark"
Please note: if you use splitter.jar to build a template.args file
and use -c template.args, then that file may contain a
"description" that will override this option. Use "--description" in
splitter.jar to change the description in the template.args file.
<p>
;--country-name=name
:       Sets the map's country name. The default is "COUNTRY".
<p>
;--country-abbr=abbreviation
:       Sets the map's abbreviated country name. The default is "ABC".
<p>
;--region-name=name
:       Sets the map's region name. By default, the map has no region name.
<p>
;--region-abbr=abbreviation
:       Sets the map's abbreviated region name. By default, the map has
no abbreviated region name.
<p>
Label options:

;--latin1
:       This is equivalent to --code-page=1252.
<p>
;--code-page=number
:     This option enables the use of international characters. Only 8 bit
character sets are supported and so you have to specify which code page
you want to use.
<p>
It is entirely dependant on the device firmware which code pages are
supported.
<p>
;--charset=name
:       This option is obsolete. Change the character set with the --code-page
option.
<p>
;--lower-case
:       Allow labels to contain lower case letters.  Note that most or all
Garmin devices are not able to display lower case letters at an angle
so this option is not generally useful.
<p>
Address search options:
;--index
:       Generate a global address search index. If the --gmapsupp option is
also given, then the index is generated within the resulting
gmapsupp.img file so that address search will work on a GPS
device.
<p>
If instead the --tdbfile option is given then the index consists
of two files named osmmap.mdx and osmmap_mdr.img which can be used
with mapsource. (For compatibility, you do not need the tdbfile
option if gmapsupp is not given).
<p>
If both the --gmapsupp and --tdbfile options are given alongside
the --index option, then both indexes will be created. Note that
this will require roughly twice as much memory.
<p>
The --overview-mapname option can be used to change these names.  If
the mapset is sent to the device from MapSource, it will enable
find by name and address search on the GPS.
<p>
The address fields are assigned by special mkgmap address
tags using the style file:
<div class=preserve><nowiki>
  mkgmap:country
  mkgmap:region
  mkgmap:city
  mkgmap:postal_code
  mkgmap:street
  mkgmap:housenumber
  mkgmap:phone
  (mkgmap:is_in - used by location-autofill=is_in)

If the index is created from previously compiled .img files, then the
same code page and sorting options (eg. --code-page, --latin1 etc) must
be used as were used to compile the individual map tiles.

</nowiki></div>
;--bounds=directory|zipfile
:     A directory or a zipfile containing the preprocessed bounds files. 
Bounds files in a zipfile must be located in the zipfiles root directory.
<p>
The preprocessed boundaries are used to add special tags to all elements 
(points, lines and polygons) containing the elements location information.
The style file can be used to assign the address tags mkgmap:country,
mkgmap:region etc. using these values.
<p>
The following special tags are added:          
<div class=preserve><nowiki>
          mkgmap:admin_level2 : Name of the admin_level=2 boundary 
          mkgmap:admin_level3 : Name of the admin_level=3 boundary
          ..
          mkgmap:admin_level11
          mkgmap:postcode : the postal_code value

</nowiki></div>
Preprocessed bounds can be created with the following command:
<div class=preserve><nowiki>
   java -cp mkgmap.jar 
      uk.me.parabola.mkgmap.reader.osm.boundary.BoundaryPreprocessor
      <inputfile> <boundsdir>

</nowiki></div>
The input file must contain the boundaries that should be preprocessed. 
It can have OSM, PBF or O5M fileformat. It is recommended that it 
contains the boundary data only to avoid very high memory usage.
The boundsdir gives the directory where the processed files are stored.
This directory can be used as --bounds parameter with mkgmap.               
<p>
;--location-autofill=[option1,[option2]]
:       Controls how the address fields for country, region, city and zip info 
are gathered automatically if the fields are not set by using the special 
mkgmap address tags (e.g. mkgmap:city - see option index).
Warning: automatic assignment of address fields is somehow a best guess.
:;is_in
::The is_in tag is analyzed for country and region information.

:;nearest
::The city/hamlet points that are closest to the element are used 
to assign the missing address fields. Beware that cities located 
in the same tile are used only. So the results close to a tile 
border have less quality.  
<p>
;--housenumbers
: Enables house number search for OSM input files. 
<p>
All nodes and polygons having addr:housenumber and addr:street set are matched 
to streets. A match between house number element and street is created if
the street is located within a radius of 150m and the addr:street tag of the 
house number element 
::   - equals the mgkmap:street tag of the street. mkgmap:streets should be set 
in the style file.
::   - or it equals the name of the street stripped by garmin shields and all text
within round brackets. 
:  Example: 
::     Node -  addr:street=Main Street addr:housenumber=2
::     Way 1 - mkgmap:street=Main Street
::     Way 2 - name=Main Street (A504)
::     Way 3 - mkgmap:street=Mainstreet
::     Way 4 - name=Main Street [A504]
:    The node matches to way 1 and way 2 but not to way 3 (does not equal exactly)
and not to way 4 (only text in round brackets is ignored)
<p>

Overview map options:
;--overview-mapname=name
:       If --tdbfile is enabled, this gives the name of the overview
.img and .tdb files. The default map name is osmmap.

;--overview-mapnumber=8 digit number
:       If --tdbfile is enabled, this gives the internal 8 digit
number used in the overview map and tdb file.  The default
number is 63240000.

;--overview-levels
:   like levels, specifies additional levels that are to be written to the
overview map. Counting of the levels should continue. Up to 8 additional 
levels may be specified, but the lowest usable resolution with MapSource 
seems to be 11. The hard coded default is empty.      

;--remove-ovm-work-files
:   If overview-levels is used, mkgmap creates one additional file 
with the prefix ovm_ for each map (*.img) file. 
These files are used to create the overview map.
With option --remove-ovm-work-files=true the files are removed 
after the overview map was created. The default is to keep the files.  

Style options:
;--style-file=file
:       Specify an external file to obtain the style from.  "file" can
be a directory containing files such as info, lines, options
(see resources/styles/default for an example).  The directory
path must be absolute or relative to the current working
directory when mkgmap is invoked.
<p>
The file can be a zip file containing the files instead of a
directory.
<p>
The files can be at the top level or contained in a folder within
the zip file.  If the zip file contains more than one top level
folder then each folder is the name of a style that can be selected
with the --style option.
<p>
The argument can also be a URL that specifies the location of a
style file.
<p>
;--style=name
:       Specify a style name. Must be used if --style-file points to a 
directory or zip file containing multiple styles. If --style-file 
is not used, it selects one of the builtin styles. 
<p>
;--list-styles
:       List the available styles. If this option is preceeded by a style-file
option then it lists the styles available within that file.
<p>
;--check-styles
:       Perform some checks on the available styles. If this option is 
preceeded by a style-file option then it checks the styles 
available within that file. If it is also preceded by the style
option it will only check that style.
<p>
;--levels=levels code
:       Change the way that the levels on the map correspond to the zoom
levels in the device. See customisation help. The default is:
"0:24, 1:22, 2:20, 3:18, 4:16", although each style can have
its own default. Up to 8 levels may be specified.
<p>
;--name-tag-list
:       Get the tag that will be used to supply the name.  Useful for
language variations.  You can supply a list and the first one
will be used.  eg. --name-tag-list=name:en,int_name,name
<p>
;--map-features=file
:       This option is ignored; use the --style-file option instead.
<p>
Product description options:

;--family-id
:       This is an integer that identifies a family of products.
Range: [1..9999]
Mkgmap default: 6324
<p>
;--family-name
:       If you build several maps, this option describes the
family name of all of your maps. Garmin will display this
in the map selection screen.
Example: --family-name="OpenStreetmap mkgmap XL 2019"
<p>
;--product-id
:       This is an integer that identifies a product within a family.
It is often just 1, which is the default.
<p>
;--product-version
:       The version of the product. Default value is 1.
<p>
;--series-name
:       This name will be displayed in MapSource in the map selection
drop-down. The default is "OSM map".
<p>
;--area-name
:   Area name is displayed on Garmin units (or at least on eTrex) as the second 
part of the mapname in the list of the individual maps.
<p>
;--copyright-message=note
:       Specify a copyright message for files that do not contain one.
<p>
;--license-file=file
:       Specify a file which content will be added as license. 
All entrys of all maps will be merged in the overview map.

Optimization options:

;--reduce-point-density=NUM
:       Simplifies the ways with the Douglas Peucker algorithm.
NUM is the maximal allowed error distance, by which the resulting
way may differ from the original one.
This distance gets shifted with lower zoom levels. 
Recommended setting is 4, this should lead to only small differences
(Default is 2.6, which should lead to invisible changes)
<p>
;--reduce-point-density-polygon=NUM
:       Allows to set the maximal allowed error distance for the DP algorythm
to be applied against polygons. Recommended setting is 8.
<p>
;--merge-lines
:       Try to merge lines. This helps the simplify filter to straighten out
longer chunks at lower zoom levels. Decreases file size more.
Increases paint speed at low zoom levels.
Default is enabled, use --no-merge-lines to disable.
<p>
;--min-size-polygon=NUM
:   Removes all polygons smaller than NUM from the map.
This reduces map size and speeds up redrawing of maps. 
Recommended value is 8 to 15, default is 8.
See also polygon-size-limits.
<p>
;--polygon-size-limits=limits code
:   Allows to specify different min-size-polygon values for each resolution.
Sample:  
--polygon-size-limits="24:12, 18:10, 16:8, 14:4, 12:2, 11:0"
If a resolution is not given, mkgmap uses the value for the next higher 
one. For the given sample, resolutions 19 to 24 will use value 12,
resolution 17 and 18 will use 10, and so on.
Value 0 means to skip the size filter. 
Note that in resolution 24 the filter is not used.  
<p>
Miscellaneous options:

;--max-jobs[=number]
:       When number is specified, allow that number of maps to be
processed concurrently. If number is not specified, the limit
is set equal to the number of CPU cores. If this option is not
given at all, the limit is 1 (i.e., the maps are processed
sequentially).
<p>
;--keep-going
:       Don't quit whole application if an exception occurs while
processing a map - continue to process the other maps.
<p>
;--block-size=number
:       Changes the block size that is used in the generated map. This
option is not usually needed, but sometimes an error message
will ask you to try a value for this option.
<p>
;--net
:       Obsolete, use --route instead.
<p>
;--route
:       Create maps that support routing.
<p>
;--drive-on-left
;--drive-on-right
:       Explicitly specify which side of the road vehicles are
expected to drive on. If neither of these options are
specified, it is assumed that vehicles drive on the right
unless --check-roundabouts is specified and the first
roundabout processed is clockwise.
<p>
;--check-roundabouts
:       Check that roundabouts have the expected direction (clockwise
when vehicles drive on the left). Roundabouts that are complete
loops and have the wrong direction are reversed. Also checks
that the roundabouts do not fork or overlap other roundabouts.
<p>
;--check-roundabout-flares
:       Sanity check roundabout flare roads - warn if they don't point
in the correct direction or if they are not oneway or if they
extend too far.
<p>
;--max-flare-length-ratio=NUM
:       When checking flare roads, ignore roads whose length is
greater than NUM (an integer) times the distance between the
nodes on the roundabout that the flare roads connect to. Using
this option with a value of at least 5 will cut down the
number of legitimate roads that are flagged as flare road
problems. Default value is 0 (disabled) because it's not a
completely reliable heuristic.
<p>
;--ignore-builtin-relations
:       When reading OSM files, skip the built-in processing of
relations. This speeds up the processing non-routable map
layers that do not contain multipolygons. This implies
--ignore-turn-restrictions.
<p>
;--ignore-turn-restrictions
:       When reading OSM files, ignore any "restriction" relations.
<p>
;--ignore-osm-bounds
:       When reading OSM files, ignore any "bounds" elements.
With this option selected generate-sea sometimes works better,
but routing across tiles will not work.
<p>
;--preserve-element-order
:       Process the map elements (nodes, ways, relations) in the order
in which they appear in the OSM input. Without this option,
the order in which the elements are processed is not defined.
<p>
;--remove-short-arcs[=MinLength]
:       Merge nodes to remove short arcs that can cause routing
problems. If MinLength is specified (in metres), arcs shorter
than that length will be removed. If a length is not
specified, only zero-length arcs will be removed.
<p>
;--adjust-turn-headings[=BITMASK]
:       Where possible, ensure that turns off to side roads change
heading sufficiently so that the GPS believes that a turn is
required rather than a fork. This also avoids spurious
instructions to "keep right/left" when the road doesn't
actually fork.
<p>
Optional BITMASK (default value 3) allows you to specify which
adjustments are to be made (where necessary):
<p>
1 = increase angle between side road and outgoing main road
2 = increase angle between side road and incoming main road
<p>
;--report-similar-arcs
:       Issue a warning when more than one arc connects two nodes and
the ways that the arcs are derived from contain identical
points. It doesn't make sense to use this option at the same
time as using the cycleway creating options.
<p>
;--report-dead-ends=LEVEL
:       Set the dead end road warning level. The value of LEVEL (which
defaults to 1 if this option is not specified) determines
those roads to report: 0 = none, 1 = multiple oneway roads
that join together but go nowhere, 2 = individual oneway roads
that go nowhere.
<p>
;--road-name-pois[=GarminCode]
:       Generate a POI for each named road. By default, the POIs'
Garmin type code is 0x640a. If desired, a different type code
can be specified with this option.  This is a workaround for not
being able to search for roads.
0x2f15: a blue dot in the middle of the road, and if you select,
or 'hover' over it, the streetname appears.

;--add-pois-to-lines
:       Generate POIs for lines. For each line (must not be closed) POIs are
created at several points of the line. Each POI is tagged with the
same tags like the line and additional tags added by mkgmap:
mkgmap:line2poi=true and tag mkgmap:line2poitype having
the following values:
:* start  - The first point of the line
:* end    - The last point of the line
:* inner  - Each point of the line except the first and the last 
:* mid    - The middle point
:

;--add-pois-to-areas
:       Generate a POI for each polygon and multipolygon. The POIs are created 
after the relation style but before the other styles are applied. Each 
POI is tagged with the same tags of 
the area/multipolygon. Additionally the tag mkgmap:area2poi=true is 
set so that it is possible to use that information in the points style
file. Artifical polygons created by multipolyon processing are not used.
The POIs are created at the following positions
:; polygons: 
:: First rule that applies:
::* the first node tagged with a tag defined by the pois-to-areas-placement option
::* the center point  
::

:;multipolygons:
:: First rule that applies:
::* the node with role=label
::* the center point of the biggest area
:

;--pois-to-areas-placement[=taglist]
:     A semicolon separated list of tag=value definitions. A POI is placed at the first
node of the polygon tagged with the first tag/value pair. If none of the nodes are
tagged with the first tag-value pair the first node tagged with the second tag-value
pair is used and so on. If none of the tag-value pairs matches or the taglist is empty 
the center of the polygon is used.
It is possible to define wildcards for tag values like entrance=*.
Default: entrance=main;entrance=yes;building=entrance
<p>
;--precomp-sea=directory|zipfile
:     Defines the directory or a zip file that contains precompiled sea tiles. 
Sea files in a zipfile must be located in the zipfiles root directory or in 
a sub directory sea. When this option is defined all natural=coastline tags 
from the input OSM tiles are removed and the precompiled data is used instead. 
This option can be combined with the generate-sea options multipolygon, polygons 
and land-tag. The coastlinefile option is ignored if precomp-sea is set.      
<p>
;--coastlinefile=filename[,filename]
:       Defines a comma separated list of files that contain coastline 
data. The coastline data from the input files is removed if 
this option is set. Files must have OSM or PBF fileformat.      
<p>
;--generate-sea[=ValueList]
:       Generate sea polygons. ValueList is an optional comma
separated list of values:
:;multipolygon
:: generate the sea using a multipolygon (the default
behaviour so this really doesn't need to be specified).
:;polygons | no-mp
:: don't generate the sea using a multipolygon - instead,
generate a background sea polygon plus individual land
polygons with tag natural=land. This requires a
suitable land polygon type to be defined in the style
file (suggested type is 0x010100) and the polygon must
be defined in the TYP file as having a higher drawing
level than the sea polygon type.

:;no-sea-sectors
:: disable the generation of "sea sectors" when the
coastline fails to reach the tile's boundary.

:;extend-sea-sectors
:: same as no-sea-sectors. Additional adds a point so 
coastline reaches the nearest tile boundary.

:;land-tag=TAG=VAL
:: tag to use for land polygons (default natural=land).  

:;close-gaps=NUM
:: close gaps in coastline that are less than this distance (metres)

:;floodblocker 
:: enable the flood blocker that prevents a flooding of
land by checking if the sea polygons contain streets
(works only with multipolygon processing)               

:;fbgap=NUM           
:: flood blocker gap in metre (default 40) points that are closer to the sea polygon do not block 

:;fbthres=NUM
:: at least so many highway points must be contained in 
a sea polygon so that it may be removed by the flood
blocker (default 20)

:; fbratio=NUM
:: only sea polygons with a higher ratio 
(highway points * 100000 / polygon size) are removed 
(default 0.5)

:; fbdebug
:: switches on the debugging of the flood blocker
generates GPX files for each polygon checked by
the flood blocker
:

;--make-poi-index
:       Generate the POI index (not yet useful).
<p>
;--nsis
:       Write a .nsi file that can be used with the Nullsoft Scriptable Install System
(NSIS) to create a Windows Mapsource Installer.

;--make-all-cycleways
:       Turn on all of the options that make cycleways.

;--make-opposite-cycleways
:       Some oneway streets allow bicycle traffic in the reverse
direction and this option makes a way with the same points as
the original that allows bicycle traffic (in both directions).

;--make-cycleways
:       Some streets have a separate cycleway track/lane just for
bicycle traffic and this option makes a way with the same
points as the original that allows bicycle traffic. Also,
bicycle traffic is prohibited from using the original way
(unless that way's bicycle access has been defined).

;--link-pois-to-ways
:       If this option is enabled, POIs that are situated at a point
in a way will be associated with that way and may modify the
way's properties. Currently supported are POIs that restrict
access (e.g. bollards). Their access restrictions are applied
to a small region of the way near the POI.

;--process-destination
:       Splits all motorway_link and trunk_link ways tagged with 
destination     into two or three parts where the second part
is additionally tagged with mkgmap:dest_hint=true. This 
allows to use any routable Garmin type (except 0x08 and 0x09)
for that part so that the Garmin device tells the name of
this part as hint which destination to follow.

;--process-exits
:     Usual Garmin devices do not tell the name of the exit on motorways 
while routing with mkgmap created maps. This option splits the each
motorway_link and trunk_link into three parts. All parts are tagged 
with the original tags of the link. Additionally the middle part is 
tagged with the following tags:
<div class=preserve><nowiki>
  mkgmap:exit_hint=true
  mkgmap:exit_hint_ref=<ref tag value of the exit>
  mkgmap:exit_hint_name=<name tag value of the exit>
  mkgmap:exit_hint_exit_to=<exit_to tag value of the exit>
</nowiki></div>
<p>
Adding a rule checking the mkgmap:exit_hint=true makes it possible
to use any routable Garmin type (except 0x08 and 0x09) for the middle 
part so that the Garmin device tells the name of this middle part as 
hint where to leave the motorway/trunk. 
<p>
;--delete-tags-file=FILENAME
:       Names a file that should contain one or more lines of the form
TAG=VALUE or TAG=*. Blank lines and lines that start with
a # or ; are ignored. All tag/value pairs in the OSM input are
compared with these patterns and those that match are deleted.
<p>
;--tdbfile
:       Write files that are essential to running with MapSource, a .tdb file and
an overview map.
<p>
;--show-profiles=1
:       Sets a flag in tdb file which marks set mapset as having contour 
lines and allows showing profile in MapSource. Default is 0 
which means disabled. 
<p>
;--draw-priority=25
:       When two maps cover the same area, this option controls what
order they are drawn in and therefore which map is on top of
which.  Higher priorities are drawn "on top" of lower
priorities.
<p>
;--transparent
:       Make the map transparent, so that if two maps are loaded that
cover the same area, you can see through this map and see the
lower map too.  Useful for contour line maps among other
things.
<p>
;--poi-address
:       Enable address / phone information to POIs. Address info is
read according to the "Karlsruhe" tagging schema. Automatic
filling of missing information could be enabled using the
"location-autofill" option.
Default is enabled, use --no-poi-address to disable.
<p>
;--verbose
:       Makes some operations more verbose. Mostly used with --list-styles.