Map features

From OpenStreetMap Wiki
Revision as of 10:23, 13 January 2008 by Pieren (talk | contribs) (Replace the highway section by its template (see Talk:Map_Features))
Jump to navigation Jump to search

Template:Language-Map Features

OpenStreetMap does not have any content restrictions on tags that can be assigned to Nodes, Ways or Areas. You can use any tags you like. However, there is benefit in agreeing a recommended set of features and corresponding tags in order to create, interpret and display a common basemap. This page contains a core recommended feature set and corresponding tags.

If you don't see an appropriate tag for what you would like to map see Proposed features or for grouping ways and nodes together into a higher level component, see Relations. From there you can see what features may be added (and maybe get them in sooner), or propose your own.

Notes on rendering:

  • Using the tags here will mean that your editing efforts are more likely to show up in the various renderers. However, there is no guarantee that a tag listed here will be rendered by any particular renderer or by the renderers used by the OSM main map page.
  • There also may be many tags that will render on the OSM main map page that are not listed here. This list is not updated with all the tags implemented by the renderers.

The tables are in grouped by theme, with the more commonly used first.
Each table is (or will be soon) a template which can be used for the translations.

Physical

Highway

This is used to describe roads and footpaths. For an introduction on its usage see the page titled Highways. See the page titled Restrictions for an introduction on access limitations by vehicles type, time, day, load and purpose, etc.

Key Value Element Comment Rendering carto Examples

Roads

These are the principal tags for the road network. They range from the most to least important.

highway motorway way A restricted access major divided highway, normally with 2 or more running lanes plus emergency hard shoulder. Equivalent to the Freeway, Autobahn, etc..
Rendering-highway motorway neutral.png
  • Morgendlicher Berufsverkehr auf der BAB A8 beim Kreuz Stuttgart - panoramio.jpg
highway trunk way The most important roads in a country's system that aren't motorways. (Need not necessarily be a divided highway.)
Rendering-highway trunk carto.png
  • L3005, Eschborn, Germany
  • Cat and Fiddle Road, England
highway primary way The next most important roads in a country's system. (Often link larger towns.)
Rendering-highway primary neutral.png
  • Hunsrückhöhenstraße, Kappel, Germany
  • Tanami Road, Australia
highway secondary way The next most important roads in a country's system. (Often link towns.)
Rendering-highway secondary neutral.png
  • L134, Meyenburg, Schwanewede, Germany
  • Vatnsnesvegur, Iceland
highway tertiary way The next most important roads in a country's system. (Often link smaller towns and villages)
Rendering-highway tertiary neutral.png
  • Bergedorfer Straße, Worpswede, Germany
  • Canol Road, Yukon, Canada
highway unclassified way The least important through roads in a country's system – i.e. minor roads of a lower classification than tertiary, but which serve a purpose other than access to properties. (Often link villages and hamlets.)

The word 'unclassified' is a historical artefact of the UK road system and does not mean that the classification is unknown; you can use highway=road for that.

Rendering-highway unclassified.png
  • Sentiero 00, Cantagallo, Tuscany, Italy
  • Kuskealleen, Vordingborg, Denmark
highway residential way Roads which serve as an access to housing, without function of connecting settlements. Often lined with housing.
Rendering-highway residential.png
  • Residential.jpg
  • Main Street, Elko, Nevada, USA

Link roads

highway motorway_link way The link roads (sliproads/ramps) leading to/from a motorway from/to a motorway or lower class highway. Normally with the same motorway restrictions.
Rendering-highway motorway link.png
A5 exit link to A672, Darmstadt, Germany
highway trunk_link way The link roads (sliproads/ramps) leading to/from a trunk road from/to a trunk road or lower class highway.
Rendering-highway trunk link.png
A7 / OAL23 interchange, Nesselwang, Germany
highway primary_link way The link roads (sliproads/ramps) leading to/from a primary road from/to a primary road or lower class highway.
Rendering-highway primary link.png
B20 exit and entrance to Brunn, Fridolfing, Germany
highway secondary_link way The link roads (sliproads/ramps) leading to/from a secondary road from/to a secondary road or lower class highway.
Rendering-highway secondary link.png
APD-40cloverleaf.jpg
highway tertiary_link way The link roads (sliproads/ramps) leading to/from a tertiary road from/to a tertiary road or lower class highway.
Rendering-highway tertiary link.png

Special road types

highway living_street way For living streets, which are residential streets where pedestrians have legal priority over cars, speeds are kept very low and where children are allowed to play on the street.
Living street osm.png
beginning of a living street with a paving stones surface and some trees and cars parking at the sides
highway service way area For access roads to, or within an industrial estate, camp site, business park, car park, alleys, etc. Can be used in conjunction with service=* to indicate the type of usage and with access=* to indicate who can use it and in what circumstances.
Rendering-highway service.png
Alley leading from the High Street to Green Lane Shopping Centre - geograph.org.uk - 942796.jpg
highway pedestrian way area For roads used mainly/exclusively for pedestrians in shopping and some residential areas which may allow access by motorised vehicles only for very limited periods of the day. To create a 'square' or 'plaza' create a closed way and tag as pedestrian and also with area=yes.
Pedestrian with area osm.png
Cambridge Rd - geograph.org.uk - 1189572.jpg
highway track way Roads for mostly agricultural or forestry uses. To describe the quality of a track, see tracktype=*. Note: Although tracks are often rough with unpaved surfaces, this tag is not describing the quality of a road but its use. Consequently, if you want to tag a general use road, use one of the general highway values instead of track.
Rendering-highway track.png
  • Frühlingslandschft Aaretal Schweiz.jpg
  • Asphalt track.jpg
