User:Innesw/TagTree
This page is still an incomplete draft. Please don't edit it or add comments yet. |
This is my (still developing) grand scheme for tagging map objects.
OpenStreepMap, as its name implies, began life mapping the highways and byways of the world. It was not initially intended to be the equivalent of a UK Ordinance Survey map. This emphasis on utility for the traveller led to the development of a tag structure that emphasised some landscape features over others, rather than developing a comprehensive scheme for mapping all of what is on the ground (and some of what is not). This is especially apparent in the use of amenity=*, which is used for traveller-useful features, but which (with the growing mapping of individual buildings) tends to be added when tags for a full description of a building (and its use) should adequately do the task.
This document is my attempt at an (admittedly idealistic) tagging scheme that is based on consistent principles rather than historical precedent. It is in a few respects a radical change from the existing tags structure. Although it retains many currently-used tags, it is not constrained by current OSM practice. There are some notes on the differences between my ideal and current practice, but they cannot be considered comprehensive.
General Principles
All map objects in OSM consist of two parts:
- A geographic location. This is either a single point in map space, or a series of such points linked together.
- A description. In OSM this is always one or more tags, each of which is a key=value pair.
Object Location
The basic location element is a reference in map space, a single location consisting essentially of a pair of latitude and longitude values, and is referred to as a node.
Map objects are any of:
- a point, which has a single node
- a way, which is an ordered set of nodes. Ways can be:
- open, if the two end nodes do not coincide
- closed, if the two end nodes do coincide
- Whether a closed way is rendered as an area or just a closed line depends on its tags
- a relation, which is an ordered set of nodes, ways or other relations
Object Tags
Tags on map objects consist of a single key and a single value, and are always written in OSM documentation as key=value. Both the key and the value are simply text.
There are two categories of tag:
- tags that define the 'type' of a mapped object
- tags that assign additional 'attributes' to a map object
I impose here a strict distinction between 'type' and 'attribute' tags.
Type Tags
Type-tags define the 'type' of an object. In theory all objects have a type, but in practice not all objects have an explicit type-tag. This is because some attribute tags imply a type. It is possible for an object to have two types, but it is fairly rare.
Type-tags form a tree structure, with the base of the tree being a theoretical object_type=*, that is in fact never used.
In theory, each sub-type of a type-tag has a key that is the same as the value of its parent tag in the tree. I also like to think of each key as having the suffix '_type'.
For example:
In practice the '_type' suffix (or its variation ':type') is in use, but not extensively, and it is usually unnecessary. Further, the theory that the key for a 'child' tag is the value of its 'parent' is also not adhered to, so we have:
- building=retail
- building=commercial
- office=accountant - 'office' == 'commercial_type'
Because a tag contains two pieces of information (the key and the value), it is often redundant to explicitly include the parent tag. For example building=retail contains the information that the object is a building, and that it is of building(_type) retail, so object_type=building is unnecessary. (At the top of the tree, object_type=* is in fact universally redundant.)
Attribute Tags
Attribute tags provide information about an object other that its 'type'.
Some attribute tags can be applied to any object, though most are only applicable for objects of a specific type, or where another specific attribute has been applied.
There is an existing category of keys called 'properties', which defines them as Used to give additional information of a general nature about another element, but it does not comprehensively cover what I have categorised as 'attribute' tags.
Attribute tags can currently come in a number of forms in terms of structure:
- attribute tags with the same structure as type tags: attribute=value
- attribute tags that are suffixes to type tags: type:attribute=value eg: arialway:occupancy=*, arialway:capacity=*
- As these apply to objects of type aerialway=*, in my ideal structure the 'arialway:' part of the attribute tags would be dropped, and there would simply be attribute tags of occupancy=* and capacity=*.
- suffix tags that can have multiple values, eg: under social_facility=* there are : social_facility=:for, social_facility=:for
amenity=*
The amenity tag is ambiguous as to whether a given value is a 'type' or an 'attribute'. 'Amenity' simply indicates 'there is something useful here'. In my grand-scheme (below) I have categorised some amenity values as type-tags, because they are usually used alone, and others as attributes because they are virtually always applied to map objects that already have a type.
Note that some amenity values are usually applied to an area (eg: the whole of a church grounds is tagged amenity=place_of_worship), with other tags to buildings (eg: the church itself is tagged building=church) within those grounds. However if a building has no grounds (it abuts other buildings), the amenity tag is applied to the building itself. There are also buildings that do not have a building=* tag, but only an amenity=* tag. Yet other amenity tags are usually applied to point objects (eg: amenity=post_box). Amenity values that are usually used in these ways (where there is no other type) I have classified as type tags.
Note: from here on in this document, notes in italics are my editorial notes, usually about differences between my structure and current OSM practice.
Landcover and Landuse
In my opinion, the current structure for mapping areas lacks much 'system', so I would propose that all areas be classified with both a 'landcover' and a 'landuse'. Landcover values simply describe what is actually on the ground, while landuse values describe a human-ascribed use to an area. Although it is frequent for a given value in either of these keys to imply a value in the other, the implied values can always be over-ridden by an explicit tag.
Map areas that represent what is actually 'on the ground' (as opposed to administrative and similar boundaries), should (in theory) be tagged initially with both a landcover value and a landuse value. In practice, particularly in urban areas (landcover=built_up or landcover=building), it is not uncommon to begin the tag sequence further down the landuse tree, with the initial key implying landuse and landcover values further up the hierarchy.
In theory also, there should be no spatial overlap of different landcover or different landuse areas, but in practice larger areas will be defined (for example) with a given landcover, and smaller areas within a larger one will have a different landcover. This will commonly be the case for smaller settled areas within larger agricultural or natural environments.
In theory 100% of the earth's surface should be covered by both of a landcover=* and a landuse=* value. The landcover values are mostly varieties of natural cover (eg: landcover=swamp) and imply landuse=nature, while most of the landuse values are varieties of human-ascribed use, and most apply to human-transformed areas, largely agricultural and urban.
The landcover=* and landuse=* tags should be used only for area map objects, not for point (node) or linear (open-way) features.
Landcover
this is still subject to further development in another space
- > landcover=* - what actually covers the land
- > landcover=ocean
- > landcover=bay
- > landcover=lake
- > landcover=river
- > landcover=reservoir - this simply implies an artificial lake behind a wall. It does not imply any particular use for the water.
- > landcover=canal
- > landcover=ice
- > landcover=tidalflat
- > landcover=sandy_beach
- > landcover=gravel_beach
- > landcover=*
- + leaf_type=*
- + leaf_cycle=*
- + cover=*
- > landcover=*
===Landuse===-------------------------------
- > landuse=* - a human-ascribed use for an area
- > landuse=agriculture - where animals or plants are grown for food, fibre or industrial use
- > agriculture=* - see agriculture below
- > landuse=cemetery - where the bodies of the dead are attended to, stored or buried
- > cemetery=* - see cemetery below
- > landuse=commercial - where something is sold
- > commercial=accommodation - where people pay to stay short-term
- > accommodation=* - see accommodation below
- > commercial=administration - where administration of commercial or industrial activities (at other places) occurs
- > commercial=craft - where small-scale makers make their goods, and often sell them too
- > craft=* - see craft below
- > commercial=food - where food and/or drink is sold and is about to be consumed, either on the premises or take-away
- > food=* - see food below
- > commercial=retail - where goods are sold to the public
- > retail=* - see retail below
- > commercial=service - where services are sold to the public
- > service=* - see service below
- > commercial=accommodation - where people pay to stay short-term
- > landuse=education
- > education=* - see education below
- > landuse=healthcare
- > healthcare=* - see healthcare below
- > landuse=historic
- > historic=* - see historic below
- > landuse=industry - where goods are made, processed or stored, usually to be used or sold elsewhere
- > industry=* - see industry below
- > landuse=landfill
- > landuse=leisure - where people spend their leisure time
- > leisure=entertainment - where an audience is entertained by performers
- > entertaiment=* - see entertainment below
- > leisure=* - see leisure below
- > leisure=entertainment - where an audience is entertained by performers
- > landuse=military
- > military=* - see military below
- > landuse=nature
- > landuse=protected_area
- > protected_area=* - see protected_area below
- > landuse=religion
- > religion=* see religion below
- > landuse=residential - where people live long-term
- > residential=* see residential below
- > landuse=service
- > service=emergency_service
- > emergency_service=* - see emergency_service below
- > service=government
- > government=* - see government below
- > service=social_facility
- > social_facility=* - see social_facility below
- > service=toilets
- > toilets=* - see toilets below
- > service=emergency_service
- > landuse=timber_production - where the primary management is for timber
- > landuse=tourism
- > tourism=* - see tourism below
- > landuse=transport
- > landuse=urban - a catch-all for urban areas that have not been differentiated into more specific uses
- > landuse=utility
- > utility=communication
- > communication=* - see communication below
- > utility=gas_supply
- > gas_supply=* - see gas_supply below
- > utility=power
- > power=* - see power below
- > utility=sewerage
- > sewerage=* - see sewerage below
- > utility=water_supply
- > water_supply=* - see water_supply below
- > utility=communication
- > landuse=agriculture - where animals or plants are grown for food, fibre or industrial use
Tag Tree
This is my attempt at a comprehensive tag tree. It is a theoretical structure, including most current tag values, but with a structure of tag keys that does not necessarily reflect current practice.
Type-tags are prefixed with '>', attribute tags are prefixed with '+'. 'Attribute' tags in this sense are my classification of the tag: they do not necessarily have a key with a type:attribute structure.
Attribute tags that can be applied to map objects of any (or almost any) type are listed at the bottom of the tree (as they apply to objects of the theoretical type object_type). Some attributes are applicable to more than one (but a limited number of) types. These are usually listed in detail under only one of these types, the others have a '- see under ..' cross reference.
Summary - Base Types
Each of these types has further details in the complete tree below. It summarises the 'base types' of the complete tree.
- > aerialway
- > aeroway
- > accommodation
- > agriculture
- > amenity (some values only)
- > barrier
- > boundary
- > building
- > cemetery
- > craft
- > education
- > government
- > healthcare
- > highway
- > historic
- > industry
- > leisure
- > man_made
- > military
- > mining
- > natural
- > place
- > power
- > protected area
- > public_transport
- > railway
- > residential
- > route
- > service
- > shop
- > social_facility
- > toilets
- > tourism
- > waterway
The Complete Tag Tree
aerialway
- - transport for passengers and goods that use wires, including cable-cars, chair-lifts and drag-lifts
- - implies landuse=transport and transport=aerialway
- > aerialway=cable_car
- > aerialway=chair_lift
- > aerialway=drag_lift
- > aerialway=gondola
- > aerialway=j-bar
- > aerialway=magic_carpet
- > aerialway=mixed_lift
- > aerialway=platter
- > aerialway=pylon
- > aerialway=rope_tow
- > aerialway=station
- > aerialway=t-bar
- > aerialway=zip_line
- > aerialway=*
- + arialway:occupancy=*
- + arialway:capacity=*
- + arialway:duration=*
- + arialway:bubble=*
- + arialway:heating=*
- + arialway:bicycle=*
- + arialway:access=*
- + arialway:summer:access=*
aeroway
accommodation
- - where people pay to stay short-term
- implies building=commercial and commercial=accommodation, and landuse=accommodation
- - current practice is to use tourism=* for these
- - see also accommodation tags under building=*
- > accommodation=apartment
- > accommodation=caravan_park
- > accommodation=cabin
- > accommodation=chalet
- > accommodation=guest_house
- > accommodation=hostel
- > accommodation=hotel
- > accommodation=house_boat
- > accommodation=motel
- > accommodation=static_caravan
agriculture
- - where animals or plants are grown for their products
- - implies landuse=agriculture
- - currently many of these values are tagged under the landuse=* key. There is probably no problem with this, as they are simply more specific landcover values.
- > agriculture=allotments
- > agriculture=cropping
- > agriculture=farmland - generic agricultural land, especially where the distinction between cropping and grazing is seasonal or unknown
- > agriculture=farmyard - the area, often fenced from the surrounding agricultural land, containing dwellings, farm auxiliary buildings, feed bunkers etc.
- > agriculture=grazing
- > agriculture=horticulture - annual fruit and vegetables
- > agriculture=intensive - where animals or plants are in high density and food is brought to them
- > agriculture=orchard - perennial fruits and nuts, or non-grape vines and cane fruits
- > agriculture=plantation - trees planted for their timber or other non-fruit products
- > agriculture=plant_nursery
- > agriculture=vineyard
- - the following are usually tagged as building=*
- > agriculture=barn
- > agriculture=cowshed
- > agriculture=dairy - where cows are milked
- > agriculture=farmhouse - a farm residence where it has distinct features different from a general house
- > agriculture=greenhouse
- > agriculture=stable
- > agriculture=sty
amenity'
- > amenity=atm
- > amenity=baby_hatch
- > amenity=bbq
- > amenity=bench
- > amenity=boat_sharing
- > amenity=bicycle_parking
- > amenity=car_sharing
- > amenity=charging_station
- > amenity=clock
- > amenity=compressed_air
- > amenity=drinking_water
- > amenity=ferry_terminal
- > amenity=fountain
- > amenity=grit_bin
- > amenity=parking_entrance
- > amenity=post_box
- > amenity=shelter
- > amenity=shower
- > amenity=telephone
- > amenity=vending_machine
- + vending=* - the goods supplied
- > amenity=waste_basket
- > amenity=waste_disposal
- > amenity=water_point
- > amenity=watering_place
barrier
- > barrier=city_wall
- > barrier=ditch
- > barrier=fence
- > fence_type=*
- > barrier=guard_rail
- > barrier=hedge
- > barrier=kerb
- + height=*
- > barrier=retaining_wall
- > barrier=wall
- > barrier=block
- > barrier=bollard
- > barrier=bus_trap
- > barrier=cattle_grid
- > barrier=chain
- > barrier=cycle_barrier
- > barrier=debris
- > barrier=entrance
- > barrier=full-height_turnstile
- > barrier=gate
- > barrier=height_restrictor
- + maxheight=*
- > barrier=horse_stile
- > barrier=jersey_barrier
- + material=*
- > barrier=kent_carriage_gap
- > barrier=kissing_gate
- > barrier=lift_gate
- > barrier=log
- > barrier=motorcycle_barrier
- > barrier=rope
- > barrier=sally_port
- > barrier=spikes
- > barrier=stile
- > barrier=sump_buster
- > barrier=swing_gate
- > barrier=toll_booth
- > barrier=turnstile
- > barrier=lift_gate
- + barrier=border_control
boundary
- > boundary=administrative
- > admin_level=*
- - see also place=*
- > boundary=maritime
- > boundary=national_park
- > boundary=political
- > boundary=postal_code
- > boundary=protected_area
- > boundary=fire_boundary
building
- - some values describe the physical nature of a building, others describe a general use-type
- - buildings may be tagged with one of the special building types below. If not, a building should be tagged with a landuse value, (eg: building=industrial) and all the appropriate sub-tags to the detail available.
- - implies landcover=building
- - If a building has surrounding grounds, tag the grounds with a first-level landuse=* value, repeat that in the building=*, and tag the building in detail.
building - use types
- > building=residential - where people live long-term. Implies landuse=residential
- > implied by residential=* - see that tag
- > building=civic
- > building=commercial - see craft' and service below
- > building=industrial - see industry below
- > building=public
- > building=retail - see shop below
- > building=service - see service below
- > building=transortation
building - specific structures - public
- > building=hospital
- > building=school
- > building=stadium
- > building=train_station
- > building=university
- places of worship - also add amenity=place_of_worship if used for this purpose
- > building=cathedral
- > building=church
- > building=chapel
- > building=mosque
- > building=synagogue
- > building=temple
- > building=shrine
- agricultural
- > building=barn
- > building=cowshed
- > building=farm_auxillary
- > building=greenhouse
- > building=stable
- > building=sty
- other
- > building=bridge
- > building=bunker
- > building=cabin
- > building=garage
- > building=garages
- > building=hangar - but see aeroway=hangar
- > building=hut
- > building=kiosk
- > building=roof
- > building=shed
- > building=transformer_tower
- > building=warehouse - should be deprecated in favour of industry=warehouse
- > building=*
- + building:levels=*
- + entrance=*
- + height=*
- + fireproof=*
- + addr:=*
- + addr:housenumber=*
- + addr:housename=*
- + addr:street=*
- + addr:place=*
- + addr:postcode=*
- + addr:city=*
- + addr:country=*
- + addr:full=*
- + addr:hamlet=*
- + addr:suburb=*
- + addr:subdistrict=*
- + addr:district=*
- + addr:province=*
- + addr:state=*
- + addr:interpolation=*
- these should be all under residential=* if the residents are permanent, or accommodation=* if they are short-term.
- > building=apartments
- > building=detached
- > building=dormitory
- > building=farm
- > building=hotel
- > building=house
- > building=houseboat
- > building=terrace
- > building=static_caravan
cemetery
- - where the bodies of the dead are attended to, stored or buried
- - implies landuse=cemetery
- > cemetery=crematorium
- > cemetery=crypt
- > cemetery=garden
- > cemetery=graves
- > cemetery=lawn
- > cemetery=*
- + religion=*
craft
- - where small-scale makers make their goods, and often sell them too
- - implies landuse=commercial, commercial=craft
- > craft=basket_maker
- > craft=blacksmith
- > craft=brewery
- > craft=boatbuilder
- > craft=bookbinder
- > craft=carpenter
- > craft=clockmaker
- > craft=confectionery
- > craft=dressmaker
- > craft=glaziery
- > craft=insulation
- > craft=jeweller
- > craft=locksmith
- > craft=engineering
- > craft=optician
- > craft=photographer
- > craft=plasterer
- > craft=plumber
- > craft=pottery
- > craft=saddler
- > craft=sailmaker
- > craft=sawmill
- > craft=sculptor
- > craft=shoemaker
- > craft=stomemason
- > craft=sun_protection
- > craft=tailor
- > craft=tinsmith
- > craft=upholsterer
- > craft=watchmaker
- > craft=window_construction
- > craft=winery
education
- implies landuse=education and building=education (which does not need to be created)
- > education=college
- > education=kindergarten
- > education=library
- > education=school
- > education=university
government
- - implies landuse=service, service=government and and building=government (which does not need to be created)
- > government=administration
- > government=consulate
- > government=courthouse
- > government=embassy
- > government=electorate_office
- > government=parliament
- > government=prison
- > government=registry
- > government=research
- > government=tax
- > government=*
- + government_level=*
healthcare
- implies landuse=healthcare
- > healthcare=clinic
- > healthcare=dentist
- > healthcare=doctors
- > healthcare=hospital
- > healthcare=veterinary
highway
- implies landuse=transport, transport=highway
- > highway=motorway
- > highway=motorway_link
- > highway=trunk
- > highway=trunk_link
- > highway=primary
- > highway=primary_link
- > highway=secondary
- > highway=secondary_link
- > highway=tertiary
- > highway=tertiary_link
- > highway=unclassified
- > highway=residential
- > highway=service
- + access=*
- > highway=living_street
- > highway=pedestrian
- > highway=track
- > tracktype=*
- + mtb:scale=*
- + mtb:scale:uphill=*
- + mtb:scale:imba=*
- + mtb:description=*
- > highway=bus_guideway
- > highway=raceway
- > highway=road
- > highway=footway
- + bicycle=yes
- + sac_scale=*
- + trail_visibility=*
- > highway=bridleway
- + trail_visibility=*
- > highway=cycleway - a separate way dedicated primarily to bicycles
- > cycleway=lane
- > cycleway=opposite_lane
- > cycleway=opposite
- > cycleway=shared_lane
- > cycleway=share_busway
- > cycleway=shared
- > cycleway=asl
- + cycleway=:left
- + cycleway=:right
- + cycleway=:surface
- + cycleway=:smoothness
- + foot=yes
- + trail_visibility=*
- > highway=steps
- + step_count=*
- > highway=path
- + mtb:scale=*
- + mtb:scale:uphill=*
- + mtb:scale:imba=*
- + mtb:description=*
- + sac_scale=*
- + trail_visibility=*
- > highway=mini_roundabout
- > highway=escape
- > highway=*
- > direction=*
- + bicycle=*
- > bicycle=yes/no
- > bicycle=designated
- > bicycle=use_sidepath
- > bicycle=permissive
- > bicycle=destination
- > bicycle=dismount
- + sidewalk=both/left/right/none
- + oneway=*
- + abutters=*
- + driving_side=left/right
- + ford=yes
- + ice_road=yes
- + incline=*
- + junction=roundabout
- + lanes=*
- + lit=yes/no
- + motorroad=yes/no
- + overtaking=*
- + parking:condition=*
- + parking:lane=*
- + passing_places=*
- + service=*
- + surface=*
- + tactile_paving=*
- + traffic_calming=*
- + trail_visibility=*
- + winter_road=*
- + mountain_pass=yes
- + highway=bus_stop
- + highway=crossing
- + highway=emergency_access_point
- + highway=give_way
- + highway=mini_roundabout
- + highway=motorway_junction
- + ref=*
- + highway=passing_place
- + highway=rest_area
- + highway=speed_camera
- + highway=street_lamp
- + highway=services
- + highway=stop
- + highway=traffic_signals
- + highway=turning_circle
- + emergency=phone
- + ref=*
- + bridge=*
- + tunnel=*
- > tunnel=yes
- > tunnel=culvert
- > tunnel=building_passage
- > tunnel=avalanche_protector
- + layer=*
- + cutting=yes
- + embankment=yes
- + est_width=*
- + width=*
- + narrow=*
historic
- - areas, buildings or sites preserved for their historic value
- - implies landuse=historic
- > historic=archeological_site
- > historic=aircraft
- > historic=battlefield
- > historic=boundary_stone
- > historic=building
- > historic=castle
- > historic=cannon
- > historic=city_gate
- > historic=citywalls
- > historic=farm
- > historic=fort
- > historic=manor
- > historic=memorial
- > historic=monument
- > historic=ruins
- - Ruins that are of special historic interest. They should also be tagged with the life-cycle keys status=ruined or status=preserved to describe their physical state.
- > historic=rune_stone
- > historic=ship
- > historic=tomb
- > historic=wayside_cross
- > historic=wayside_shrine
- > historic=wreck - a shipwreck
industry
- - where goods are made, processed or stored, usually to be used or sold elsewhere
- - implies building=industrial and landuse=industry
- > industry=cars
- > industry=chemical
- > industry=currency
- > industry=engineering
- > industry=iron_and_steel
- > industry=mining
- > mining=* - see mining below
- > industry=petrochemical
- > industry=salt_ponds
- > industry=small_engines
- > industry=tractors
- > industry=trucks
- > industry=waste_processing
- > waste_processing=* - specify the waste processed
- > industry=waste_storage
- > waste_storage=* - specify the waste stored
leisure
- - implies landuse=leisure and building=leisure (which does not need to be created).
- > leisure=beach_resort
- > leisure=bird_hide
- > leisure=common
- > leisure=dance
- > leisure=dog_park
- > leisure=firepit
- > leisure=fishing
- > leisure=garden
- > leisure=golf_course
- > leisure=hackerspace
- > leisure=ice_rink
- > leisure=marina
- > leisure=miniature_golf
- > leisure=nature_reserve
- > leisure=nightclub
- > leisure=park
- > leisure=pitch
- > sport=* - see sport below
- > leisure=playground
- > leisure=social_centre
- > leisure=stadium - lots of seating, most people are there to watch the sport, not to participate in it
- > sport=* - see sport below
- > leisure=swingerclub
- > leisure=slipway
- > leisure=sport_centre
- > leisure=swimming_pool
- > leisure=track
- > sport=* - see sport below
- > leisure=village_green
- > leisure=water_park
man_made Man-made features
- > man_made=adit
- > man_made=beacon
- > man_made=breakwater
- > man_made=bunker_silo
- > man_made=campanile
- > man_made=chimney
- > man_made=crane
- > man_made=cross
- > man_made=cutline
- > man_made=clearcut
- > man_made=embankment
- > man_made=dyke
- > man_made=flagpole
- > man_made=groyne
- > man_made=kiln
- > man_made=lighthouse
- > man_made=mast
- > man_made=mineshaft
- > man_made=monitoring_station
- > man_made=pier
- > man_made=pipeline
- > man_made=reservoir_covered
- > man_made=silo
- > man_made=snow_fence
- > man_made=snow_net
- > man_made=storage_tank
- > man_made=surveillance
- > man_made=survey_point
- > man_made=tower
- > tower_type=*
- > man_made=wastewater_plant
- > man_made=watermill
- > man_made=water_tower
- > man_made=water_well
- > man_made=water_works
- > man_made=windmill
- > man_made=works
mining
- - implies landuse=industry, industry=mining
- > mining=conveyor
- > mining=crushing_plant
- > mining=mine_entrance
- > mining=offshore_platform
- > mining=open_pit
- > mining=petroleum_well
- > mining=refining_plant - separating the desired mineral from the raw ore, by physical or chemical means
- > mining=storage_heap
- > mining=tailings_dam
- > mining=*
- + mineral=* - specify the mineral mined
natural Natural features (ie: not landcovers). These are rarely areas.
- > natural=arete
- > natural=dune
- > natural=dunefield
- > natural=cave_entrance
- > natural=cliff
- > natural=coastline
- > natural=glacier
- > natural=peak
- > natural=ridge
- > natural=saddle
- > natural=scree
- > natural=sinkhole
- > natural=spring
- > natural=stone
- > natural=tree
- > natural=tree_row
- > natural=volcano
place
- - administratively declared places
- > place=country
- > place=state
- > place=region
- > place=province
- > place=district
- > place=county
- > place=municipality
- - populated settlements, urban
- > place=city
- > place=borough
- > place=suburb
- > place=quarter
- > place=neighbourhood
- > place=city_block
- > place=plot
- - populated settlements, urban and rural
- > place=town
- > place=village
- > place=hamlet
- > place=isolated_dwelling
- > place=farm
- other places
- > place=continent
- > place=archipelago
- > place=island
- > place=islet
- > place=locality
- > place=*
- + population=*
- + postal_code=*
- + reference_point=yes
power
- - implies landuse=utility, utility=power
- > power=plant
- > power=cable
- > power=cable_distribution_cabinet
- > power=converter
- > power=generator
- + generator:source=*
- + generator=:source
- + generator=:output
- > power=heliostat
- > power=line
- > power=minor_line
- > power=pole
- > power=substation
- > substation=* - there are types for sub-station components, not specified here
- > power=switch
- > power=tower
- > power=transformer
- > power=transformer_tower
- > power=*
- + voltage=*
protected area
- - Use as a landuse value when the primary designated use of the land is protection. Some of these values are appropriate as overlays on other landuses (eg: a RAMSAR-wetland over a sewerage-teatment area).
- - implies landuse=protected_area
- > protected_area=yes
- > protected_area=nature
- > protected_area=nature_reserve_strict
- > protected_area=nature_reserve_wilderness
- > protected_area=nature_reserve
- > protected_area=national_park
- > protected_area=national_monument
- > protected_area=habitat
- > protected_area=habitat_locally_protected
- > protected_area=landscape
- > protected_area=sustainable
- > protected_area=continental_agreement
- > protected_area=species
- > protected_area=resource
- > protected_area=sociopolitical
- > protected_area=nature
public Transport
railway
- - implies landuse=transport, transport=railway
- > railway=abandoned
- > railway=construction
- > construction=*
- > railway=disused
- > railway=funicular
- > railway=light_rail
- > railway=miniature
- > railway=monorail
- > railway=narrow_guage
- > guage=*
- > railway=preserved
- > railway=rail
- > railway=subway
- > railway=tram
- > railway=halt
- > railway=platform
- > railway=station
- > railway=subway_entrance
- > railway=tram_stop
- > railway=buffer_stop
- > railway=derail
- > railway=crossing
- > railway=level_crossing
- > railway=switch
- > railway=diamond
- > railway=turntable
- > railway=roundhouse
- > railway=*
- + electrified=yes/no/contact_line/rail
- + frequency=*
- + service=siding/spur/yard
- + tracks=*
- + useage=*
- + voltage=*
- + bridge=* - see under highway + bridge
- + crossing=* - see under highway + crossing
- + tunnel=* - see under highway + tunnel
- + cutting=yes
- + embankment=yes
- + est_width=*
- + width=*
residential - where people stay long-term
route - Routes are nearly always relations of way objects
- > route=bicycle
- > There are a number of keys for features of bicycle routes.
- > route=bus
- > There are a number of keys for features of bus routes.
- > route=canoe
- > route=detour
- > route=ferry
- > route=hiking
- > There are a number of keys for features of hiking routes.
- > route=mtb - mountainbike routes
- > route=pipeline
- > route=piste
- > route=poser
- > route=railway
- > route=road
- > route=ski
- > route=train
- > route=tram
service - where services are sold to the public
- implies landuse=commercial, commercial=service
- > service=accountant
- > service=animal_boarding
- > service=architect
- > service=auctioneer
- > service=bank
- > service=beauty
- > service=beekeeper
- > service=bicycle_rental
- > service=brothel
- > service=car_repair
- > service=car_wash
- > service=carpet_layer
- > service=caterer
- > service=copyshop
- > service=dry_cleaning
- > service=electrician
- > service=employment_agency
- > service=funeral_directors
- > service=gardener
- > service=guide
- > service=hairdresser
- > service=insurance
- > service=it
- > service=key_cutter
- > service=laundry
- > service=lawyer
- > service=massage
- > service=newspaper_office
- > service=notary
- > service=painter
- > service=parquet_layer
- > service=photo_booth
- > service=photographic_laboratory
- > service=post_office
- > service=public_opinion
- > service=real_estate
- > service=register
- > service=rigger
- > service=roofer
- > service=scaffolder
- > service=scribe
- > service=stand_builder
- > service=storage - hired, privately lockable spaces for general storage
- > service=sweep
- > service=tiler
- > service=travel_agency
- the following, currently listed under shop=*, I would propose are services, not places where goods are sold. Therefore they should be under service=*.
- > shop=copyshop
- > shop=dry_cleaning
- > shop=funeral_directors
- > shop=laundry
- > shop=money_lender
- > shop=pawnbroker
- > shop=storage_rental
shop
- - where goods are sold
- - to be applied to objects with building=retail
- - food, beverges
- > shop=alcohol
- > shop=bakery
- > shop=beverages
- > shop=butcher
- > shop=cheese
- > shop=chocolate
- > shop=coffee
- > shop=confectionery
- > shop=convenience
- > shop=deli
- > shop=dairy
- > shop=farm
- > shop=greengrocer
- > shop=grocery
- > shop=organic
- > shop=pasta
- > shop=seafood
- > shop=tea
- > shop=wine
- - general store, department store, mall
- > shop=department_store
- > shop=general
- > shop=mall
- > shop=supermarket
- - clothing, shoes, accessories
- > shop=baby_goods
- > shop=bag
- > shop=boutique
- > shop=clothes
- > shop=fabric
- > shop=fashion
- > shop=jewelry
- > shop=leather
- > shop=shoes
- - discount store, charity
- > shop=charity
- > shop=second_hand
- > shop=variety_store
- - health and beauty
- > shop=beauty - primarily beauty products, not beauty services
- > shop=chemist
- > shop=cosmetics
- > shop=erotic
- > shop=hearing_aids
- > shop=herbalist
- > shop=medical_supply
- > shop=optician
- > shop=tattoo
- - do-it-yourself, household, building materials, gardening
- > shop=bathroom_furnishing
- > shop=doityourself
- > shop=energy
- > shop=florist
- > shop=furnace
- > shop=garden_centre
- > shop=gas
- > shop=glaziery
- > shop=hardware
- > shop=houseware
- > shop=hvac - heating, ventilation, air-conditioning
- > shop=locksmith
- > shop=paint
- > shop=trade
- - furniture and interior
- > shop=antiques
- > shop=bed
- > shop=candles
- > shop=carpet
- > shop=curtain
- > shop=furniture
- > shop=interior_decoration
- > shop=kitchen
- > shop=window_blind
- - electronics
- > shop=computer
- > shop=electronics
- > shop=hifi
- > shop=mobile_phone
- > shop=radiotechnics
- > shop=vacuum_cleaner
- - outdoors and sport, vehicles
- > shop=bicycle
- > shop=car
- > shop=car_parts
- > shop=farm_supplies
- > shop=fishing
- > shop=free_flying
- > shop=hunting
- > shop=motorcycle
- > shop=outdoor
- > shop=scuba-diving
- > shop=sports
- > shop=tyres
- > shop=water_sports
- - art, music, hobbies
- > shop=art
- > shop=craft - sells craft materials etc., do not confuse with craft=*
- > shop=frame
- > shop=fuel
- > shop=music
- > shop=musical_instrument
- > shop=video
- > shop=video_games
- - stationery, gifts, books, newspapers
- > shop=anime
- > shop=books
- > shop=gift
- > shop=newsagent
- > shop=stationery
- > shop=ticket
- - others
- > shop=pet
- > shop=pharmacy - the current standard deprecates this in favour of amenity=pharmacy
- > shop=pyrotechnics
- > shop=religion - sells religious items
- > shop=tobacco
- > shop=e-cigarette
- > shop=toys
- > shop=weapons
- > shop=*
- + second_hand=yes/only
social_facility
- implies landuse=service
- > social_facility=group_home
- > social_facility=assisted_living
- > social_facility=shelter
- > social_facility=ambulatory_care
- > social_facility=outreach
- > social_facility=workshop
- > social_facility=food_bank
- > social_facility=soup_kitchen
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
- + social_facility=:for
toilets
tourism
- implies landuse=tourism
- > tourism=alpine_hut
- > tourism=attraction
- > tourism=artwork
- > tourism=botanical_gardens
- > tourism=camp_site
- > tourism=caravan_site
- > tourism=gallery
- > tourism=information
- > information=*
- > tourism=museum
- > tourism=theme_park
- > tourism=wilderness_hut
- > tourism=zoo
- These are usually point objects, not areas.
waterway
- - implies landuse=waterway
- > waterway=river
- > waterway=riverbank
- > waterway=stream
- > waterway=wadi
- > waterway=canal
- > waterway=drain
- > waterway=ditch
- > waterway=dock
- > waterway=boatyard
- > waterway=dam - the dam wall, not the water held behind it in the reservoir
- > waterway=wier
- > waterway=lock-gate
- > waterway=turning_point
- > waterway=water_point
- > waterway=*
- + intermittent=yes
- + lock=yes
- + mooring=yes/no/private
- + service=transportation/water_power/irrigation
- + bridge=* - see under highway + bridge
- + crossing=* - see under highway + crossing
- + tunnel=* - see under highway + tunnel
- + tunnel=culvert
- + cutting=yes
- + embankment=yes
- + est_width=*
- + width=*
- + narrow=*
Object Attributes
General Attribute Tags
These can apply to objects of almost any type.
- + covered=yes
- + description=*
- + ele=*
- + email=*
- + end_date=*
- + fax=*
- + internet_access=yes/no/wired/wlan/terminal
- + image=*
- + is_in=*
- + name=*
- + alt_name=*
- + int_name=*
- + oc_name=*
- + nat_name=*
- + official_name=*
- + old_name=*
- + vreg_name=*
- + short_name=*
- + vsorting_name=*
- + opening_hours=*
- + operator=*
- + phone=*
- + start_date=*
- + website=*
- + wheelchair=yes/no/limited
- + wikipedia=*
Attribution
- + attribution=*
- + comment=*
- + fixme=*
- + note=*
- + source=*
- + todo=*
- + url=*
- + iata=*
- + icao=*
- + int_ref=* - international reference
- + nat_ref=* - national reference
- + reg_ref=* - regional reference
- + loc_ref=* - local reference
- + ncn_ref=* - national cycle network
- + rcn_ref=* - regional cycle network
- + lcn_ref=* - local cycle network
- + old_ref=*
Type-specific Attribute Tags
These
entertainment
- - where an audience is entertained by performers
- - to be applied to objects with leisure=entertainment
- - currently these are tagged with amenity=* with the same values
- + entertainment=arts_centre
- + entertainment=cinema
- + entertainment=music_club
- + entertainment=stripclub
- + entertainment=theatre
food
- - where food and/or drink is sold and is about to be consumed, either on the premises or taken away
- - to be applied to objects with building=retail and amenity=food
- + food=bar
- + food=biergarten
- + food=cafe
- + food=fast_food
- + food=food_court
- + food=ice_cream
- + food=pub
- + food=restaurant
- + cuisine=* - the nationality or style of food
- + drive_though=*
- + take_away=*
religion
- - wherever a religious affiliation needs to be ascribed
- + religion=* - to specify the religion
- + denomination=* - to specify a sub-group of the religion
sport - to be applied to objects with any of club=sport, leisure=pitch/stadium/track/sports_centre/golf_course/water_park/swimming_pool, and some other objects (eg:amenity=pub) where a sport may be played
- + sport=9pin
- + sport=10pin
- + sport=american_football
- + sport=aikido
- + sport=archery
- + sport=athletics
- + sport=australian_football
- + sport=badminton
- + sport=base
- + sport=baseball
- + sport=basketball
- + sport=beachvolleyball
- + sport=bmx
- + sport=boules
- + sport=bowls
- + sport=boxing
- + sport=canadian_football
- + sport=canoe
- + sport=chess
- + sport=cliff_diving
- + sport=climbing
- + sport=cricket
- + sport=curling
- + curling=*
- + sport=cycling
- + sport=dog_racing
- + sport=fencing
- + sport=equestrian
- + sport=free_flying
- + sport=gaelic_games
- + sport=golf
- + sport=gymnastics
- + sport=handball
- + sport=hockey
- + sport=horseshoes
- + sport=horse_racing
- + sport=ice_stock
- + sport=judo
- + sport=karting
- + sport=kitesurfing
- + sport=korfball
- + sport=motor
- + sport=multi
- + sport=obstacle_course
- + sport=orienteering
- + sport=paddle_tennis
- + sport=paragliding
- + sport=pelota
- + sport=racquet
- + sport=rowing
- + sport=rugby_league
- + sport=rugby_union
- + sport=running
- + sport=sailing
- + sport=scuba-diving
- + sport=shooting
- + sport=skating
- + sport=skateboard
- + sport=skiing
- + sport=soccer
- + sport=squash
- + sport=surfing
- + sport=swimming
- + sport=table_tennis
- + sport=taekwondo
- + sport=tennis
- + sport=toboggan
- + sport=volleyball
- + sport=water_ski
- + sport=weightlifting
- + sport=wrestling
emergency_service
- - not a key currently in much use
- - the whole use of emergency=* is subject to a cleanup project, but nothing seems to have been resolved
- - implies landuse=service, service=emergency_service
- + emergency_service=ambulance_station
- + emergency_service=fire_station
- + emergency_service=police_station
- + emergency_service=ses_station
- + emergency_service=*
Still to Do
[Below here are keys that have not yet been placed into the object type tree above.]
Gas Supply
Public Transport
Sewerage
Water Supply
[amenity values that need re-locating to different tags]