|To define the location of a feature which may be above or under ground or in relation to objects such as roofs, bridges or buildings|
|Used on these elements|
|Tools for this tag|
The generic key location=* is used in different contexts to define the location of a feature which may be above or under ground or to define location in relation to objects such as roofs, bridges or buildings. Used with features such as man_made=pipeline and power=cable which may be buried in the soil.
For features which are contained within a self-supporting tunnel, which may also be used for other purposes or provided for maintenance purposes, use tunnel=* instead. A buried cable is usually surrounded by earth. A cable in a tunnel is usually surrounded by air within a larger self-supporting structure.
Use of the layer=* tag is optional and only useful where there is a benefit to describing the relative vertical arrangement of a number of underground (or overgound) features. It is assumed that features that cross which are tagged with 'location' which do not share nodes will not actually interact with other features which also use 'location' (unlike roads/ railways and rivers etc where they need to be on different layers if they do not intersect).
- location=underground Used where a feature is under ground, not visible on the surface.
- location=underwater Used for features below the surface of water. For underwater features at sea, you may additionally want to add tags according to the Seamark tagging scheme.
- location=overground Used where a feature such as a pipeline or cable is over ground, located close to the surface, not allowing a person or vehicle to pass underneath.
- location=overhead Used for features over ground, located at a height allowing persons or vehicles to pass underneath.
- location=roof Used where a feature is located on the roof of a building.
- location=rooftop possible synonym for roof (makes it clear it is on top of the roof). Only ~4.4% usage compared to roof.
- location=surface Feature is on the surface of the ground, useful with non-zero layer tags and/or non-zero level tags.
- location=outdoor A feature substantially located outside in open air although some parts, (such as lower voltage switchgear of a substation), may be indoor. This is the default value for most objects. One of the exceptions is power=cable.
- location=indoor A feature substantially located inside a building. Certain components, (like the transformers of a substation), may be located outside the building.
- location=platform A feature located on an offshore platform, for example associated with an offshore wind farm.
- location=bridge An object or way that is on a bridge, from this proposal. There is also the much more used bridge=* with the same meaning.