highway bus_guideway way A busway where the vehicle guided by the way (though not a railway) and is not suitable for other traffic. Please note: this is not a normal bus lane, use access=no, psv=yes instead!
Rendering-highway-bus guideway-mapnik.png
Bus track.jpg
highway escape way For runaway truck ramps, runaway truck lanes, emergency escape ramps, or truck arrester beds. It enables vehicles with braking failure to safely stop.
A7-Notbremsweg.jpg
highway raceway way A course or track for (motor) racing
Rendering-highway-raceway-mapnik.png
Raceway.jpg
highway road way A road/way/street/motorway/etc. of unknown type. It can stand for anything ranging from a footpath to a motorway. This tag should only be used temporarily until the road/way/etc. has been properly surveyed. If you do know the road type, do not use this value, instead use one of the more specific highway=* values.
Rendering-highway-road-mapnik.png
Road.png
highway busway way A dedicated roadway for bus rapid transit systems
grade-seperated section of busway outside of station

Paths

highway footway way area For designated footpaths; i.e., mainly/exclusively for pedestrians. This includes walking tracks and gravel paths. If bicycles are allowed as well, you can indicate this by adding a bicycle=yes tag. Should not be used for paths where the primary or intended usage is unknown. Use highway=pedestrian for pedestrianised roads in shopping or residential areas and highway=track if it is usable by agricultural or similar vehicles. For ramps (sloped paths without steps), combine this tag with incline=*.
Rendering-highway footway.png
Footway in Stowupland - geograph.org.uk - 1044849.jpg
highway bridleway way For horse riders. Pedestrians are usually also permitted, cyclists may be permitted depending on local rules/laws. Motor vehicles are forbidden.
Rendering-highway bridleway.png
Bridleway-reitweg-de.jpg
highway steps way For flights of steps (stairs) on footways. Use with step_count=* to indicate the number of steps
Rendering-highway steps.png
Steps.jpg
highway corridor way For a hallway inside of a building.
HK TST Star House mall corridor interior shop signs Sept-2012.JPG
highway path way A non-specific path. Use highway=footway for paths mainly for walkers, highway=cycleway for one also usable by cyclists, highway=bridleway for ones available to horse riders as well as walkers and highway=track for ones which is passable by agriculture or similar vehicles.
Path osm.png
GuideFootPathCycleYes.jpg
highway via_ferrata way A via ferrata is a route equipped with fixed cables, stemples, ladders, and bridges in order to increase ease and security for climbers. These via ferrata require equipment : climbing harness, shock absorber and two short lengths of rope, but do not require a long rope as for climbing. not rendered in OSM-Carto
Mauerlaeufer ueberhang.jpg

When sidewalk/crosswalk is tagged as a separate way

footway sidewalk way Sidewalk that runs typically along residential road. Use in combination with highway=footway or highway=path
Rendering-highway footway.png
200806 Berlin 91sidewalk.jpg
footway crossing way Crosswalk that connects two sidewalks on the opposite side of the road. Often recognized by painted markings on the road, road sign or traffic lights. Use in combination with highway=footway or highway=path. Useful information is presence of tactile_paving=*, wheelchair=* suitability and kerb=* represented as a node on the crosswalk way.
Rendering-highway footway.png
Zebra-crossing sm.jpg

When sidewalk (or pavement) is tagged on the main roadway (see Sidewalks)

sidewalk both | left | right | no way Specifies that the highways has sidewalks on both sides, on one side or no sidewalk at all
Sidewalk and zebra-crossing.jpg

When cycleway is drawn as its own way (see Bicycle)

highway cycleway way For designated cycleways. Add foot=*, though it may be avoided if default-access-restrictions do apply.
Cycleway osm.png
Separated cycleway with traffic sign

Cycleway tagged on the main roadway or lane (see Bicycle)

cycleway lane way A lane is a route that lies within the roadway
Fietsstrook Herenweg Oudorp.jpg
cycleway opposite way Used on ways with oneway=yes where it is legally permitted to cycle in both directions. Used together with oneway:bicycle=no.
Sul bxl 01.JPG
cycleway opposite_lane way Used on ways with oneway=yes that have a cycling lane going the opposite direction of normal traffic flow (a "contraflow" lane). Used together with oneway:bicycle=no.
France road sign C24a-2.svg
cycleway track way A track provides a route that is separated from traffic. In the United States, this term is often used to refer to bike lanes that are separated from lanes for cars by pavement buffers, bollards, parking lanes, and curbs. Note that a cycle track may alternatively be drawn as a separate way next to the road which is tagged as highway=cycleway.
Cycle nexttoroad.jpg
cycleway opposite_track way Used on ways with oneway=yes that have a cycling track going the opposite direction of normal traffic flow. Used together with oneway:bicycle=no.
549c Spitzenkiel140923.jpg
cycleway share_busway way There is a bus lane that cyclists are permitted to use.
Busandbike.jpg
cycleway opposite_share_busway way Used on ways with oneway=yes that have a bus lane that cyclists are also permitted to use, and which go in the opposite direction to normal traffic flow (a "contraflow" bus lane). Used together with oneway:bicycle=no.
2010-01-02 15.19.16.jpg
cycleway shared_lane way Cyclists share a lane with motor vehicles, but there are markings indicating that they should share the lane with motorists. In some places these markings are known as "sharrows" ('sharing arrows') and this is the tag to use for those.
Sharrows Toronto 2011.jpg
busway lane way Bus lane on both sides of the road. (See also: Parallel scheme for bus/psv lane tagging lanes:bus=* / lanes:psv=*)
2010-01-02 15.19.16.jpg

Street parking tagged on the main roadway (see Street parking)

parking :left / :right / :both
(hereafter: parking:side)
lane | street_side | on_kerb | half_on_kerb | shoulder | no | separate | yes way Primary key to record parking along the street. Desribes the parking position of parked vehicles in the street.
Darby Street Pre-Shared Space Change.jpg
parking:sideorientation=* parallel | diagonal | perpendicular way To specify the orientation of parked vehicles if there is street parking.

Lifecycle (see also lifecycle prefixes)

highway proposed way For planned roads, use with proposed=* and a value of the proposed highway value.
highway construction way For roads under construction. Use construction=* to hold the value for the completed road.
Rendering-highway construction tertiary carto.png
different colours
12Jan05 04.jpg

Attributes

