Key:name:left

From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg name:left
Name-left-right-OSM example Adams-Jay County Border Indiana USA.png
Description
For way objects, names can differ by side of the object. Edit or translate this description.
Group: Names
Used on these elements
should not be used on nodesmay be used on waysshould not be used on areasshould not be used on relations
Useful combination
Status: de facto

This key indicates the name of a linear object on its left side, as opposed to its right side. Typically, this applies to a road or waterway that forms a boundary.[1]

How to tag

Use the name:left=* and name:right=* tags to name both sides separately (using the direction of the way to determine left and right). The name=* tag can still include both names in order to support different tools.

For example, way Leopold Luypaertstraat / Borghtstraat is tagged:

Multilingual names

The key can also be combined with the language suffix name:left:<lg>=* with <lg> being the ISO code of the language. See: Multilingual names.

For example, way Komenstraat - Chemin des Quatre Rois is tagged:

Direction of travel

name:left=* and name:right=* were originally designed for renderers, which would offset a label to the left or right of a line. However, routers need to associate each name with a direction of travel, so that the user will see the correct name when traveling in one direction along the roadway. The meaning of name:left=* and name:right=* is not as obvious to a router, because the driving side differs from one region to another and based on driving_side=*. To accommodate this use case, name:left=* and name:right=* are sometimes paired with name:forward=* and name:backward=*, by analogy with many other keys like maxspeed:forward=*, turn:lanes:forward=*, and ref:forward=* that are well supported by routers. [1] (The Valhalla-based Mapbox Directions API supports name:forward=* and name:backward=*.)

Examples

  • A street is on the boundary between Belgium and the Netherlands. Belgium gives it the name "Amsterdamsestraat" and the Netherlands gives it the name "Brusselsestraat".
  • In New York City, this street is Ruby Street in Brooklyn on one side and 75th Street in Queens on the other side, which is not to be confused with 75th Street in Brooklyn. To keep a geocoder from returning the wrong 75th Street when looking for the one in Brooklyn, the Brooklyn–Queens boundary should line up exactly with the street.

Notes and references

  1. Historically, name:left=* and name:right=* were also added to boundary=administrative ways. However, this usage has been replaced by boundary=administrative relations. Nowadays, you can safely remove name:left=* and name:right=* from a way that is already a member of a boundary=administrative relation.