@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.
• 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.1.0

2023-Apr-03

:mega: Release Highlights

• On github, automated preview instances of iD will be deployed for tagging PRs

New Presets

• Add presets for Korean and Spanish Restaurants ([#815], thanks [@andrewharvey])
• Add preset for man_made=quay ([#810], thanks [@jdhoek])
• Add Track & Field presets ([#817], thanks [@arch0345])
• Add preset for natural=peninsula ([#798], [#844], thanks [@harahu])
• Add preset for emergency=fire_service_inlet ([#806], thanks [@tiptoptom])
• Add preset for Scout Group ([#836], thanks [@tiptoptom])

Changed Presets

• Add a field for the tag website:menu to amenties like Restaurants, Cafes, etc. ([#803], thanks [@tognee])
• Rename military=danger_area preset to "Danger Zone, Access Prohibited" ([#792], thanks [@emersonveenstra])
• Add terms "cat/dog grooming" to Pet Groomer preset ([#811], thanks [@matkoniecz])
• Use amenity=dancing_school tag for Dance Studio preset
• Add flashing_lights field to crossing=uncontrolled ([#827], thanks [@Dimitar5555])
• Make shop=vacant preset searchable ([#828], thanks [@Dimitar5555])
• Hide shop=hobby preset and add hobby as search term to related Shop presets ([#24], [#821], [#823], thanks [@matkoniecz])
• Make barrier=log preset searchable ([#615], [#822], thanks [@matkoniecz])
• More dedicated icon for Sign Maker, shop=frozen_food and Castle presets ([#839], [#840], [#849], thanks [@matkoniecz])
• Add additional search terms to Billboard preset ([#848], thanks [@matkoniecz])

New and Changed Fields

• Drop value community from postbox:type field ([#805], thanks [@kjonosm])
• Add translatable strings for fields: historic, diplomatic, consulate, dock, collector ([#813], [#841], [#843], [#852], [#853], thanks [@kjonosm])
• Add field for dance:teaching=yes/no tag
• Add more values of sport field ([#812], thanks [@kjonosm])
• Add fields for fire_mains and fire_sprinkler ([#806], thanks [@tiptoptom])
• Update tag of Orientation field for Street Side Parking preset from parking:orientation to orientation ([#673], thanks [@tordans])
• Specify cons for some shelter_type values ([#851])

Deprecated Tags

• Add recently deprecated tags ([#807], thanks [@kjonosm]):
  • ~~amenity=lifeboat-station~~ :arrow_right: emergency=water_rescue
  • ~~emergency=lifeboat_station~~ :arrow_right: emergency=water_rescue
  • ~~emergency=marine_rescue~~ :arrow_right: emergency=water_rescue
  • ~~emergency_service=air~~ :arrow_right: emergency=air_rescue_service
  • ~~emergency=dry_riser_inlet~~ :arrow_right: emergency=fire_service_inlet+ fire_mains=dry
  • ~~emergency=sprinkler_connection~~ :arrow_right: emergency=fire_service_inlet+ fire_sprinkler=yes
• Remove disputed deprecation of amenity=dancing_school ([#814], thanks [@matkoniecz])
• Update Utility Pole preset and add relevant deprecations ([#830], [#211], thanks [@Dimitar5555]):
  • ~communication=pole~ :arrow_right: man_made=utility_pole + utility=telecom
  • ~telephone=pole~ :arrow_right: man_made=utility_pole + utility=telecom
  • ~telecom=pole~ :arrow_right: man_made=utility_pole + utility=telecom
  • ~pstn=pole~ :arrow_right: man_made=utility_pole + utility=telecom
• ~parking:orientation=*~ :arrow_right: orientation=* ([#673], thanks [@tordans])

Bugfixes

• Fix tag of (hidden) generic Pipeline Feature preset
• Avoid lowercasing Destination field on one-ways ([#829], thanks [@1ec5])

Documentation and Other Changes

• Extend documentation section about translating ([#825], thanks [@tordans])
• Create CONTRIBUTING page
• Add a .nvmrc file
• Bump dependencies: prettier to v2.8.6, schema-builder to v6.2