abutters commercial | industrial | mixed | residential | retail etc. way See Key:abutters for more details.
Dscf1376-600.jpg
bicycle_road yes way A bicycle road is a road designated for bicycles. If residential streets get the status of bicycle roads, normally, by special signs, motor traffic is admitted with limited speed, often only for residents.
456Humboldtstr.jpg
bus_bay both | left | right way A bus bay outside the main carriageway for boarding/alighting
1033@970.jpg
change yes | no | not_right | not_left | only_right | only_left way Specify the allowed/forbidden lane changes
Only Only Only (49884679761).jpg
destination <place name of destination> way Destination when following a linear feature
Japanese Road sign (Direction and Lane A).svg
embankment yes | dyke way A dyke or a raised bank to carry a road, railway, or canal across a low-lying or wet area.
Green River Trail - Desimone Levee 01.jpg
embedded_rails yes | <type of railway> way A highway on which non-railway traffic is also allowed has railway tracks embedded in it but the rails are mapped as separate ways.
Ruusulankatu tram rails (at lat 60.18206, lon 24.92450) heading NW.jpg
ford yes node way The road crosses through stream or river, vehicles must enter any water.
Map feature ford.jpg
ice_road yes way A highway is laid upon frozen water basin, definitely doesn't exist in summer.
Pechora crossing.jpg
incline Number % | ° | up | down node way Incline steepness as percents ("5%") or degrees ("20°"). Positive/negative values indicate movement upward/downwards in the direction of the way.
Incline17.jpg
junction roundabout way closed way This automatically implies oneway=yes, the oneway direction is defined by the sequential ordering of nodes within the Way. This applies on a way, tagged with highway=* already.
Mapping-Features-Roundabout-Simple.png
2008 03 12 - UMD - Roundabout viewed from Art Soc Bldg 4b.JPG
lanes <number> way The number of traffic lanes for general purpose traffic, also for buses and other specific classes of vehicle.
NLEx 6 Lanes.jpg
lit yes | no nodewayarea Street lighting
Berlin speer-leuchte.jpg
maxspeed <number> way Specifies the maximum legal speed limit on a road, railway or waterway.
Zeichen 274-60 - Zulässige Höchstgeschwindigkeit, StVO 2017.svg
motorroad yes | no way node The motorroad tag is used to describe highways that have motorway-like access restrictions but that are not a motorway.
Zeichen 331.1 - Kraftfahrstraße, StVO 2013.svg
mountain_pass yes node The highest point of a mountain pass.
Mountain pass.jpg
mtb:scale 0-6 way Applies to highway=path and highway=track. A classification scheme for mtb trails (few inclination and downhill).
Difficulty gauge for the grants process.png
mtb:scale :uphill 0-5 way A classification scheme for mtb trails for going uphill if there is significant inclination.
Difficulty gauge for the grants process.png
mtb:scale :imba 0-4 way The IMBA Trail Difficulty Rating System shall be used for bikeparks. It is adapted to mtb trails with artificial obstacles.
mtb:description Text way Applies to highway=path and highway=track. A key to input variable infos related to mtbiking on a way with human words
oneway yes | no | reversible way Oneway streets are streets where you are only allowed to drive in one direction.
Schildhb.jpg
overtaking yes | no | caution | both | forward | backward way Specifying sections of roads where overtaking is legally forbidden. Use overtaking:forward=yes/no/caution and overtaking:backward=yes/no/caution when it depends on driving direction.
Overtakinglines.jpg
parking:lane parallel | diagonal | perpendicular | marked | no_parking | no_stopping | fire_lane. way Deprecated variant to map parking along streets. See section on street parking above or the street parking page for more details.
Parkingonstreetlanes2nowide.png
parking:condition free | ticket | disc | residents | customers | private way Deprecated variant to map parking conditions along streets. See section on street parking above or the street parking page for more details.
2013.11.01.104926 Parking sign Kilauea Avenue Hilo Hawaii.jpg
passing_places yes way A way which has frequent passing places (See also: highway=passing_place)
Single-track.jpg
priority forward | backward way Traffic priority for narrow parts of roads, e.g. narrow bridges.
Vienna Convention road sign B6.svg
priority_road designated | yes_unposted | end way Specifying roads signposted as priority roads.
Vienna Convention road sign B3-V1.svg
sac_scale hiking | mountain_hiking | demanding_mountain_hiking | alpine_hiking | demanding_alpine_hiking | difficult_alpine_hiking way Applies to highway=path and highway=footway. A classification scheme for hiking trails.
Mountain hiking.jpg
service alley | driveway | parking_aisle etc. way See Key:service for more details.
Seattle - alley north from S Jackson between Western & 1st - A.jpg
smoothness excellent | good | intermediate | bad | very_bad | horrible | very_horrible | impassable way See Key:smoothness for more details.
Jena Track roots.jpg
surface paved | unpaved | asphalt | concrete | paving_stones | sett | cobblestone | metal | wood | compacted | fine_gravel | gravel | pebblestone | plastic | grass_paver | grass | dirt | earth | mud | sand | ground way See Key:surface for more details.
Transportation in Tanzania Traffic problems.JPG
tactile_paving yes | no node way area A paving in the ground to be followed with a blindman's stick. Not to be rendered on standard maps.
Tactile paving.jpg
tracktype grade1 | grade2 | grade3 | grade4 | grade5 way To describe the quality of the surface. See Key:tracktype for more information.
Mapnik-tracktype-grade1.png
Surface grade1.jpg
traffic_calming bump | hump | table | island | cushion | yes | etc. node way See Key:traffic calming for more details.
Ležeći policajac 016.jpg
trail_visibility excellent | good | intermediate | bad | horrible | no way Applies to highway=path, highway=footway, highway=cycleway and highway=bridleway. A classification for hiking trails visibility
Trail visibility good.jpg
trailblazed yes | no | poles | cairns | symbols way Applies to highway=*. Describing trail blazing and marking. See Key:trailblazed for more information.
Trail blazing 10.jpg
trailblazed:visibility excellent | good | intermediate | bad | horrible | no way Applies to trailblazed=*. A classification for visibility of trailblazing. See Key:trailblazed:visibility for more information.
turn left | slight_left | through | right | slight_right | merge_to_left | merge_to_right | reverse way The key turn can be used to specify the direction in which a way or a lane will lead.
Zeichen 297 - Richtungspfeile, StVO 1970.svg
width <number> way The width of a feature.
Height demonstration diagram.png
winter_road yes way A highway functions during winter, probably can't be driven in summer.
Anuisk bilibino sever66.jpg

