User:Innesw/TagTree

From OpenStreetMap Wiki
Jump to navigation Jump to 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 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:

object_type=building

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:

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

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

- 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

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

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

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.
> ruins=* - same values as historic=*, to describe what sort of structure is now in ruins.
> 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
> pipeline=*
> pipeline=drain
> pipeline=gas
> pipeline=oil
> pipeline=sewer
> pipeline=water
> pipeline=valve
> pipeline=marker
+ pipeline=:notice
+ capacity=*
+ diameter=*
+ location=overground/underground/underwater
+ est_width=*
+ pressure=*
+ substance=*
+ useage=*
+ 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
> 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

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
> volcano=stratovolcano/shield/scoria
+ status=active/dormant/extinct

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

public Transport

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

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

residential - where people stay long-term

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

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

- 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
+ dispensing=yes
> 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

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 are usually point objects, not areas.

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

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.

+ area=yes/no
+ historic=yes
+ 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=*
+ 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=*

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

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 emergency services are available at the location

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]

> 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