12 | 12 |
: Output program version to stderr.
|
13 | 13 |
|
14 | 14 |
=== File options ===
|
|
15 |
|
15 | 16 |
;--input-file=filename
|
16 | 17 |
: Read input data from the give file. This option (or just a
|
17 | 18 |
filename) may be given more than once.
|
|
30 | 31 |
line can be used, however you omit the leading '--'. The short
|
31 | 32 |
option names with a single '-' cannot be used, simply use the
|
32 | 33 |
long name instead.
|
33 | |
|
|
34 |
<p>
|
34 | 35 |
;--output-dir=filename
|
35 | 36 |
: The directory in which all output files are written. It defaults
|
36 | 37 |
to the current working directory, i.e. the directory the command is
|
37 | 38 |
executed from.
|
38 | |
|
|
39 |
<p>
|
39 | 40 |
;-n name
|
40 | 41 |
;--mapname=name
|
41 | 42 |
: Set the name of the map. Garmin maps are named by 8 digit
|
42 | 43 |
numbersList. The default is 63240001. It is best to use a different
|
43 | 44 |
name if you are going to be making a map for others to use so
|
44 | 45 |
that it is unique and does not clash with others.
|
45 | |
|
|
46 |
<p>
|
46 | 47 |
;--description=text
|
47 | 48 |
: Sets the descriptive text for the map. This may be displayed in
|
48 | 49 |
QLandkarte, MapSource or on a GPS, where it is normally shown
|
|
51 | 52 |
and use -c template.args, then that file may contain a
|
52 | 53 |
"description" that will override this option. Use "--description" in
|
53 | 54 |
splitter.jar to change the description in the template.args file.
|
54 | |
|
|
55 |
<p>
|
55 | 56 |
;--country-name=name
|
56 | 57 |
: Sets the map's country name. The default is "COUNTRY".
|
57 | |
|
|
58 |
<p>
|
58 | 59 |
;--country-abbr=abbreviation
|
59 | 60 |
: Sets the map's abbreviated country name. The default is "ABC".
|
60 | |
|
|
61 |
<p>
|
61 | 62 |
;--region-name=name
|
62 | 63 |
: Sets the map's region name. By default, the map has no region name.
|
63 | |
|
|
64 |
<p>
|
64 | 65 |
;--region-abbr=abbreviation
|
65 | 66 |
: Sets the map's abbreviated region name. By default, the map has
|
66 | 67 |
no abbreviated region name.
|
67 | |
|
|
68 |
<p>
|
68 | 69 |
=== Label options ===
|
69 | 70 |
|
70 | 71 |
;--latin1
|
71 | 72 |
: This is equivalent to --code-page=1252.
|
72 | |
|
|
73 |
<p>
|
73 | 74 |
;--unicode
|
74 | |
: This is equivalent to --code-page=65001. Note that only newer devices support Unicode.
|
75 | |
|
|
75 |
: This is equivalent to --code-page=65001. Note that only newer devices support Unicode.
|
|
76 |
<p>
|
76 | 77 |
;--code-page=number
|
77 | 78 |
: This option enables the use of international characters. Only 8 bit
|
78 | 79 |
character sets are supported and so you have to specify which code page
|
79 | 80 |
you want to use.
|
80 | |
|
81 | |
: It is entirely dependent on the device firmware which code pages are
|
|
81 |
<p>
|
|
82 |
It is entirely dependent on the device firmware which code pages are
|
82 | 83 |
supported.
|
83 | |
|
|
84 |
<p>
|
84 | 85 |
;--charset=name
|
85 | 86 |
: This option is obsolete. Change the character set with the --code-page
|
86 | 87 |
option.
|
87 | |
|
|
88 |
<p>
|
88 | 89 |
;--lower-case
|
89 | 90 |
: Allow labels to contain lower case letters. Note that most or all
|
90 | 91 |
Garmin devices are not able to display lower case letters at an angle
|
91 | 92 |
so this option is not generally useful.
|
92 | |
|
|
93 |
<p>
|
93 | 94 |
=== Address search options ===
|
94 | 95 |
;--index
|
95 | 96 |
: Generate a global address search index. If the --gmapsupp option is
|
96 | 97 |
also given, then the index is generated within the resulting
|
97 | 98 |
gmapsupp.img file so that address search will work on a GPS
|
98 | 99 |
device.
|
99 | |
|
100 | |
: If instead the --tdbfile option is given then the index consists
|
|
100 |
<p>
|
|
101 |
If instead the --tdbfile option is given then the index consists
|
101 | 102 |
of two files named osmmap.mdx and osmmap_mdr.img which can be used
|
102 | 103 |
with mapsource. (For compatibility, you do not need the tdbfile
|
103 | 104 |
option if gmapsupp is not given).
|
104 | |
|
105 | |
: If both the --gmapsupp and --tdbfile options are given alongside
|
|
105 |
<p>
|
|
106 |
If both the --gmapsupp and --tdbfile options are given alongside
|
106 | 107 |
the --index option, then both indexes will be created. Note that
|
107 | 108 |
this will require roughly twice as much memory.
|
108 | |
|
109 | |
: The --overview-mapname option can be used to change these names. If
|
|
109 |
<p>
|
|
110 |
The --overview-mapname option can be used to change these names. If
|
110 | 111 |
the mapset is sent to the device from MapSource, it will enable
|
111 | 112 |
find by name and address search on the GPS.
|
112 | 113 |
|
113 | 114 |
: The address fields are assigned by special mkgmap address
|
114 | 115 |
tags using the style file:
|
|
116 |
|
115 | 117 |
mkgmap:country
|
116 | 118 |
mkgmap:region
|
117 | 119 |
mkgmap:city
|
|
125 | 127 |
same code page and sorting options (e.g. --code-page, --latin1) must
|
126 | 128 |
be used as were used to compile the individual map tiles.
|
127 | 129 |
|
|
130 |
;--x-split-name-index
|
|
131 |
: A temporary option to enable indexing each part of a street name separately.
|
|
132 |
So for example if the street is "Aleksandra Gryglewskiego" then you will be able to
|
|
133 |
search for it as both "Aleksandra" and "Gryglewskiego". It will also increase the
|
|
134 |
size of the index. Useful in countries where searching for the first word in name
|
|
135 |
is not the right thing to do.
|
|
136 |
<p>
|
|
137 |
Note that this option is still experimental and there may be problems. If you find
|
|
138 |
any let us know!
|
|
139 |
<p>
|
128 | 140 |
;--bounds=directory|zipfile
|
129 | 141 |
: A directory or a zip file containing the preprocessed bounds files.
|
130 | 142 |
Bounds files in a zip file must be located in the zip file's root directory.
|
131 | |
|
132 | |
: The preprocessed boundaries are used to add special tags to all elements
|
|
143 |
<p>
|
|
144 |
The preprocessed boundaries are used to add special tags to all elements
|
133 | 145 |
(points, lines and polygons) containing the elements location information.
|
134 | 146 |
The style file can be used to assign the address tags mkgmap:country,
|
135 | 147 |
mkgmap:region etc. using these values.
|
136 | |
|
137 | |
: The following special tags are added:
|
|
148 |
<p>
|
|
149 |
The following special tags are added:
|
|
150 |
<pre>
|
138 | 151 |
mkgmap:admin_level2 : Name of the admin_level=2 boundary
|
139 | 152 |
mkgmap:admin_level3 : Name of the admin_level=3 boundary
|
140 | 153 |
..
|
141 | 154 |
mkgmap:admin_level11
|
142 | 155 |
mkgmap:postcode : the postal_code value
|
143 | |
|
144 | |
: Preprocessed bounds can be created with the following command:
|
145 | |
java -cp mkgmap.jar
|
146 | |
uk.me.parabola.mkgmap.reader.osm.boundary.BoundaryPreprocessor
|
147 | |
<inputfile> <boundsdir>
|
148 | |
|
149 | |
: The input file must contain the boundaries that should be preprocessed.
|
150 | |
It can have OSM, PBF or O5M fileformat. It is recommended that it
|
|
156 |
</pre>
|
|
157 |
Preprocessed bounds can be created with the following command:
|
|
158 |
<pre>
|
|
159 |
java -cp mkgmap.jar
|
|
160 |
uk.me.parabola.mkgmap.reader.osm.boundary.BoundaryPreprocessor
|
|
161 |
<inputfile> <boundsdir>
|
|
162 |
</pre>
|
|
163 |
The input file must contain the boundaries that should be preprocessed.
|
|
164 |
It can have OSM, PBF or O5M file format. It is recommended that it
|
151 | 165 |
contains the boundary data only to avoid very high memory usage.
|
152 | 166 |
The boundsdir gives the directory where the processed files are stored.
|
153 | 167 |
This directory can be used as --bounds parameter with mkgmap.
|
154 | |
|
|
168 |
<p>
|
155 | 169 |
;--location-autofill=[option1,[option2]]
|
156 | 170 |
: Controls how the address fields for country, region, city and zip info
|
157 | 171 |
are gathered automatically if the fields are not set by using the special
|
158 | 172 |
mkgmap address tags (e.g. mkgmap:city - see option index).
|
159 | 173 |
Warning: automatic assignment of address fields is somehow a best guess.
|
160 | 174 |
:;is_in
|
161 | |
::The is_in tag is analyzed for country and region information.
|
162 | |
|
|
175 |
:: The is_in tag is analyzed for country and region information.
|
|
176 |
<p>
|
163 | 177 |
:;nearest
|
164 | |
::The city/hamlet points that are closest to the element are used
|
|
178 |
:: The city/hamlet points that are closest to the element are used
|
165 | 179 |
to assign the missing address fields. Beware that cities located
|
166 | 180 |
in the same tile are used only. So the results close to a tile
|
167 | 181 |
border have less quality.
|
168 | 182 |
|
169 | |
|
170 | 183 |
;--housenumbers
|
171 | |
: Enables house number search for OSM input files.
|
172 | |
|
173 | |
: All nodes and polygons having addr:housenumber set are matched
|
|
184 |
: Enables house number search for OSM input files.
|
|
185 |
All nodes and polygons having addr:housenumber set are matched
|
174 | 186 |
to streets. A match between a house number element and a street is created if
|
175 | 187 |
the street is located within a radius of 150m and the addr:street tag value of
|
176 | |
the house number element equals the mgkmap:street tag value of the street
|
177 | |
or the addr:street tag is missing and the number is plausible for the street.
|
|
188 |
the house number element equals the mgkmap:street tag value of the street.
|
178 | 189 |
The mkgmap:street tag must be added to the street in the style file.
|
179 | 190 |
For optimal results, the tags mkgmap:city and mkgmap:postal_code should be
|
180 | 191 |
set for the housenumber element. If a street connects two or more cities
|
|
184 | 195 |
:: Node - addr:street=Main Street addr:housenumber=2
|
185 | 196 |
:: Way 1 - name=Main Street
|
186 | 197 |
:: Way 2 - name=Main Street, mkgmap:street=Main Street
|
187 | |
:: Way 3 - mkgmap:street=Mainstreet
|
|
198 |
:: Way 3 - mkgmap:street=Mainstreet
|
188 | 199 |
:: Way 4 - name=Main Street [A504]
|
189 | |
: The node 1 matches to Way 2. It has mkgmap:street set with a value equal to
|
190 | |
the addr:street tag value of the house number node.
|
191 | |
: If the street is not given with addr:housenumber, mkgmap uses heuristics
|
192 | |
to find the best match.
|
|
200 |
: The node matches to Way 2. It has mkgmap:street set with a value equal to
|
|
201 |
the addr:street tag value of the house number node.
|
|
202 |
<p>
|
|
203 |
If the street is not given with addr:housenumber, mkgmap uses heuristics
|
|
204 |
to find the best match.
|
193 | 205 |
|
194 | 206 |
=== Overview map options ===
|
195 | 207 |
;--overview-mapname=name
|
196 | 208 |
: If --tdbfile is enabled, this gives the name of the overview
|
197 | 209 |
.img and .tdb files. The default map name is osmmap.
|
198 | |
|
|
210 |
<p>
|
199 | 211 |
;--overview-mapnumber=8 digit number
|
200 | 212 |
: If --tdbfile is enabled, this gives the internal 8 digit
|
201 | 213 |
number used in the overview map and tdb file. The default
|
202 | 214 |
number is 63240000.
|
203 | |
|
|
215 |
<p>
|
204 | 216 |
;--overview-levels
|
205 | 217 |
: like levels, specifies additional levels that are to be written to the
|
206 | 218 |
overview map. Counting of the levels should continue. Up to 8 additional
|
207 | 219 |
levels may be specified, but the lowest usable resolution with MapSource
|
208 | 220 |
seems to be 11. The hard coded default is empty.
|
209 | |
|
|
221 |
<p>
|
210 | 222 |
;--remove-ovm-work-files
|
211 | 223 |
: If overview-levels is used, mkgmap creates one additional file
|
212 | 224 |
with the prefix ovm_ for each map (*.img) file.
|
213 | 225 |
These files are used to create the overview map.
|
214 | 226 |
With option --remove-ovm-work-files=true the files are removed
|
215 | 227 |
after the overview map was created. The default is to keep the files.
|
216 | |
|
|
228 |
<p>
|
217 | 229 |
=== Style options ===
|
218 | 230 |
;--style-file=file
|
219 | 231 |
: Specify an external file to obtain the style from. "file" can
|
|
221 | 233 |
(see resources/styles/default for an example). The directory
|
222 | 234 |
path must be absolute or relative to the current working
|
223 | 235 |
directory when mkgmap is invoked.
|
224 | |
|
225 | |
: The file can be a zip file containing the files instead of a
|
|
236 |
<p>
|
|
237 |
The file can be a zip file containing the files instead of a
|
226 | 238 |
directory.
|
227 | |
|
228 | |
: The files can be at the top level or contained in a folder within
|
|
239 |
<p>
|
|
240 |
The files can be at the top level or contained in a folder within
|
229 | 241 |
the zip file. If the zip file contains more than one top level
|
230 | 242 |
folder then each folder is the name of a style that can be selected
|
231 | 243 |
with the --style option.
|
232 | |
|
233 | |
: The argument can also be a URL that specifies the location of a
|
|
244 |
<p>
|
|
245 |
The argument can also be a URL that specifies the location of a
|
234 | 246 |
style file.
|
235 | |
|
|
247 |
<p>
|
236 | 248 |
;--style=name
|
237 | 249 |
: Specify a style name. Must be used if --style-file points to a
|
238 | 250 |
directory or zip file containing multiple styles. If --style-file
|
239 | 251 |
is not used, it selects one of the built-in styles.
|
240 | |
|
|
252 |
<p>
|
241 | 253 |
;--list-styles
|
242 | 254 |
: List the available styles. If this option is preceded by a style-file
|
243 | 255 |
option then it lists the styles available within that file.
|
244 | |
|
|
256 |
<p>
|
245 | 257 |
;--check-styles
|
246 | 258 |
: Perform some checks on the available styles. If this option is
|
247 | 259 |
preceded by a style-file option then it checks the styles
|
248 | 260 |
available within that file. If it is also preceded by the style
|
249 | 261 |
option it will only check that style.
|
250 | |
|
|
262 |
<p>
|
251 | 263 |
;--levels=levels code
|
252 | 264 |
: Change the way that the levels on the map correspond to the zoom
|
253 | 265 |
levels in the device. See customisation help. The default is:
|
254 | 266 |
"0:24, 1:22, 2:20, 3:18, 4:16", although each style can have
|
255 | 267 |
its own default. Up to 8 levels may be specified.
|
256 | |
|
|
268 |
<p>
|
257 | 269 |
;--name-tag-list
|
258 | 270 |
: Get the tag that will be used to supply the name. Useful for
|
259 | 271 |
language variations. You can supply a list and the first one
|
260 | 272 |
will be used. e.g. --name-tag-list=name:en,int_name,name
|
261 | |
|
|
273 |
<p>
|
262 | 274 |
;--map-features=file
|
263 | 275 |
: This option is ignored; use the --style-file option instead.
|
264 | |
|
265 | |
=== Product description options ===
|
|
276 |
<p>
|
|
277 |
===Product description options===
|
266 | 278 |
|
267 | 279 |
;--family-id
|
268 | 280 |
: This is an integer that identifies a family of products.
|
269 | 281 |
Range: [1..9999]
|
270 | 282 |
Mkgmap default: 6324
|
271 | |
|
|
283 |
<p>
|
272 | 284 |
;--family-name
|
273 | 285 |
: If you build several maps, this option describes the
|
274 | 286 |
family name of all of your maps. Garmin will display this
|
275 | 287 |
in the map selection screen.
|
276 | |
|
277 | |
: Example: --family-name="OpenStreetmap mkgmap XL 2019"
|
278 | |
|
|
288 |
<p>
|
|
289 |
Example: --family-name="OpenStreetmap mkgmap XL 2019"
|
|
290 |
<p>
|
279 | 291 |
;--product-id
|
280 | 292 |
: This is an integer that identifies a product within a family.
|
281 | 293 |
It is often just 1, which is the default.
|
282 | |
|
|
294 |
<p>
|
283 | 295 |
;--product-version
|
284 | 296 |
: The version of the product. Default value is 1.
|
285 | |
|
|
297 |
<p>
|
286 | 298 |
;--series-name
|
287 | 299 |
: This name will be displayed in MapSource in the map selection
|
288 | 300 |
drop-down. The default is "OSM map".
|
289 | |
|
|
301 |
<p>
|
290 | 302 |
;--area-name
|
291 | 303 |
: Area name is displayed on Garmin units (or at least on eTrex) as the second
|
292 | 304 |
part of the mapname in the list of the individual maps.
|
293 | |
|
|
305 |
<p>
|
294 | 306 |
;--copyright-message=note
|
295 | 307 |
: Specify a copyright message for files that do not contain one.
|
296 | |
|
|
308 |
<p>
|
297 | 309 |
;--copyright-file=file
|
298 | 310 |
: Specify copyright messages from a file.
|
299 | 311 |
Note that the first copyright message is not displayed on a device, but is
|
300 | 312 |
shown in BaseCamp. The copyright file must include at least two lines.
|
301 | |
|
|
313 |
<p>
|
302 | 314 |
;--license-file=file
|
303 | 315 |
: Specify a file which content will be added as license.
|
304 | 316 |
All entries of all maps will be merged in the overview map.
|
305 | |
|
|
317 |
<p>
|
306 | 318 |
=== Optimization options ===
|
307 | 319 |
|
308 | 320 |
;--reduce-point-density=NUM
|
|
312 | 324 |
This distance gets shifted with lower zoom levels.
|
313 | 325 |
Recommended setting is 4, this should lead to only small differences
|
314 | 326 |
(Default is 2.6, which should lead to invisible changes)
|
315 | |
|
|
327 |
<p>
|
316 | 328 |
;--reduce-point-density-polygon=NUM
|
317 | 329 |
: Allows to set the maximal allowed error distance for the DP algorithm
|
318 | 330 |
to be applied against polygons. Recommended setting is 8.
|
319 | |
|
|
331 |
<p>
|
320 | 332 |
;--merge-lines
|
321 | 333 |
: Try to merge lines. This helps the simplify filter to straighten out
|
322 | 334 |
longer chunks at lower zoom levels. Decreases file size more.
|
323 | 335 |
Increases paint speed at low zoom levels.
|
324 | 336 |
Default is enabled, use --no-merge-lines to disable.
|
325 | |
|
|
337 |
<p>
|
326 | 338 |
;--min-size-polygon=NUM
|
327 | 339 |
: Removes all polygons smaller than NUM from the map.
|
328 | 340 |
This reduces map size and speeds up redrawing of maps.
|
329 | 341 |
Recommended value is 8 to 15, default is 8.
|
330 | 342 |
See also polygon-size-limits.
|
331 | |
|
|
343 |
<p>
|
332 | 344 |
;--polygon-size-limits=limits code
|
333 | 345 |
: Allows to specify different min-size-polygon values for each resolution.
|
334 | 346 |
Sample:
|
|
338 | 350 |
resolution 17 and 18 will use 10, and so on.
|
339 | 351 |
Value 0 means to skip the size filter.
|
340 | 352 |
Note that in resolution 24 the filter is not used.
|
341 | |
|
|
353 |
<p>
|
342 | 354 |
=== Miscellaneous options ===
|
343 | 355 |
|
344 | 356 |
;--max-jobs[=number]
|
|
347 | 359 |
is set equal to the number of CPU cores. If this option is not
|
348 | 360 |
given at all, the limit is 1 (i.e., the maps are processed
|
349 | 361 |
sequentially).
|
350 | |
|
|
362 |
<p>
|
351 | 363 |
;--keep-going
|
352 | 364 |
: Don't quit whole application if an exception occurs while
|
353 | 365 |
processing a map - continue to process the other maps.
|
354 | |
|
|
366 |
<p>
|
355 | 367 |
;--block-size=number
|
356 | 368 |
: Changes the block size that is used in the generated map. This
|
357 | 369 |
option is not usually needed, but sometimes an error message
|
358 | 370 |
will ask you to try a value for this option.
|
359 | |
|
|
371 |
<p>
|
360 | 372 |
;--net
|
361 | 373 |
: Obsolete, use --route instead.
|
362 | |
|
|
374 |
<p>
|
363 | 375 |
;--route
|
364 | 376 |
: Create maps that support routing.
|
365 | |
|
|
377 |
<p>
|
366 | 378 |
;--drive-on=left|right|detect|detect,left|detect,right
|
367 | 379 |
: Explicitly specify which side of the road vehicles are
|
368 | 380 |
expected to drive on.
|
|
374 | 386 |
of drive-on-left roads with the rest.
|
375 | 387 |
Use the --bounds option to make sure that the detection
|
376 | 388 |
finds the correct country.
|
377 | |
|
|
389 |
<p>
|
378 | 390 |
;--drive-on-left
|
379 | 391 |
;--drive-on-right
|
380 | 392 |
: Deprecated: Use drive-on instead.
|
381 | 393 |
The options are translated to drive-on=left|right.
|
382 | |
|
|
394 |
<p>
|
383 | 395 |
;--check-roundabouts
|
384 | 396 |
: Check that roundabouts have the expected direction (clockwise
|
385 | 397 |
when vehicles drive on the left). Roundabouts that are complete
|
386 | 398 |
loops and have the wrong direction are reversed. Also checks
|
387 | 399 |
that the roundabouts do not fork or overlap other roundabouts.
|
388 | |
|
|
400 |
<p>
|
389 | 401 |
;--check-roundabout-flares
|
390 | 402 |
: Sanity check roundabout flare roads - warn if they don't point
|
391 | 403 |
in the correct direction or if they are not one-way or if they
|
392 | 404 |
extend too far.
|
393 | |
|
|
405 |
<p>
|
394 | 406 |
;--max-flare-length-ratio=NUM
|
395 | 407 |
: When checking flare roads, ignore roads whose length is
|
396 | 408 |
greater than NUM (an integer) times the distance between the
|
|
399 | 411 |
number of legitimate roads that are flagged as flare road
|
400 | 412 |
problems. Default value is 0 (disabled) because it's not a
|
401 | 413 |
completely reliable heuristic.
|
402 | |
|
|
414 |
<p>
|
403 | 415 |
;--ignore-maxspeeds
|
404 | |
: Now ignored, former usage:
|
|
416 |
: Now ignored, former usage:
|
405 | 417 |
When reading OSM files, ignore any "maxspeed" tags.
|
406 | |
|
|
418 |
<p>
|
407 | 419 |
;--ignore-builtin-relations
|
408 | |
: Now ignored, former usage:
|
|
420 |
: Now ignored, former usage:
|
409 | 421 |
When reading OSM files, skip the built-in processing of
|
410 | 422 |
relations. This speeds up the processing non-routable map
|
411 | 423 |
layers that do not contain multipolygons. This implies
|
412 | 424 |
--ignore-turn-restrictions.
|
413 | |
|
|
425 |
<p>
|
414 | 426 |
;--ignore-turn-restrictions
|
415 | 427 |
: When reading OSM files, ignore any "restriction" relations.
|
416 | |
|
|
428 |
<p>
|
417 | 429 |
;--ignore-osm-bounds
|
418 | 430 |
: When reading OSM files, ignore any "bounds" elements.
|
419 | 431 |
With this option selected generate-sea sometimes works better,
|
420 | 432 |
but routing across tiles will not work.
|
421 | |
|
|
433 |
<p>
|
422 | 434 |
;--preserve-element-order
|
423 | |
: Process the map elements (nodes, ways, relations) in the order
|
|
435 |
: Process the map elements (nodes, ways, relations) in the order
|
424 | 436 |
in which they appear in the OSM input. Without this option,
|
425 | 437 |
the order in which the elements are processed is not defined.
|
426 | |
|
|
438 |
<p>
|
427 | 439 |
;--remove-short-arcs[=MinLength]
|
428 | |
: now ignored, former explanation:
|
|
440 |
: Now ignored, former usage:
|
429 | 441 |
Merge nodes to remove short arcs that can cause routing
|
430 | 442 |
problems. If MinLength is specified (in metres), arcs shorter
|
431 | 443 |
than that length will be removed. If a length is not
|
432 | 444 |
specified, only zero-length arcs will be removed.
|
433 | |
|
434 | |
|
|
445 |
<p>
|
435 | 446 |
;--adjust-turn-headings[=BITMASK]
|
436 | |
: now ignored, former explanation:
|
|
447 |
: Now ignored, former usage:
|
437 | 448 |
Where possible, ensure that turns off to side roads change
|
438 | 449 |
heading sufficiently so that the GPS believes that a turn is
|
439 | 450 |
required rather than a fork. This also avoids spurious
|
440 | 451 |
instructions to "keep right/left" when the road doesn't
|
441 | 452 |
actually fork.
|
442 | |
|
443 | |
: Optional BITMASK (default value 3) allows you to specify which
|
|
453 |
<p>
|
|
454 |
Optional BITMASK (default value 3) allows you to specify which
|
444 | 455 |
adjustments are to be made (where necessary):
|
|
456 |
<p>
|
445 | 457 |
:* 1 = increase angle between side road and outgoing main road
|
446 | 458 |
:* 2 = increase angle between side road and incoming main road
|
447 | |
|
|
459 |
<p>
|
448 | 460 |
;--cycle-map
|
449 | |
: Tells mkgmap that the map is for cyclists. This assumes that
|
|
461 |
: Tells mkgmap that the map is for cyclists. This assumes that
|
450 | 462 |
different vehicles are different kinds of bicycles, e.g. a way
|
451 | 463 |
with mkgmap:car=yes and mkgmap:bicycle=no may be a road that is
|
452 | 464 |
good for racing bikes, but not for other cyclists.
|
453 | 465 |
This allows to optimise sharp angles at junctions of those roads.
|
454 | 466 |
Don't use with the default style as that is a general style!
|
455 | |
|
|
467 |
<p>
|
456 | 468 |
;--report-similar-arcs
|
457 | 469 |
: Issue a warning when more than one arc connects two nodes and
|
458 | 470 |
the ways that the arcs are derived from contain identical
|
459 | 471 |
points. It doesn't make sense to use this option at the same
|
460 | 472 |
time as using the cycleway creating options.
|
461 | |
|
|
473 |
<p>
|
462 | 474 |
;--report-dead-ends=LEVEL
|
463 | 475 |
: Set the dead end road warning level. The value of LEVEL (which
|
464 | 476 |
defaults to 1 if this option is not specified) determines
|
465 | |
those roads to report:
|
466 | |
:* 0 = none
|
467 | |
:* 1 = multiple one-way roads that join together but go nowhere
|
468 | |
:* 2 = individual one-way roads that go nowhere.
|
469 | |
|
470 | |
|
|
477 |
those roads to report: 0 = none, 1 = multiple one-way roads
|
|
478 |
that join together but go nowhere, 2 = individual one-way roads
|
|
479 |
that go nowhere.
|
|
480 |
<p>
|
471 | 481 |
;--road-name-pois[=GarminCode]
|
472 | |
: Now ignored, former meaning:
|
473 | |
Generate a POI for each named road. By default, the POIs'
|
|
482 |
: Now ignored, former usage:
|
|
483 |
Generate a POI for each named road. By default, the POIs'
|
474 | 484 |
Garmin type code is 0x640a. If desired, a different type code
|
475 | |
can be specified with this option. This s a workaround for not
|
|
485 |
can be specified with this option. This is a workaround for not
|
476 | 486 |
being able to search for roads.
|
477 | |
|
478 | |
: 0x2f15: a blue dot in the middle of the road, and if you select,
|
479 | |
or 'hover' over it, the streetname appears.
|
480 | |
|
|
487 |
0x2f15: a blue dot in the middle of the road, and if you select,
|
|
488 |
or 'hover' over it, the street name appears.
|
481 | 489 |
;--add-pois-to-lines
|
482 | 490 |
: Generate POIs for lines. For each line (must not be closed) POIs are
|
483 | 491 |
created at several points of the line. Each POI is tagged with the
|
|
488 | 496 |
:* end - The last point of the line
|
489 | 497 |
:* inner - Each point of the line except the first and the last
|
490 | 498 |
:* mid - The middle point
|
491 | |
:
|
492 | |
|
493 | 499 |
;--add-pois-to-areas
|
494 | 500 |
: Generate a POI for each polygon and multipolygon. The POIs are created
|
495 | 501 |
after the relation style but before the other styles are applied. Each
|
|
497 | 503 |
the area/multipolygon. Additionally the tag mkgmap:area2poi=true is
|
498 | 504 |
set so that it is possible to use that information in the points style
|
499 | 505 |
file. Artifical polygons created by multipolyon processing are not used.
|
500 | |
The POIs are created at the following positions
|
501 | |
:; polygons:
|
502 | |
:: First rule that applies:
|
|
506 |
The POIs are created at the following positions (first rule that applies):
|
|
507 |
:;polygons:
|
|
508 |
::First rule that applies of
|
503 | 509 |
::* the first node tagged with a tag defined by the pois-to-areas-placement option
|
504 | 510 |
::* the centre point
|
505 | |
::
|
506 | |
|
507 | |
:;multipolygons:
|
508 | |
:: First rule that applies:
|
|
511 |
:; multipolygons:
|
|
512 |
::First rule that applies of
|
509 | 513 |
::* the node with role=label
|
510 | 514 |
::* the centre point of the biggest area
|
511 | |
:
|
512 | |
|
513 | 515 |
;--pois-to-areas-placement[=taglist]
|
514 | 516 |
: A semicolon separated list of tag=value definitions. A POI is placed at the first
|
515 | 517 |
node of the polygon tagged with the first tag/value pair. If none of the nodes are
|
|
517 | 519 |
pair is used and so on. If none of the tag-value pairs matches or the taglist is empty
|
518 | 520 |
the centre of the polygon is used.
|
519 | 521 |
It is possible to define wildcards for tag values like entrance=*.
|
520 | |
|
521 | |
: Default: entrance=main;entrance=yes;building=entrance
|
522 | |
|
|
522 |
<p>Default: entrance=main;entrance=yes;building=entrance
|
|
523 |
<p>
|
523 | 524 |
;--precomp-sea=directory|zipfile
|
524 | 525 |
: Defines the directory or a zip file that contains precompiled sea tiles.
|
525 | |
Sea files in a zip file must be located in the zip files root directory or in
|
|
526 |
Sea files in a zip file must be located in the zip file's root directory or in
|
526 | 527 |
a sub directory sea. When this option is defined all natural=coastline tags
|
527 | 528 |
from the input OSM tiles are removed and the precompiled data is used instead.
|
528 | 529 |
This option can be combined with the generate-sea options multipolygon, polygons
|
529 | 530 |
and land-tag. The coastlinefile option is ignored if precomp-sea is set.
|
530 | |
|
|
531 |
<p>
|
531 | 532 |
;--coastlinefile=filename[,filename]
|
532 | 533 |
: Defines a comma separated list of files that contain coastline
|
533 | 534 |
data. The coastline data from the input files is removed if
|
534 | 535 |
this option is set. Files must have OSM or PBF fileformat.
|
535 | |
|
|
536 |
<p>
|
536 | 537 |
;--generate-sea[=ValueList]
|
537 | 538 |
: Generate sea polygons. ValueList is an optional comma
|
538 | 539 |
separated list of values:
|
|
540 |
<p>
|
539 | 541 |
:;multipolygon
|
540 | |
:: generate the sea using a multipolygon (the default
|
541 | |
behaviour so this really doesn't need to be specified).
|
|
542 |
:: generate the sea using a multipolygon (the default behaviour so this really doesn't need to be specified).
|
|
543 |
|
542 | 544 |
:;polygons | no-mp
|
543 | 545 |
:: don't generate the sea using a multipolygon - instead,
|
544 | 546 |
generate a background sea polygon plus individual land
|
|
551 | 553 |
:;no-sea-sectors
|
552 | 554 |
:: disable the generation of "sea sectors" when the
|
553 | 555 |
coastline fails to reach the tile's boundary.
|
554 | |
|
555 | 556 |
:;extend-sea-sectors
|
556 | |
:: same as no-sea-sectors. Additional adds a point so
|
557 | |
coastline reaches the nearest tile boundary.
|
|
557 |
:: same as no-sea-sectors. Additional adds a point so coastline reaches the nearest tile boundary.
|
558 | 558 |
|
559 | 559 |
:;land-tag=TAG=VAL
|
560 | |
:: tag to use for land polygons (default natural=land).
|
561 | |
|
|
560 |
:: tag to use for land polygons (default natural=land).
|
562 | 561 |
:;close-gaps=NUM
|
563 | 562 |
:: close gaps in coastline that are less than this distance (metres)
|
564 | 563 |
|
|
568 | 567 |
(works only with multipolygon processing)
|
569 | 568 |
|
570 | 569 |
:;fbgap=NUM
|
571 | |
:: flood blocker gap in metre (default 40) points that are closer to the sea polygon do not block
|
572 | |
|
|
570 |
:: flood blocker gap in metre (default 40)
|
|
571 |
points that are closer to the sea polygon do not block
|
573 | 572 |
:;fbthres=NUM
|
574 | 573 |
:: at least so many highway points must be contained in
|
575 | 574 |
a sea polygon so that it may be removed by the flood
|
|
584 | 583 |
:: switches on the debugging of the flood blocker
|
585 | 584 |
generates GPX files for each polygon checked by
|
586 | 585 |
the flood blocker
|
587 | |
:
|
588 | 586 |
|
589 | 587 |
;--make-poi-index
|
590 | 588 |
: Generate the POI index (not yet useful).
|
591 | |
|
|
589 |
<p>
|
592 | 590 |
;--nsis
|
593 | 591 |
: Write a .nsi file that can be used with the Nullsoft Scriptable Install System
|
594 | 592 |
(NSIS) to create a Windows Mapsource Installer.
|
595 | |
|
|
593 |
<p>
|
596 | 594 |
;--make-all-cycleways
|
597 | |
: Deprecated, use --make-opposite-cycleways instead. Former meaning:
|
598 | |
Turn on all of the options that make cycleways.
|
599 | |
|
|
595 |
: Deprecated, use --make-opposite-cycleways instead. Former meaning:
|
|
596 |
<div class=preserve><nowiki>
|
|
597 |
Turn on all of the options that make cycleways.
|
|
598 |
|
|
599 |
</nowiki></div>
|
600 | 600 |
;--make-opposite-cycleways
|
601 | 601 |
: Some one-way streets allow bicycle traffic in the reverse
|
602 | 602 |
direction and this option makes a way with the same points as
|
603 | 603 |
the original that allows bicycle traffic (in both directions).
|
604 | |
|
|
604 |
<p>
|
605 | 605 |
;--make-cycleways
|
606 | |
: Now ignored, former meaning:
|
607 | |
Some streets have a separate cycleway track/lane just for
|
|
606 |
: Now ignored, former meaning:
|
|
607 |
<div class=preserve><nowiki>
|
|
608 |
Some streets have a separate cycleway track/lane just for
|
608 | 609 |
bicycle traffic and this option makes a way with the same
|
609 | 610 |
points as the original that allows bicycle traffic. Also,
|
610 | 611 |
bicycle traffic is prohibited from using the original way
|
611 | 612 |
(unless that way's bicycle access has been defined).
|
612 | 613 |
|
|
614 |
</nowiki></div>
|
613 | 615 |
;--link-pois-to-ways
|
614 | |
:This option may copy some specific attributes of a POI
|
|
616 |
: This option may copy some specific attributes of a POI
|
615 | 617 |
to a small part of the way the POI is located on. This can be used
|
616 | 618 |
to let barriers block a way or to lower the calculated speed
|
617 | 619 |
around traffic signals.
|
618 | |
POIs with the tags highway=* (e.g. highway=traffic_signals)
|
|
620 |
POIs with the tags highway=* (e.g. highway=traffic_signals)
|
619 | 621 |
or barrier=* (e.g. barrier=cycle_barrier) are supported.
|
620 | 622 |
The style developer must add at least one of the access tags
|
621 | |
(mkgmap:foot, mkgmap:car etc.), mkgmap:road-speed and/or
|
622 | |
mkgmap:road-class to the POI.
|
623 | |
The access tags are ignored if they have no effect for the way,
|
624 | |
else a route restriction is added at the POI so that only
|
625 | |
allowed vehicles are routed through it.
|
626 | |
The tags mkgmap:road-speed and/or mkgmap:road-class are
|
|
623 |
(mkgmap:foot, mkgmap:car etc.), mkgmap:road-speed and/or
|
|
624 |
mkgmap:road-class to the POI.
|
|
625 |
The access tags are ignored if they have no effect for the way,
|
|
626 |
else a route restriction is added at the POI so that only
|
|
627 |
allowed vehicles are routed through it.
|
|
628 |
The tags mkgmap:road-speed and/or mkgmap:road-class are
|
627 | 629 |
applied to a small part of the way around the POI, typically
|
628 | 630 |
to the next junction or a length of ~25 m. The tags
|
629 | |
are ignored for pedestrian-only ways.
|
630 | |
|
|
631 |
are ignored for pedestrian-only ways.
|
|
632 |
<p>
|
631 | 633 |
;--process-destination
|
632 | 634 |
: Splits all motorway_link, trunk_link, and primary_link
|
633 | |
ways tagged with destination into two or three parts where
|
|
635 |
ways tagged with destination into two or three parts where
|
634 | 636 |
the second part is additionally tagged with mkgmap:dest_hint=true.
|
635 | |
This allows using any routable Garmin type (except 0x08 and 0x09)
|
|
637 |
This allows to use any routable Garmin type (except 0x08 and 0x09)
|
636 | 638 |
for that part so that the Garmin device tells the name of
|
637 | 639 |
this part as hint which destination to follow.
|
638 | 640 |
See also --process-exits.
|
639 | |
|
|
641 |
<p>
|
640 | 642 |
;--process-exits
|
641 | 643 |
: Usual Garmin devices do not tell the name of the exit on motorways
|
642 | 644 |
while routing with mkgmap created maps. This option splits each
|
643 | 645 |
motorway_link, trunk_link and primary_link way into three parts.
|
644 | 646 |
All parts are tagged with the original tags of the link.
|
645 | 647 |
Additionally the middle part is tagged with the following tags:
|
|
648 |
<pre>
|
646 | 649 |
mkgmap:exit_hint=true
|
647 | 650 |
mkgmap:exit_hint_ref=<ref tag value of the exit>
|
648 | 651 |
mkgmap:exit_hint_name=<name tag value of the exit>
|
649 | 652 |
mkgmap:exit_hint_exit_to=<exit_to tag value of the exit>
|
650 | |
|
651 | |
: Adding a rule checking the mkgmap:exit_hint=true makes it possible
|
|
653 |
</pre>
|
|
654 |
Adding a rule checking the mkgmap:exit_hint=true makes it possible
|
652 | 655 |
to use any routable Garmin type (except 0x08 and 0x09) for the middle
|
653 | 656 |
part so that the Garmin device tells the name of this middle part as
|
654 | |
hint where to leave the motorway/trunk. The first part must have type
|
655 | |
0x08 or 0x09 so that Garmin uses the hint.
|
|
657 |
hint where to leave the motorway/trunk.
|
|
658 |
The first part must have type 0x08 or 0x09 so that Garmin uses the hint.
|
656 | 659 |
|
657 | 660 |
;--delete-tags-file=FILENAME
|
658 | 661 |
: Names a file that should contain one or more lines of the form
|
659 | 662 |
TAG=VALUE or TAG=*. Blank lines and lines that start with
|
660 | 663 |
a # or ; are ignored. All tag/value pairs in the OSM input are
|
661 | 664 |
compared with these patterns and those that match are deleted.
|
662 | |
|
|
665 |
<p>
|
663 | 666 |
;--tdbfile
|
664 | 667 |
: Write files that are essential to running with MapSource, a .tdb file and
|
665 | 668 |
an overview map.
|
666 | |
|
|
669 |
<p>
|
667 | 670 |
;--show-profiles=1
|
668 | 671 |
: Sets a flag in tdb file which marks set mapset as having contour
|
669 | 672 |
lines and allows showing profile in MapSource. Default is 0
|
670 | 673 |
which means disabled.
|
671 | |
|
|
674 |
<p>
|
672 | 675 |
;--draw-priority=25
|
673 | 676 |
: When two maps cover the same area, this option controls what
|
674 | 677 |
order they are drawn in and therefore which map is on top of
|
675 | 678 |
which. Higher priorities are drawn "on top" of lower
|
676 | 679 |
priorities.
|
677 | |
|
|
680 |
<p>
|
678 | 681 |
;--transparent
|
679 | 682 |
: Make the map transparent, so that if two maps are loaded that
|
680 | 683 |
cover the same area, you can see through this map and see the
|
681 | 684 |
lower map too. Useful for contour line maps among other
|
682 | 685 |
things.
|
683 | |
|
|
686 |
<p>
|
684 | 687 |
;--poi-address
|
685 | 688 |
: Enable address / phone information to POIs. Address info is
|
686 | 689 |
read according to the "Karlsruhe" tagging schema. Automatic
|
687 | 690 |
filling of missing information could be enabled using the
|
688 | 691 |
"location-autofill" option.
|
689 | |
|
690 | |
: Default is enabled, use --no-poi-address to disable.
|
691 | |
|
|
692 |
Default is enabled, use --no-poi-address to disable.
|
|
693 |
<p>
|
692 | 694 |
;--verbose
|
693 | 695 |
: Makes some operations more verbose. Mostly used with --list-styles.
|