Other highway features

highway bus_stop node A small bus stop. Optionally one may also use public_transport=stop_position for the position where the vehicle stops and public_transport=platform for the place where passengers wait.
Bus stop.12.svg
Průmyslová str3, Prague Štěrboholy.jpg
highway crossing node A.k.a. crosswalk. Pedestrians can cross a street here; e.g., zebra crossing
Zebra-crossing sm.jpg
highway elevator node way An elevator or lift, used to travel vertically, providing passenger and freight access between pathways at different floor levels.
Elevator-12.svg
Diag3.jpg
highway emergency_bay node way An area beside a highway where you can safely stop your car in case of breakdown or emergency.
France road sign C8.svg
highway emergency_access_point node Sign number which can be used to define your current position in case of an emergency. Use with ref=NUMBER_ON_THE_SIGN. See also emergency=access_point
Anfahrpunkt für Rettungsfahrzeuge HP 108 Alter Lorscher Weg 102 1235.jpg
highway give_way node A "give way," or "Yield" sign
Give way.jpg
emergency phone node A calling device can be used to tell on your current position in case of an emergency. Use with ref=NUMBER_ON_THE_SIGN
Borne SOS.jpg
highway milestone node Highway location marker
3marcoquilometriconovo.png
highway mini_roundabout node Similar to roundabouts, but at the center there is either a painted circle or a fully traversable island. In case of an untraversable center island, junction=roundabout should be used.

Rendered as anti-clockwise by default direction=anticlockwise. To render clockwise add the tag direction=clockwise.

Mapping-Features-Mini-Roundabout.png
Mini-roundabout.jpg
highway motorway_junction node Indicates a junction (UK) or exit (US). ref=* should be set to the exit number or junction identifier. (Some roads – e.g., the A14 – also carry junction numbers, so the tag may be encountered elsewhere despite its name)
Mapnik-Motorway-Junction.png
Dscf0242 600.jpg
highway passing_place node The location of a passing space
Ausweichstelle.jpg
highway platform node way area A platform at a bus stop or station.
Rendering-highway railway platform line.png
Bayview trstwy.jpg
highway rest_area node area Place where drivers can leave the road to rest, but not refuel.
Rendering-highway-services-mapnik.jpg
Wentworth terrain.jpg
highway services node area A service station to get food and eat something, often found at motorways
Mapping Features Motorway service area.jpg
De lucht.jpg
highway speed_camera node A fixed road-side or overhead speed camera.
Speed camera.jpg
highway stop node A stop sign
STOP sign.jpg
highway street_lamp node A street light, lamppost, street lamp, light standard, or lamp standard is a raised source of light on the edge of a road, which is turned on or lit at a certain time every night
Litpath.jpg
highway toll_gantry node A toll gantry is a gantry suspended over a way, usually a motorway, as part of a system of electronic toll collection. For a toll booth with any kind of barrier or booth see: barrier=toll_booth
CR0344eRoad-MM4-TollGantry (29081629762).jpg
highway traffic_mirror node Mirror that reflects the traffic on one road when direct view is blocked.
Verkehrsspiegel.JPG
highway traffic_signals node Lights that control the traffic
Rendering-traffic singals.jpg
Ampel.jpg
highway trailhead node Designated place to start on a trail or route
Ancient Lakes Trailhead - panoramio.jpg
highway turning_circle node A turning circle is a rounded, widened area usually, but not necessarily, at the end of a road to facilitate easier turning of a vehicle. Also known as a cul de sac.
Mapping-Features-Turning-Circle.png
Turning circle.jpg
highway turning_loop node A widened area of a highway with a non-traversable island for turning around, often circular and at the end of a road.
Turning circle - geograph.org.uk - 991834.jpg
highway User Defined node way All commonly used values according to Taginfo

This table is a wiki template with a default description in English. Editable here.

Cycleway

Key Value Element Comment Example
cycleway lane way A lane is a route that lies within the roadway  
cycleway track way A track is a route that is separate from the road. BS Cellerstr.jpg
cycleway opposite_lane way lane in the opposite way (a "contraflow" lane)  
cycleway opposite_track way track in the opposite way (that is, separate from the road)  
cycleway opposite way just permitted to cycle in the opposite way (one way street except for cycles). Note - such streets are common in Belgium, the Netherlands and Denmark, for example, but are rare in the UK (although they do exist): often, instead, actually the street is two-way as normal for its whole length except for the very short section past the no-entry sign at the end, where cycles are excepted from the no-entry by means of a short lane separated by an island. This is called a "cycle plug". In some places this has been represented as very short oneway Way at the end with an adjacent cycleway, forming a little triangle with the road they join to.  
cycleway User Defined way    

Tracktype

Key Value Element Comment Example
tracktype grade1 way paved track or heavily compacted hardcore.  
tracktype grade2 way unpaved track; surface of gravel or densely packed dirt/sand.  
tracktype grade3 way unpaved track; A mixture of hard materials and soft. Quite compact  
tracktype grade4 way unpaved track; tire marks, with plant growth in between. Mostly dirt, but some hard materials, or compressed materials mixed in.  
tracktype grade5 way unpaved track; subtle tire marks, lack of hardcore, Soft with low grip, subtle on the landscape.  

Waterway

