@openstreetmap/id-tagging-schema

iD Tagging Schema

This is the directory of OpenStreetMap tagging data used by the iD editor. It includes presets, fields, deprecations, and more.

Participate!

• Read up about how you can contribute to the iD Tagging Schema on the contributing page.
• Translate!
• See the open issues in the issue tracker if you're looking for something to do.
• Need more help? Ping user tyr_asd (Martin Raifer) on OpenStreetMap Discord (#id channel) or OpenStreetMap US Slack (#id channel).

Background

OpenStreetMap itself does not have a formal rigid database schema, but relies on a tagging folksonomy instead.

Editing tools need to know how tags are used in order to facilitate mapping. This Tagging Schema fills that need, but with a number of caveats:

• This isn't authoritative or definitive
• Tagging interpretations may vary from mapper to mapper, place to place, and over time
• Our primary aim is to serve the needs of iD mappers (but other tools are welcome to use this too)
• We support tags based on practicality, usage, and community approval
• Sometimes there are reasons we can't support a tag even if it's used or approved

Usage

Java/Android

The westnordost/osmfeatures project, a component of StreetComplete, makes it easier to use this data with Android or other Java platforms.

Use by Other Editors

iD tagging schema is used not only by iD. Here's a list of projects which use the data from the id-tagging-schema.

Related Projects

• The OpenStreetMap wiki documents the current usage of tags, and hosts discussions about proposed new tags.
• The ideditor/schema-builder project holds the documentation for the data format used in this repository
• iD also incorporates preset data from the name-suggestion-index.
• Other editors also include their own models of interpretations of OSM tags. See for example Vespucci's or JOSM's tagging presets.

Contributing

See the dedicated CONTRIBUTING page for information about this.

Changelog

6.7.0

2024-Mar-14

New Presets

• Add preset for man_made=clarifier ([#1091], thanks [@arch0345])
• Add preset amenity=dog_toilet ([#1095], thanks [@cnotin])
• Add preset for Book Return Drop Boxes (amenity=library_dropoff) ([#1037], thanks [@arch0345])
• Add preset for Hot Tub (leisure=hot_tub) ([#1008], thanks [@arch0345])
• Add preset for emergency=disaster_response ([#1108], thanks [@andrewharvey])
• Add preset for amenity=luggage_locker ([#1121], thanks [@kjonosm])
• Add preset for Kitchen Garden (leisure=garden + garden:type=kitchen) ([#1135], thanks [@imagoiq])
• Add preset for historic=cannon ([#1134], thanks [@qugebert])
• Add preset for amenity=bicycle_wash ([#1032], thanks [@mcliquid])

Changed Presets

• Add ref field to railway=switch preset ([#1083], thanks [@gy-mate])
• Improve icon for Thai Restaurant preset ([#1090], thanks [@louwers])
• Move bottle field to optional fields in the Drinking Water preset ([#1101])
• Add access field to Parking Space preset ([#1123], thanks [@watmildon])
• Include Informal Path preset in Paths category ([#1131], thanks [@k-yle])
• Add Structure field to Steps preset to mark them as a bridge for example ([#1128], thanks [@k-yle])
• Add road-related fields to Busway preset ([#1127], thanks [@k-yle])
• Add via field to Ferry Route preset ([#1127], thanks [@k-yle])
• Add changing_table as optional field to several POI presets ([#1139], thanks [@mangerlahn])
• Add more search terms to Transit Ticket Vending Machine preset ([#1142], thanks [@matkoniecz])
• Add more search terms to Public Bookcase preset ([#1150], thanks [@matkoniecz])
• Add oneway as optional field to Crossing ways, Footways, Paths, Steps and Track Roads ([#1143], thanks [@tordans])
• Make all Tree-type presets searchable ([#1156])

New and Changed Fields

• Add new ref (Line Number) and railway:track_ref (Track Number) fields to the railway=rail preset ([#1083], thanks [@gy-mate])
• Add new railway:switch (Switch Type) field to railway=switch preset ([#1084], thanks [@gy-mate])
• Add field for summit:cross tag on natural=peak objects ([#1088], thanks [@qugebert])
• Add unleashed as an option for the dog field
• Add translatable options for swimming pool Type field ([#1008], thanks [@arch0345])
• Add option millstone to the field for the historic tag ([#1067])
• Add field for menstrual products (toilets:menstrual_products) on Toilets and POIs with the toilet field ([#1116], thanks [@moan0s])
• Add field to specify the Type of Lifeguard locations
• Show translated options in sport_pub field and add value for sport=darts to it as well as the generic sport field
• Add translatable options and descriptions to kerb field ([#1029], thanks [@kjonosm])
• Include icons with the options of the kerb field
• Don't repeat kerb Type field in the type-specific Kerb presets
• Add field for fortification_type tag for features mapped as archaeological_site=fortification ([#1129], thanks [@k-yle])
• Add translatable options to bridge field for man_made=bridge features ([#1002], thanks [@kjonosm])
• Clarify that left/right are meant to be mapped relative to the driving direction for highway=cyclist_waiting_aid features ([iD#10128])

Regional Presets and Fields

Deprecated Tags

• Mark emergency=lifeguard_tower/lifeguard_base/lifeguard_platform and emergency=water_rescue_station as deprecated in favor of emergency=lifeguard + lifeguard=*/emergency=water_rescue ([#1098], thanks [@westnordost])
• Mark tourism=resort as deprecated in favor of leisure=resort ([#1103], thanks [@westnordost])
• Mark tourism=picnic_table as deprecated in favor of leisure=picnic_table ([#1104], thanks [@westnordost])
• Mark industrial=brickworks as deprecated in favor of industrial=brickyard ([#1105], thanks [@qugebert])
• Mark amenity=ses_station as deprecated in favor of emergency=disaster_response ([#1109], thanks [@qugebert])
• Mark leisure=maze as deprecated in favor of attraction=maze ([#1102], thanks [@westnordost])
• Mark amenity=lockers as deprecated in favor of amenity=locker ([#1124], thanks [@kjonosm])

Bugfixes

• Allow Bike Parking features to be mapped as a line ([#1114])
• Fix wrong description and add missing value for lpg/lng values of the Fuel field ([#1130], thanks [@k-yle])
• Don't automatically add building=yes on man_made=works objects ([#1132])
• Disallow area geometry type on traffic_calming=island preset ([#1076])
• Allow historic=ruins to be mapped as lines ([#1149])