1 Routino : Tagging Rules
2 =======================
5 The different tags and attributes in the OSM format XML that are used
6 by Routino are described below.
8 An important change for version 1.4 of Routino is that the tags in the
9 input file are first processed according to a set of rules defined in a
10 configuration file. This means that the information presented here is
11 in two parts; firstly the tags that are recognised by Routino after
12 pre-processing and secondly the transformations in the default
16 Tags Recognised After Processing
17 --------------------------------
19 This section describes the tags that are recognised by Routino after
20 the tag transformations have been applied. This is therefore a much
21 reduced set of tags compared to the original OSM data and also includes
22 tags which are specific to Routino.
24 In all cases of tag processing values of true, yes, 1 are recognised as
25 being affirmative and any other value is ignored.
28 Node Tags And Attributes
29 ------------------------
31 The node attributes id, latitude and longitude are used. The id
32 atribute is required to associate the node with the ways and the
33 position attributes are required to locate the node.
35 Transport Specific Tags
36 - - - - - - - - - - - -
38 One tag is recognised for each of the different modes of transport:
39 foot, horse, bicycle, wheelchair, moped, motorbike, motorcar, goods,
40 hgv and psv. These indicate whether the specific type of transport is
41 allowed to pass through the node or not.
43 By default for nodes all types of transport are allowed to pass through
44 a node and specific tags must be used to remove the permissions for the
47 Way Tags And Attributes
48 -----------------------
50 The tags from the ways in the data are the ones that provide most of
51 the information for routing. The id attribute is used only so that the
52 many segments associated with a way can be share a set of tags taken
58 The most important tag that is used from a way is the highway tag. This
59 defines the type of highway that the way represents. Any way that does
60 not have a highway tag is discarded.
62 There are more highway types defined than are used by the router. The
63 subset that the router uses are:
77 Note 1: This changed in version 1.3 of Routino - the bridleway and
78 footway types were included within the path highway type.
79 Note 2: This changed in version 1.3 of Routino - the steps type was
80 separated from the footway type.
82 Transport Specific Tags
83 - - - - - - - - - - - -
85 One tag is recognised for each of the different modes of transport:
86 foot, horse, bicycle, wheelchair, moped, motorbike, motorcar, goods,
87 hgv and psv. These indicate whether the specific type of transport is
88 allowed on the highway or not.
90 By default for ways no types of transport are allowed to pass along a
91 highway and specific tags must be used to add the permissions for the
97 The name tag is used to provide the label for the highway when printing
103 The ref tag is used to provide the label for the highway when printing
109 The junction tag is used to check if a highway is (part of) a
110 roundabout. This tag is used for information to label the highway if no
111 other name is provided.
116 The multilane tag is used to identify whether a highway has multiple
117 lanes for traffic and this sets one of the highway properties. There is
118 not normally a multilane tag but one needs to be added by the tag
119 processing transformations. Values of true, yes, 1 are recognised.
124 The paved tag is used to identify whether a highway is paved or not,
125 this is one of the available highway properties. A paved tag may exist
126 in the original data but normally the surface tag needs to be
127 transformed into the paved tag.
132 The bridge tag is used to identify whether a highway is a bridge and
133 therefore set one of the available properties.
138 The tunnel tag is used to identify whether a highway is a tunnel and
139 therefore set one of the available properties.
144 The footroute tag is used to identify whether a highway is part of a
145 walking route and therefore set one of the available properties. This
146 is not a standard OSM tag and is normally added to the individual
147 highways by looking for route relations that are designated for foot
153 The bicycleroute tag is used to identify whether a highway is part of a
154 bicycle route and therefore set one of the available properties. This
155 is not a standard OSM tag and is normally added to the individual
156 highways by looking for route relations that are designated for bicycle
162 The oneway tag is used to specify that traffic is only allowed to
163 travel in one direction.
168 The maxspeed tag is used to specify the maximum speed limit on the
169 highway; this is always measured in km/hr in OpenStreetMap data. If the
170 tag value contains "mph" then it is assumed to be a value in those
171 units and converted to km/hr.
176 The maxweight tag is used to specify the maximum weight of any traffic
177 on the highway. In other words this must be set to the heaviest weight
178 allowed on the highway (for example a bridge) in tonnes. If the tag
179 value contains "kg" then it is assumed that the value is in these units
180 and converted to tonnes.
185 The maxheight tag is used to specify the maximum height of any traffic
186 on the highway. In other words this must be set to the lowest height of
187 anything above the highway (like a bridge) in metres. If the tag value
188 contains a measurement in feet or feet and inches then attempts are
189 made to convert this to metres.
194 The maxwidth tag is used to specify the maximum width of any traffic on
195 the highway. This must be set to the minimum width of the contraints at
196 the wayside in metres. If the tag value contains a measurement in feet
197 or feet and inches then attempts are made to convert this to metres.
202 The maxlength tag is used to specify the maximum length of any traffic
203 on the highway (usually from a traffic sign) in metres. If the tag
204 value contains a measurement in feet or feet and inches then attempts
205 are made to convert this to metres.
207 Relation Tags And Attributes
208 ----------------------------
210 The tags from the relations are used to associate more properties with
211 the highways that are part of that relation. The id attribute is used
212 so that relations that are members of other relations can be
218 The footroute tag is used to identify whether a relation defines a
219 walking route and therefore should be applied to the individual member
225 The bicycleroute tag is used to identify whether a relation defines a
226 bicycle route and therefore should be applied to the individual member
233 This section describes the set of tag transformations that are
234 contained in the default configuration file. The configuration file
235 tagging rules are applied in sequence and this section of the document
236 is arranged in the same order.
239 Node Tag Transformations
240 ------------------------
245 The first part of the tag transformations is to decide on defaults for
246 each type of node. This uses the barrier tag in the OSM file and
247 converts it into a default set of disallowed transport types.
249 Barrier foot horse wheelchair bicycle moped motorbike motorcar goods hgv psv
250 ------- ---- ----- ---------- ------- ----- --------- -------- ----- --- ---
251 bollard yes yes yes yes yes yes no no no no
252 kissing_gate yes no no no no no no no no no
253 stile yes no no no no no no no no no
254 turnstile yes no no no no no no no no no
256 Generic Access Permissions
257 - - - - - - - - - - - - -
259 The access tag is used to specify the default access restrictions
260 through the node. If the tag value is no or private then all transport
261 types are denied access (later tag transformation rules may add
262 specific transport types back again).
264 Other Access Permissions
265 - - - - - - - - - - - -
267 A tag named vehicle means any of the bicycle, moped, motorbike,
268 motorcar, goods, hgv and psv transport types. A tag named motor_vehicle
269 is transformed to mean any vehicle except a bicycle.
271 Specific Access Permissions
272 - - - - - - - - - - - - - -
274 The final part of the access permissions is to use the specific
277 One tag is recognised for each of the different modes of transport:
278 foot, horse, bicycle, wheelchair, moped, motorbike, motorcar, goods,
279 hgv and psv. These indicate whether the specific type of transport is
280 allowed through the node or not.
282 Way Tag Transformations
283 -----------------------
288 The first part of the tag transformations is to decide on defaults for
289 each type of highway. This uses the highway tag in the OSM file and
290 maps it into one of the highway tags that are recognised by Routino,
291 defining the default allowed transport types and adding a number of
294 The first part of the transformation is to convert the highway tag into
295 one that is recognised by Routino.
297 Original tag Transformed tag
298 ------------ ---------------
302 living_street residential
311 The type of highway also determines the defaults for the types of
312 transport allowed on the highway. The default assumptions are as shown
315 Highway foot horse wheelchair bicycle moped motorbike motorcar goods hgv psv
316 ------- ---- ----- ---------- ------- ----- --------- -------- ----- --- ---
317 motorway no no no no no yes yes yes yes yes
318 trunk no no no yes yes yes yes yes yes yes
319 primary yes yes yes yes yes yes yes yes yes yes
320 secondary yes yes yes yes yes yes yes yes yes yes
321 tertiary yes yes yes yes yes yes yes yes yes yes
322 unclassified yes yes yes yes yes yes yes yes yes yes
323 residential yes yes yes yes yes yes yes yes yes yes
324 service yes yes yes yes yes yes yes yes yes yes
325 track yes yes yes yes no no no no no no
326 cycleway yes no yes yes no no no no no no
327 path yes yes(1) yes yes(1) no no no no no no
328 steps yes no yes no no no no no no no
330 Note 1: A path allows bicycle or horse access by default only if
331 actually labelled as a highway of type "bridleway" or certain values of
332 the designation tag (described below).
334 Finally for the highway tag a number of properties are added depending
339 motorway paved, oneway, multilane
352 Note 1: A track is paved only if it is tagged as tracktype=grade1.
353 Note 2: A path is paved only if it was originally tagged as
354 highway=walkway or highway=pedestrian.
356 Generic Access Permissions
357 - - - - - - - - - - - - -
359 The access tag is used to specify the default access restrictions on
360 the highway. If the tag value is "no" or "private" then all transport
361 types are denied access (later tag transformation rules may add
362 specific transport types back again).
364 Other Access Permissions
365 - - - - - - - - - - - -
367 A tag named vehicle means any of the bicycle, moped, motorbike,
368 motorcar, goods, hgv and psv transport types. A tag named motor_vehicle
369 is transformed to mean any vehicle except a bicycle.
371 The designation tag is used as an alternative method of identifying the
372 legal right of way on a path (in the UK at least). The tag
373 transformations convert these tags into a set of allowed transport
374 types as shown below.
376 Designation tag Equivalent access permissions
377 --------------- -----------------------------
378 bridleway or foot=yes, wheelchair=yes, horse=yes,
379 public_bridleway bicycle=yes
380 restricted_byway foot=yes, wheelchair=yes, horse=yes,
382 byway foot=yes, wheelchair=yes, horse=yes,
383 bicycle=yes, moped=yes, motorbike=yes,
385 footpath or foot=yes, wheelchair=yes
388 Specific Access Permissions
389 - - - - - - - - - - - - - -
391 The final part of the access permissions is to use the specific
394 One tag is recognised for each of the different modes of transport:
395 foot, horse, bicycle, wheelchair, moped, motorbike, motorcar, goods,
396 hgv and psv. These indicate whether the specific type of transport is
397 allowed on the highway or not.
402 If there is a surface tag then the highway is assumed to be unpaved
403 unless the tag value matches one of the following: paved, asphalt or
406 Support for the obsolete paved tag is also provided and the highway is
407 paved if this is set to a true value.
409 The lanes tag is used to identify whether a highway has multiple lanes
410 for traffic or not (the number of lanes is not important in this case,
411 only whether it is more than one) this sets one of the highway
414 The bridge and tunnel tags are copied directly from the input to the
420 The oneway, maxspeed, maxweight, maxheight, maxwidth and maxlength are
421 copied directly from the input to the output without modification.
423 Highway Names and References
424 - - - - - - - - - - - - - -
426 The name and ref tags are copied directly from the input to the output.
429 Relation Tag Transformations
430 ----------------------------
435 The route tag can be used to determine whether a relation is part of a
436 walking of bicycle route so that the footroute and bicycleroute
437 properties can be applied to the highways that make up that relation.
439 The tag transformations that are applied for route relations are
440 defined in the table below.
442 Relation Tag footroute Property bicycleroute Property
447 bicycle;foot or foot;bicycle yes yes
452 Copyright 2008-2010 Andrew M. Bishop.