Key Value Element Comment Example
waterway river way For narrow rivers which will be rendered as a line. For larger rivers see Large Rivers (Other languages).  
waterway canal way An artificial open waterway used for transportation, waterpower, or irrigation.(Other languages).  
waterway stream way a naturally-forming waterway that is too thin to be classed as a river. Maybe you can just jump over it.
450px-Marshall-county-indiana-yellow-river.jpg
waterway drain way An artificial waterway for carrying storm water or industrial discharge.
waterway dock nodearea An 'enclosed' area of water used for loading, unloading, building or repairing ships.  
waterway lock_gate node A thing to raise/lower the water level for vessels, often found in canals.  
waterway turning_point node A place to turn the driving direction for vessels, where the boats are longer than the river/canal is wide.  
waterway aqueduct node A bridge carrying a channel for supplying water (Other languages).  
waterway boatyard node Boat yard - a place for constructing, repairing and storing vessels out of the water.  
waterway water_point node A place to get fresh water e.g. for caravans.  
waterway waste_disposal node A place to release used water e.g. for caravans.  
waterway mooring node A place for anchoring vessels.  
waterway weir node way A barrier built across a river, often to divert water for industrial purposes. Water can still flow over the top.
waterway dam wayarea A wall built across a river or stream to impound the water. A dam normally does not have water flowing over the top of it.  
waterway User Defined node way    

Railway

See also landuse=railway.

Key Value Element Comment Example
railway station node Railway station (Other languages). Mapping-Features-Railroad-With-Station.png
railway halt node A small station, may not have a platform, trains may only stop on request. Mapping-Features-Tram-With-Halt.png
railway tram_stop node A tram stop is a place where a passenger can embark / disembark a tram.  
railway viaduct node A high or long bridge with intermediate support piers (Other languages).  
railway crossing node A point where pedestrians may cross.  
railway level_crossing node A point where rails and roads cross.  
railway rail way Full sized passenger or freight trains in the standard gauge for the country or state Mapping-Features-Railroad-With-Station.png
railway tram way One or two carriage rail vehicles, usually sharing motor road (Other languages) Mapping-Features-Tram-With-Halt.png
railway light_rail way Short/light passenger trains. Metro systems.  
railway subway way A passenger rail service running mostly underground.  
railway subway_entrance node The entrance to a subway station, usually going from surface to underground.  
railway preserved way A railway running historic trains, usually a tourist attraction (changed to preserved from preserved_rail as "rail" is redundant).  
railway disused way A section of railway which is no longer used but where the track and infrastructure remains in place.  
railway abandoned way The course of a former railway which has been abandoned and the track and infrastucture removed. Designation not to be used if the feature has been turned into another use, eg cycleway.  
railway narrow_gauge way Narrow-gauge passenger or freight trains.  
railway monorail way A railway with only a single rail.  
railway User Defined node way    

Aeroway

Key Value Element Comment Example
aeroway aerodrome node An Aerodrome (UK), Airport (US), see also military=airfield  
aeroway terminal node area Airport passenger building  
aeroway helipad node Helicopter start/landing pad Aeroway-helipad.png
aeroway runway way A strip of land kept clear and set aside for airplanes to take off from and land on. (Other languages) Rendering-aeroway runway.png
aeroway taxiway way Where airplanes manouevre between runways and parking areas. Rendering-aeroway taxiway.png
aeroway apron area A place where planes are parked.  
aeroway User Defined node way    

Aerialway

Key Value Element Comment Example
aerialway cable_car way A cabin or gondola cable car run.  
aerialway chair_lift way An open chairlift run.  
aerialway drag_lift way An overhead tow-line for skiers and riders.  

Power

Key Value Element Comment Example
power tower node For towers or pylons carrying high voltage electricty cables. Normally constructed from steel latticework. Should not be used for electricity or telephone cables carried on single wooden poles.  
power line way A way following the path of power cables.  
power sub_station node area A tag for electric substations.

Man Made

Key Value Element Comment Example
man_made works node Industrial building to produce something  
man_made beacon node    
man_made survey_point node Triangulation pillars, geodetic vertices, and fixed equipment used by topographers (e.g. DGPS radio stations)  
man_made power_wind node Wind generated power, see also man_made=windmill  
man_made power_hydro node Power generated by water (from a river, lake, tide, ...)  
man_made power_fossil node Power generated by burning fossils (oil, gas, ...)  
man_made power_nuclear node Nuclear power plant  
man_made tower node A tall and often lean building or structure e.g. telecoms. Also see "Historic" below.  
man_made water_tower node A tower to store water in, usually found on hills beside or in a town  
man_made gasometer node http://en.wikipedia.org/wiki/Gasometer Gasometer.jpg
man_made reservoir_covered node area    
man_made lighthouse node Sends out a light beam to guide ships  
man_made windmill node Windmill, mostly ancient and out of order, see also man_made=power_wind Windmill.png
man_made pier way area A "bridge into the ocean", usually for recreation  
man_made pipeline way A pipe for carrying various fluids, such as water, gas, sewage  
man_made wastewater_plant node area Facilities used to treat wastewater (known as sewage in some countries)  
man_made User Defined node    

Leisure

Key Value Element Comment Example
leisure sports_centre node area    
leisure golf_course node area    
leisure stadium node area A major sports arena with substantial tiered seating  
leisure track node area e.g. running, cycle-racing, greyhound, horses  
leisure pitch node area e.g. a field for playing football/soccer, cricket, baseball sports  
leisure water_park node area    
leisure marina node area For mooring leisure yachts and motor boats  
leisure slipway node Boats can be launched here
leisure fishing node area    
leisure nature_reserve node area    
leisure park node area    
leisure playground node area    
leisure garden node area    
leisure common node area An area where the public can walk anywhere (UK)  
leisure User Defined node area    

Amenity

