Key:distance

From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg distance
M27 DLS.JPG
Description
Distance (i.e. extent; length from start to finish) of a route given in kilometres, or distance along a route marked by milestone. Edit this description in the wiki page. Edit this description in the data item.
Group: routes
Used on these elements
may be used on nodesshould not be used on waysshould not be used on areasmay be used on relations
Status: de facto

This describes the distance (i.e., total length; physical extent) of a geographic feature. It is used in two kinds of elements: route relations and milestone nodes, as specified below.

If no unit is given explicitly, the value is assumed to be in kilometres. If another unit is given, it should be separated from the number by a space. Any decimal should be specified using a dot (.) as the decimal separator. Abbreviations for other units are described on the units page.

Route relations

When used on a route relation, distance describes the total distance of the route. It should not be used on single ways, because it will cause confusion if the way is split and the tag is kept.

For example, the total length (physical extent) of the Polish Autostrada A1 is currently 326 km, so the relation for relation Autostrada A1 is tagged distance=326.

((Q: This definition still leaves certain issues undetermined. Lots of roads have breaks or jumps where they are not defined. They disappear at these gaps and then reappear elsewhere. How does the "distance" of a relation handle these gaps? Is the distance of that gap included or ignored? -- A: If the route contains branches and a meaningful distance is not automatically computable, "distance" should be manually filled with something sensible. If the route is incomplete in OSM, "distance" can be filled with e.g. the officially declared length. (The Waymarkedtrails service shows the "distance" value with a "official length" label.)))

Milestone nodes

This tag is also used on milestones to record the distance shown on the marker--see that tag for more details. Milestones are used for highways, railways, and waterways.

Similar tags

  • length=*: The length of a feature, in meters.
  • width=*: The width of a feature, in meters
  • position=*: For distances written on a marker=*