User:Innesw/TagTree

From OpenStreetMap Wiki
Jump to: navigation, search
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 as an attempt to map the highways and byways of the world. It was not intended (I think) 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. 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 should adequately do the task.

This document is my attempt to understand the structure of the existing tag scheme - or possibly to impose some structure of my own, in order to assist my understanding, and ease the process of tagging map objects.

General

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 the 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.

When deciding how to tag a map object, I find it useful to classify tags into two categories:

  • tags that define the 'type' of a map object
  • tags that define additional 'attributes' to a map object

Please note that the 'type' category (in the sense I'm using it here) is not reflected in the documentation on the OSM Wiki, and I would not want to impose it there. On the other hand the 'attribute' category is reflected in attribute tags: tags that have a key of two parts, the first being the 'type' and the second the 'attribute' (eg: arialway:capacity=*). These are quite common. However, not all tags I would consider 'attributes' have this structure. Be aware that tag keys with this structure (with one or more internal ':') also have other meanings within OSM.

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:

object_type=building

In practice the '_type' suffix (or its variation ':type') is in use, but not extensively . Further, the theory that the key for a 'child' tag is the value of its 'parent' is also not adhered to, so we have:

object_type=building

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. (In fact object_type=* is 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 is also 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.

amenity=*

The amenity tag is ambiguous as to whether a given value is a 'type' or not. 'Amenity' simply indicates 'there is something useful here'. 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 the above ways 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 can 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 with 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 launduse=* value. The landcover values are mostly varieties of natural cover (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 (unclosed-way) features.


Landcover

> landcover=* - what actually covers the land
> landcover=water
> landcover=wetland
> landcover=bryophytes
> landcover=grassland
> landcover=shrubland
> landcover=woodland - covered with trees
> landcover=planted
> landcover=bareland
> landcover=artificial
> landcover=ocean
> landcover=bay
> landcover=lake
> landcover=river
> landcover=reservoir - this simply implies an artificial lake behind a dam wall. It does not imply any particular use for the water.
> landcover=canal
> landcover=ice

> landcover=tidalflat
> landcover=sandy_beach
> landcover=gravel_beach
> landcover=swamp
> landcover=marsh
> landcover=mangrove
> landcover=saltmarsh
> landcover=water_weed
> landcover=mire
> landcover=bog
> landcover=fen
> landcover=reedbed
> landcover=grass
> landcover=meadow
> landcover=tundra
> landcover=savanna
> landcover=heath
> landcover=trees
> landcover=scrub
> landcover=thicket
> landcover=cropland
> landcover=plantation
> landcover=orchard
> landcover=vineyard
> landcover=aquatic
> landcover=urban_grass
> landcover=lawn
> landcover=turf
> landcover=sand
> landcover=bare_soil
> landcover=hardpan
+ chemical=*
> landcover=dry_lake
> landcover=salt
> landcover=mud
> landcover=gravel
> landcover=stones
> landcover=bare_rock
> landcover=sub_surface
> landcover=built_up - for all urban areas, but in practice rarely used
> landcover=building - rarely used, as any building=* implies this
> landcover=waste
> landcover=mine_spoil
> landcover=artificial
> landcover=roadway
> landcover=railway
> landcover=surface
> landcover=*
+ leaf_type=*
+ leaf_cycle=*
+ cover=*

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
> 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
> 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
> landuse=timber_production - where the primary management is for timber
> landuse=tourism
> tourism=* - see tourism below
> landuse=transport
> transport=aerialway
> arialway=* - see arialway below
> transport=aeroway
> aeroway=* - see aeroway below
> transport=highway
> highway=* - see highway below
> transport=railway
> railway=* - see railway below
> 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

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 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.

Index - Basic Types and Attributes

Object Types

Each of these types has further details in the complete tree below. It is intended as an 'index' to the complete tree.

- point objects

> amenity (some values only)
> historic (some values only)
> man_made (some values only)
> natural (some values only)

- linear objects

> aerialway
> barrier
> highway
> man_made (some values only)
> natural (some values only)
> waterway

- area objects

> aeroway
> agriculture
> boundary
> building
> cemetery
> craft
> leisure
> historic
> industry
> military
> mining
> place
> power
> protected area
> public_transport
> railway

- relation objects

> route - Routes are nearly always relations of way objects

Object Attributes - to be used only when an object's type has been specified

+ amenity
+ entertainment
+ food
+ public_transport=stop_position
+ shop
+ sport

Object Types Tree

Point Objects

Linear Objects

> 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=*
> 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

Area Objects

> aeroway
- infrastructure used to support aircraft and air travel
- implies landuse=transport and transport=aeroway
> aeroway=aerodrome
> aeroway=apron
> aeroway=gate
> aeroway=helipad
> aeroway=hangar
> aeroway=runway
> aeroway=taxiway
> aeroway=terminal
> aeroway=windsock
> 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
> intensive=hydroponic - plants are grown in a non-soil medium and all nutrients are supplied in liquids
> intensive=cattle - also known as a feedlot
> intensive=fish
> intensive=pigs
> intensive=poultry
> 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

building

- used to describe the physical nature of a building
- 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.

- accommodation

> building=apartments
> building=farm
> building=hotel
> building=house
> building=detached
> building=residential
> building=dormitory
> building=terrace
> building=houseboat
> building=statis_caravan

- commercial

> building=commercial
> building=industrial
> building=retail
> building=warehouse

- civic/amenity

> building=civic
> building=hospital
> building=school
> building=stadium
> building=train_station
> building=transortation
> building=university
> building=public

- 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
> building=*
> building=*

- other

> building=bridge
> building=bunker
> building=cabin
> building=garage
> building=garages
> building=hangar - but see aeroway=hangar
> building=hut
> building=roof
> building=shed
> building=transformer_tower
> building=service
> building=kiosk
> 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=*
> 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
+ 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

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=*
+ emergency=yes - when actual

government

- implies landuse=service, service=government
> government=administration
> government=consulate
> government=courthouse
> government=embassy
> government=electorate_office
> government=parliament
> government=prison
> government=registry
> government=research
> government=tax
> government=*
+ government_level=*

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
- In theory I would prefer use of the ruins:historic=* life-cycle key. However given that ruins are often of historic interest in themselves, and that objects tagged ruins:historic=* may be excluded from searches for historic=*, it is better to use {{tag|historic|ruins} and ruins=*.
> ruins=* - same values as historic=*
> 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 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
> 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
> military
> - any area used for military purposes
> - implies landuse=military
> military=airfield
> military=bunker
> military=barracks
> military=checkpoint
> military=danger_area
> military=naval_base
> military=obstacle_course
> military=range
> military=training_area

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

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
+ cables=*
+ circuits=*
+ location=*
+ tunnel=yes
> power=cable_distribution_cabinet
> power=converter
> power=generator
+ generator:source=*
+ generator=:source
+ generator=:output
> power=heliostat
> power=line
+ cables=*
+ circuits=*
+ wires=*
+ tunnel=yes
> 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_species=*
> protected_area=resource
> protected_area=soil
> protected_area=water
> protected_area=climate_and_air
> protected_area=location_condition
> protected_area=longtime_hazard
> protected_area=sociopolitical
> protected_area=community_life
> protected_area=cultural_assets
> protected_area=economic
> protected_area=political
> protected_area=military
> protected_area=historic

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=*
> useage=main
> useage=branch
> useage=freight
> useage=industrial
> useage=military
> useage=tourism
+ voltage=*
+ bridge=* - see under highway + bridge
+ crossing=* - see under highway + crossing
+ tunnel=* - see under highway + tunnel
+ cutting=yes
+ embankment=yes
+ est_width=*
+ width=*
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

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
> food=*
+ cuisine=*
+ drive_though=*
+ take_away=*

religion

- wherever a religious affiliation needs to be ascribed
> religion=* - to specify the religion
> denomination=* - to specify the sub-species of the religion

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=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=hvac - heating, ventilation, air-conditioning
> 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
+ dispensing=yes
> shop=pyrotechnics
> shop=religion - sells religious items
> shop=tobacco
> shop=e-cigarette
> shop=toys
> shop=weapons
> shop=*
+ second_hand=yes/only

- the following, currently listed under shop=*, I would propose are services, not goods that are sold

> shop=copyshop
> shop=dry_cleaning
> shop=funeral_directors
> shop=laundry
> {{tag|shop|money_lender
> shop=pawnbroker
> shop=storage_rental

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
> archery=3d
> archery=field
> archery=fita
> sport=athletics
> sport=australian_football
> sport=badminton
> sport=base
> sport=baseball
> sport=basketball
> sport=beachvolleyball
> sport=bmx
> sport=boules
> boules=bocce
> boules=boule_de_fort
> boules=extreme
> boules=lyonaise
> boules=petanque
> 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
> horse_racing=flat
> horse_racing=jumps
> horse_racing=trotting
> 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
> shooting=clay-pigeon
> shooting=pistol
> shooting=rifle
> 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




> Accommodation
- where people pay to stay short-term
implies building=commercial and commercial=accommodation, or landuse=accommodation
- current practice is to use tourism=* for these
> accommodation=apartment
> accommodation=caravan_park
> accommodation=cabin
> accommodation=chalet
> accommodation=guest_house
> accommodation=hostel
> accommodation=hotel
> accommodation=house_boat
> accommodation=motel
> accommodation=static_caravan

Education

implies landuse=education
> education=college
> education=kindergarten
> education=library
> education=school
> education=university

Gas Supply

> gas_supply=gasometer

Healthcare

implies landuse=healthcare
> healthcare=clinic
> healthcare=dentist
> healthcare=doctors
> healthcare=hospital
+ emergency=yes
> healthcare=veterinary


Residential - where people live long-term

implies landuse=residential
> residential=apartments
> residential=dormitory
> residential=detached
> residential=house
> residential=house_boat
> residential=terrace
> residential=static_caravan

Service - where services are sold to the public

implies landuse=commercial, commercial=service
> service=accountant
> service=animal_boarding
> service=architect
> service=auctioneer
> service=bank
+ drive_through=yes
> 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

Sewerage

Social_facility

implies landuse=service, service=social_facility
> 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

implies landuse=service, service=toilets
> toilets=*
+ toilets=:disposal
+ toilets=:disposal
+ toilets=:disposal
+ toilets=:disposal
+ toilets=:position
+ male=yes
+ female=yes
+ unisex=yes
+ fee=yes/no
+ indoor=yes
+ supervised=yes/no/interval
+ opening_hours=*
+ wheelchair=yes/no/limited

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 may usually be point objects, not areas.]

> tourism=information_point
> information=*
> tourism=picnic_site
> tourism=viewpoint

Water Supply


[amenity values that may need re-locating]

> amenity=taxi
> amenity=nursing_home
> amenity=animal_shelter
> amenity=dojo
> amenity=marketplace
> amenity=parking
> amenity=parking_space
> amenity=photo_booth
> amenity=ranger_station
> amenity=recycling
> amenity=vending_machine
> vending=*

Point and Line Objects

Amenity

> amenity=bbq
> amenity=drinking_water
> amenity=bicycle_parking
> amenity=car_sharing
> amenity=charging_station
> amenity=compressed_air
> amenity=ferry_terminal
> amenity=grit_bin
> amenity=parking_entrance
> amenity=atm
> amenity=baby_hatch
> amenity=bench
> amenity=clock
> amenity=fountain
> amenity=post_box
> amenity=shelter
> amenity=shower
> amenity=telephone
> amenity=waste_basket
> amenity=waste_disposal
> amenity=watering_place
> amenity=water_point
> amenity=boat_sharing

Boundary

> boundary=administrative
> admin_level=*
> boundary=maritime
> boundary=national_park
> boundary=political
> boundary=postal_code
> boundary=protected_area
> boundary=fire_boundary

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=*
> bridge=yes
> bridge=aqueduct
> bridge=boardwalk
> bridge=cantilever
> bridge=covered
> bridge=low_water_crossing
> bridge=trestle
> bridge=viaduct
> bridge=movable
+ bridge=:movable
+ bridge=:structure
+ bridge=:support
+ bridge=:ref
+ layer=*
+ tunnel=*
> tunnel=yes
> tunnel=culvert
> tunnel=building_passage
> tunnel=avalanche_protector
+ layer=*
+ cutting=yes
+ embankment=yes
+ est_width=*
+ width=*
+ narrow=*

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
> pipeline=*
> pipeline=drain
> pipeline=gas
> pipeline=oil
> pipeline=sewer
> pipeline=water
> pipeline=valve
> pipeline=marker
+ pipeline=:notice
+ location=overground/underground/underwater
+ est_width=*
+ width=*
> 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

Natural Natural features (ie: not landcovers). These are very 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
> volcano=stratovolcano/shield/scoria
+ status=active/dormant/extinct

Public Transport

> public_transport=stop_position
> public_transport=platform
> public_transport=station
> public_transport=stop_area

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

Common Keys

+ covered=yes
+ description=*
+ ele=*
+ email=*
+ end_date=*
+ fax=*
+ internet_access=yes/no/wired/wlan/terminal
+ historic=yes
+ image=*
+ is_in=*
+ name=*
+ alt_name=*
+ int_name=*
+ loc_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=*
+ area=yes/no

Attribution

+ attribution=*
+ comment=*
+ fixme=*
+ note=*
+ source=*
+ source=extrapolation
+ source=historical
+ source=image
+ vsource=knowledge
+ source=survey
+ survey=:date
+ source=voice
+ source=:name
+ source=:ref
source_ref=*
+ 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=*

Object Lifecycle

In all cases the stage in an objects life cycle should be indicated with the appropriate namespace, not with object_type=proposed. ie: use proposed:highway=motorway not highway=proposed plus proposed=motorway

All these namespaces prevent normal searches finding other than active (currently used) objects.

The life-cycle namespaces are:

proposed: - there is a proposal to build the structure, but no actual construction work has commenced

planned: - a proposal has reached a detailed-planning stage, but there is still not actual construction

construction: - actually under construction

(active: - this namespace is never actually used, it is the default for all objects)

mothballed: - not in active use, but in working order and maintained to prevent deterioration

disused: - not in current use, but could be at fairly short notice

vacant: - same as disused, but for buildings that have sound structure and working fittings, but no contents. This namespace may be deprecated in favour of eg: shop=vacant, which implies that the current specific use is unknown because the space is unoccupied.

damaged: - not in use due to damage by fire, earthquake, explosion or similar event. The building is probably awaiting a decision as to whether it is to be demolished or repaired.

abandoned: - fallen into disrepair, and would take considerable work or funds to bring to operational status

ruined: - a large part of the structure has collapsed or been removed, and it would need to be re-built to restore its original use. Buildings have lost their roofs, bridges most of their spans. This namespace does not imply any historical value, just the physical state of the structure.

demolished: - the total structure has been removed, but the location has not been over-built. Physical signs (eg: foundations, earthworks) may remain obvious in the landscape.

historic_location: - most physical signs have disappeared, and any that remain are little more than archaeological. This namespace does not imply any particular historical value, it just enables mapping of now non-existent structures.