Key Value Element Comment Example
amenity pub node A place selling beer and other alcoholic drinks; may also provide food or accommodation (UK)
Amenity-pub.png
amenity biergarten node http://en.wikipedia.org/wiki/Biergarten
Bierkrug32x32.png
amenity nightclub node a nightclub
Nightclub.png
amenity cafe node a cafe
Coffee.png
amenity restaurant node Restaurant (not fast food)  
amenity fast_food node Fast Food Restaurant  
amenity parking node area Car Park. Only nodes will get a parking symbol. Areas will be colored. Streets on car parking are often tagged highway=service Mapping-Features-Parking-Lot.png Concept example
amenity bicycle_parking node area Parking for bicycles  
amenity bicycle_rental node Rent a bicycle (only big rental networks)  
amenity car_rental node area Rent a car  
amenity car_sharing node area Share a car  
amenity taxi node area A place where taxis wait for passengers.  
amenity fuel node Petrol station; gas station; marine fuel; ... Streets to petrol stations are often tagged highway=service.
Rendering-amenity fuel.png
amenity telephone node Public telephone
amenity toilets node Public toilets (might require a fee)
Toilets.png
amenity recycling node recycling facilities (bottle banks etc.)
Recycling.png
amenity public_building node area    
amenity townhall node area A town hall building, regardless of whether it is currently used for administrative purposes
Townhall.png
amenity place_of_worship node A church, mosque, or temple, etc. Note that you also need religion=<whatever>, usually denomination=<whatever> and preferably name=<whatever> as well as amenity=place_of_worship. See the article for details.  
amenity grave_yard node area A (smaller) place of burial, often you'll find a church nearby. Large places should be landuse=cemetery instead.  
amenity post_office node    
amenity post_box node Alternative mail-carriers can be tagged via "operator=";
Amenity-post box.png
Post Box.JPG
amenity school node area school and grounds
Icon-amenity school.png
amenity university node area a University campus or buildings
Icon-amenity university.png
amenity college node area a College campus or buildings
College.png
amenity pharmacy node Pharmacy
dispensing=yes
dispensing=no or omitted
Pharmacy dispencing.png

Pharmacy nondispensing.png
amenity hospital node area  
Rendering-amenity hospital.png
amenity library node A public library (municipal, university, ...) to borrow books from. Rendering-amenity-library.png
amenity police node A Police station  
amenity fire_station node A Fire station  
amenity bus_station node Bus Station (this is a big station, a bus stop is highway=bus_stop)  
amenity theatre node a theatre or opera house
Theatre.png
amenity cinema node a cinema
Cinema.png
amenity arts_centre node an arts centre
Palette.gif
amenity courthouse node a place where justice is dispensed
JusticeScales.png
amenity prison node a prison  
amenity bank node a bank (for a bank that also has an ATM, use amenity=bank;atm)  
amenity bureau_de_change node Bureau de change, Currency exchange, Wechsel, Cambio - a place to change foreign bank notes and travellors cheques
Bureau de change.png
amenity atm node an ATM or cash point  
amenity fountain node area A fountain for cultural / decorational / recreational purposes.
amenity User Defined node    

Shop

Key Value Element Comment Example
shop User Defined node Feel free to use/invent values suitable for your country, a small global set is also being developed for ease of rendering and searching  
shop supermarket node area Supermarket Rendering-amenity supermarket.png
shop convenience node Convenience Store - a small local store usually selling a small selection of food items plus things like simple first aid, household, stationary and car items  
shop butcher node Selling meat  
shop bicycle node A shop that sells bicycles, bicycle equipment and may rent or repair them
shop doityourself node A shop that sells tools and supplies to do-it-yourself householders, gardening, ...
shop dry_cleaning node A shop or kiosk offering a clothes dry cleaning service. The actual cleaning may be done elsewhere.  
shop outdoor node A shop that sells camping, walking, climbing, fishing and other outdoor sports equipment (and GPSes)  
shop kiosk node area A small shop on the pavement that sells magazines, tobacco, newspapers, sweets and stamps.
Kiosk germany.jpg

Tourism

Key Value Element Comment Example
tourism information node    
tourism hotel node Wikipedia:Hotel Rendering-tourism hotel.png
tourism motel node Wikipedia:Motel  
tourism guest_house node Wikipedia:Guest House  
tourism hostel node Wikipedia:Hostel Tourism-hostel.png
tourism camp_site node area A place where you can pitch a tent  
tourism caravan_site node area A place where you can park a caravan overnight or for longer periods  
tourism picnic_site node area A place where you can have an outdoor picnic. May have facilities such as tables and benches.  
tourism viewpoint node A place, often high, with a good view of surrounding countryside or notable buildings  
tourism theme_park node area    
tourism attraction node area    
tourism zoo node area    
tourism artwork node way area A tag for public pieces of art.  
tourism User Defined node area    

Historic

Key Value Element Comment Example
historic castle node Other languages  
historic monument node An object, especially large and made of stone, built to remember and show respect to a person or group of people. Other languages  
historic memorial node Much like a monument, but smaller. Might range from a WWII memorial to a simple plate on a wall.  
historic museum node Other languages  
historic archaeological_site node area Excavation place for ancient remains  
historic ruins node area Remains of a castle or alike, usage was abandoned  
historic User Defined node    

See also railway=preserved for historic trains.

Landuse

Key Value Element Comment Example
landuse farm node area Animals, vegetables, flowers, fruit growing (Other languages) Landuse-farm.png
landuse quarry node area Surface mineral extraction (Other languages)  
landuse landfill node area Place where waste is dumped upon. Other languages  
landuse basin node area Other languages Landuse-basin.png
landuse reservoir node area Stores water, may covered or uncovered (Other languages) Landuse-reservoir.png
landuse forest node area Managed forest or woodland plantation (Other languages). See also natural=wood Landuse-forest.png
landuse allotments node area A piece of land given over to local residents for growing vegetables and flowers (UK). "Kleingärten" (DE) Landuse-allotments.png
landuse residential node area Predominantly houses or apartment buildings  
landuse retail node area Predominantly shops Landuse-retail.png
landuse commercial node area Predominantly offices Landuse-commercial.png
landuse industrial node area Predominantly workshops, factories or warehouses Landuse-industrial.png
landuse brownfield node area Describes land scheduled for new development where old buildings have been demolished and cleared File:Landuse-brownfield.png
landuse greenfield node area Describes land scheduled for new development where there have been no buildings before  
landuse railway node area Area for railway use, generally off-limits to the general public  
landuse construction node area "Under construction" site, should become something different once the construction is finished  
landuse military node area For land areas owned/used by the military for whatever purpose  
landuse cemetery node area Place for burials. Smaller places (e.g. with a church nearby) may use amenity=grave_yard instead. Landuse-cemetery.png Cemetery-photo.JPG
landuse village_green node area An area of common land, usually grass, in the centre of a village (quintessentially English - defined separately from 'common land' under the Commons Registration ACt 1965 and the Commons Act 2006) Landuse-village green.png
landuse recreation_ground node area An open green space for general recreation, which may include pitches, nets and so on, usually municipal but possibly also private to colleges or companies Landuse-recreation ground.png
landuse User Defined node area    

Military

See also landuse=military.

Key Value Element Comment Example
military airfield node area A place where military planes take off and land  
military bunker node Buildings, often build from concrete, to stand even heavier fire.  
military barracks node area Buildings where soldiers live and work.  
military danger_area node area Usually a large marked area around something like a firing range, bombing range, etc which is an exclusion zone.  
military range node area Where soldiers have practice with their weapons (firing, bombing, artillery, ...).  
military User Defined node area    

Natural

Key Value Element Comment Example
natural spring node A place where ground water flows naturally from the ground ((hydrology, land) (3596) Other languages)  
natural peak node top of a hill or mountain Peak.jpg
natural glacier node area Areas (or peaks) covered with ice throughout the year Glacier.jpg
natural volcano node A volcano, either dormant, extinct or active  
natural cliff node area Rock face  
natural scree node area Loose rock  
natural scrub node area Uncultivated land covered with bushes or stunted trees  
natural fell node area Bare upper lying uncultivated land principally covered with grass and often grazed.  
natural heath node area Bare lower lying uncultivated land with bushes but little or no tree cover.  
natural wood node area Natural woodland (trees). See also landuse=forest  
natural marsh node area waterlogged area  
natural water node area Lakes, etc. Always keep water on the right side of the way and land on the left side, in relation to the sequence of nodes in the Way for it to show correctly on rendered maps.  
natural coastline node way area The coastline should run clockwise around water and anti-clockwise around land, i.e. land on the left side and water on the right side of the way (that is, according to the sequence of nodes in the way), for it to show correctly.  
natural mud node area (Other languages)  
natural beach node area Beach: sand, gravel or pebble (Other languages) Beach.jpg
natural bay node area Bay (Other languages)  
natural land node area Land that exists within another area, such as a lake. (i.e an island). Keep water on the right and land on the left side in relation to sequence of nodes in the Way. Layering may also be required  
natural User Defined node area    

Non Physical

Route

Key Value Element Comment Example
route bus way The route a public bus takes  
route ferry way The route a ferry takes from terminal to terminal  
route flight way    
route ncn way Deprecated. See Cycle routes for tagging details.  
route subsea way    
route ski way    
route tour way    
route pub_crawl way (UK/US) An (unofficial!) route connecting a series of pubs according to some pre-arranged plan or theme  
route User Defined way    

Boundary

Key Value Element Comment Example
boundary administrative area e.g. State, county, local council (unclear how these are specified. Clarify!). Use therefore border_type=  
boundary civil area    
boundary political area Electoral boundaries  
boundary national_park area Area of outstanding natural beauty, set aside for conservation and for recreation (Other languages)  

Sport

Key Value Element Comment Example
sport 10pin node area 10-pin Bowling  
sport athletics node area    
sport baseball node area    
sport basketball node area  
sport bowls node area Lawn bowls  
sport climbing node area Rock climbing - natural or articial climbs (climbing walls)  
sport cricket node area    
sport cricket_nets node area Cricket nets for practise  
sport croquet node area    
sport cycling node area    
sport dog_racing node area    
sport equestrian node area    
sport football node area (Clarification is needed here; does this refer to the game known as "soccer" in North America, or to something like American/Canadian football? Given that sport=soccer is also listed, I'm inclined towards the latter interpretation... Dshpak 23:10, 4 August 2007 (BST)). A less ambiguous way would be to use the true (internationally recognised) names for these sports, i.e. Association Football, Rugby Union Football, American Football, Rugby League Football, Australian Rules Football, etc.  
sport golf node area   Sport-golf.png
sport gymnastics node area    
sport hockey node area    
sport horse_racing node area    
sport motor node area    
sport multi node area    
sport pelota node area    
sport racquet node area    
sport rugby node area    
sport skating node area    
sport skateboard node area    
sport soccer node area   Sport-soccer.png
sport swimming node area   Sport-swimming.png
sport skiing node area    
sport table_tennis node area    
sport tennis node area Tennis courts Sport-tennis.png

Abutters

Key Value Element Comment Example
abutters residential way predominantly houses and apartments  
abutters retail way predominantly shops  
abutters industrial way predominantly workshops, factories, warehouses Abutters-industrial.jpg
abutters commercial way office buildings, business parks, etc.  
abutters mixed way where there is no clear predominance, for example mixed shops and residences in an inner city ring  

Accessories

Key Value Element Comment Example
fenced yes/no way    
lit yes/no way Street lighting --- this tag is listed on Deprecated_features but there is no alternative proposed  

Properties

Key Value Element Comment Example
area yes area Making a closed way render solid  
bridge yes way A bridge, use together with the layer tag. Concept example  
tunnel yes way A tunnel, use together with the layer tag. Concept example  
mountain_pass yes node The highest point of a mountain pass.  
cutting yes way A cut in the land to carry a road or tram. Mostly in hilly landscape. Source Picture  
embankment yes way A raised bank to carry a road, railway, or canal across a low-lying or wet area. Source  
lanes Num way Number of travel lanes in each (or only permitted) direction  
layer -5 to 5 way This numerical tag used to be `elevation', however it got renamed due to confusion with the ele and altitude tags used by tracklog imports. layer:-1
layer:1 (not +1)
surface paved/unpaved way    
ele Num node Altitude (meter over sea level)  
width Num way Width of way in metres  
est_width Num way A rough guess of the width of way in metres  
depth Num way area Depth in metres  
est_depth Num way area A rough guess of the Depth in metres  
start_date Date way Date feature was created  
end_date Date way Date feature was removed  
operator User Defined node way area The operator tag can be used to name a company or corporation who's responsible for a certain object or who operates it "A Company"

Restrictions

Key Value Element Comment Example
access yes/private/ permissive/ unknown/no way General access permission. 'permissive' means there is no legally-enshrined right of access, but the landowner has allowed it at his/her discretion. 'private' means access is restricted to the landowner.  
bicycle yes/private/ permissive/ unknown/no way Access permission for bicycles. For values see above  
foot yes/private/ permissive/ unknown/no way Access permission for pedestrians. For values see above  
goods yes/private/ permissive/ unknown/no way Access permission for light commercial vehicles (LCV) or goods vehicles of category N1 with a maximum allowed mass of up to 3.5 tonnes. For values see above  
hgv yes/private/ permissive/ unknown/no way Access permission for Heavy Goods Vehicles (HGV) (UK), e.g. for goods vehicles of category N2 and N3 (trucks, lorries) with a maximum allowed mass over 3.5 tonnes. For values see above  
horse yes/private/ permissive/ unknown/no way Access permission for horse riders. For values see above  
motorcycle yes/private/ permissive/ unknown/no way Access permission for motorcycles. For values see above  
motorcar yes/private/ permissive/ unknown/no way Access permission for (motor) cars. For values see above  
psv yes/private/ permissive/ unknown/no way Access permission for Public Service Vehicles (UK), e.g. buses and coaches. See above  
motorboat yes/private/ permissive/ unknown/no way    
boat yes/private/ permissive/ unknown/no way    
oneway yes (or true/1)/
-1/
no (or false)
way The permitted direction for a way is indicated by sequential order of nodes within the way (enable arrows in JOSM!). -1 for oneway direction opposite to the sequence of nodes. Concept example  
noexit yes way A dead end road/cul de sac with only one access road  
date_on Date way Date restriction starts  
date_off Date way Date restriction stops  
day_on Day of Week way Day restriction starts  
day_off Day of Week way Day restriction stops  
hour_on Time way Time restriction starts  
hour_off Time way Time restriction stops  
maxweight Num way Weight limit in tonnes  
maxheight Num way height limit in metres  
maxwidth Num way width limit in metres  
maxlength Num way length limit in metres  
maxspeed Num way Maximum speed in km/h  
minspeed Num way Minimum speed in km/h  
toll yes node way area Toll or fee must be paid to access way, see also highway=toll_booth  

Naming

Name

Key Value Element Comment Example
name User Defined node way area The common default name  
int_name User Defined node way area International name  
nat_name User Defined node way area National name  
reg_name User Defined node way area Regional name  
loc_name User Defined node way area Local name  
old_name User Defined node way area Historical name  
name:lg User Defined node way area Name in different language eg. name:fr=Londres. See: Bilingual_street_names  

References

Key Value Element Comment Example
ref User Defined node way area The common default reference (eg M25)  
int_ref User Defined node way area International reference (eg E30)  
nat_ref User Defined node way area National reference  
reg_ref User Defined node way area Regional reference  
loc_ref User Defined node way area Local reference  
old_ref User Defined node way area Historical reference  
ncn_ref User Defined way The number reference (eg 54) of a National Cycle Network route. In the UK, national routes have single-or double-digit numbers with a red background on the signs. Ncn1-Cramond.JPG
rcn_ref User Defined way The number of the regional cycle network. In the UK the regional routes have double-digit numbers with a blue background on the signs. NCN1Dalkeith-PenicuikRegional73.jpg
(Sign showing both national and regional spur).
lcn_ref User Defined way The number of the local cycle network Cycle route sign.jpg
source ref User Defined node way area To record the URI, source reference (eg Landsat) or other link to physical sources.  
icao User Defined node way area ICAO International airport codes  
iata User Defined node way area IATA International airport codes  

Places

Key Value Element Comment Example
place continent node area One of the continents: Asia, Africa, North America, South America, Antarctica, Europe, Australia
(from largest in size to smallest)
Place-continent.png
place country node country (on areas and ways, border_type=nation is used instead) Place-country.png
place state node area state  
place region node area region  
place county node area county  
place city node area As defined by national/state/provincial government. Often over 100,000 people Place-city.png
place town node area As defined by national/state/provincial government. Generally smaller than a city, between 10,000 and 100,000 people  
place village node area As defined by national/state/provincial government. Generally smaller than a town, below 10,000 people  
place hamlet node area As defined by national/state/provincial government. Generally smaller than a village, just a few houses  
place suburb node area Named area of town or city. Often a suburb is its own municipality, with separate government, and should be tagged as such. Place-suburb.png
place locality node area An unpopulated, named place.  
place island node area identifies an island (see also natural=land)  

See OSM_tags_for_routing for the guideline to automatic interpretation of this tag.

See also the FAQ for a description how to use areas and nodes when tagging a place.


Key Value Element Comment Example
place_name User Defined area Only for areas. For nodes use 'name' instead (see Notes). It may do no harm to use both, though.  
place_numbers User Defined node way area For property numbers  
postal_code User Defined node way area The postal code  
is_in User Defined node way area For categorisation - for example place=suburb; name=Eccleshall; is_in=Sheffield,South Yorkshire,England,UK  

Annotation

some keys are allowed with one of the following values.

Key Value Element Comment Example
note User defined node way area A note to yourself or to other mappers. There is a map where you can view notes  
description User defined node way area Text that might be viewable to the end user (perhaps using a search system or a map with pop-ups).  
image URI node way area Reference to an image (use the "source_ref" key below when the image is referencing the source of the element)  
source extrapolation node way area Extension of information from a known source  
source knowledge node way area Local or common knowledge  
source historical node way area from out-of-copyright mapping or other historical document  
source image node way area photograph or video  
source survey node way area gpx track or other physical survey  
source voice node way area Voice recordings, eg dictaphone  
source User defined node way area    
source_ref User defined node way area To record the URI, source reference (eg Landsat) or other link to physical sources.  

Editor keys

These keys are set by the editor (usually JOSM or Potlatch) and are not intended to be changed manually.

Key Value Element Comment Example
created_by defined by editor node way area Identifies the editing software which carried out this edit.  
history defined by editor node way area Used to identify a way that has been recovered from an earlier version.