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

Background

OpenStreetMap itself does not have a formal tagging schema, but 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

Translations

• English translations for the terms-key should be added to the JSON data (Example).

• Apart from that, translations are managed in the Transifex Project of the iD Editor inside the translation resource 'preset'.

  To translate, you can open the translation page, select a language, select 'preset' and search for key:living_street or translation_text:'Living Street' to find and change translations.

  To contribute to a language: Select a language and use 'Join team' to request access. The administrators will approve requests routinely, only rejecting requests for overly specific locales.

• All translation changes will be released whenever a new id-tagging-schema release is created. They will be visible inside iD and other editors once those editors update their dependencies and release a new version as well.

Usage

Java/Android

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

Related Projects

iD also incorporates preset data from the name-suggestion-index.

Contributing

iD's code of conduct and privacy policy also apply to this project.

Making Changes

Documentation for the data formats is located with the schema-builder package, which is the technical basis of this project. To make a change, update a file within the data folder and rebuild by running npm run build in your terminal.

Changelog

3.3.0

:mega: Release Highlights

• Phase out opening_hours:covid19 field by only making it an optional field ([#401])
• Fix handling of highway=construction objects ([#443], [#416])
• Add access=customers value to access field ([#326])
• Add a (hidden) preset for crossing=uncontrolled ([#390])

Thanks to all contributors: [@matkoniecz], [@Binnette], [@danieldegroot2], [@arch0345], [@k-yle], [@Zverik], [@zymurgic], [@1ec5], [@tordans], [@westnordost], [@rkost], [@Aniket], all translators and everyone else who suggested improvements!

New Presets

• Add Futsal Court preset ([#367])
• Add Archery Range preset ([#369])
• Add more Disc Golf features ([#372])
• Add Four Square Court preset ([#385])
• Add presets for unspecified Shops and Offices ([#399])
• Add Lighting Mast preset ([#407])
• Add Cart Corral preset ([#414])
• Add Tetherball Court preset ([#441])
• Add Padel Court preset ([#445])
• Add Hopscotch preset ([#451])
• Add preset for Carpet Hangers ([#452])

Changed Presets

• Add presets for pedestrian crossings with traffic signals for lines ([#368], thanks [@Dimitar5555])
• Consolidate raised crossing presets into a field
• Update icon for Swamp preset ([#371])
• Add 'pet' as search term for Excrement Bag Dispenser preset ([#370])
• Add address & operator fields to industrial presets ([#383])
• Add ref & website fields to monitoring station ([#380])
• Add rail as a term for Train Track ([#381])
• Use water=reservoir instead of landuse tag for emergency water reservoirs
• Add search terms to Recycling preset ([#400])
• Add name field to Beach preset ([#417])
• Add position field to Fire Hydrant preset ([#418])
• Garage(s): Only keep capacity as field ([#423])
• Add ref field to Wastewater Treatment Plant preset ([#425])
• Add ref field to Atm, Payment Terminal, and Vending Machine presets ([#428])
• Update icon of Lighting Mast preset ([#439])
• Add search terms for Spring Rocker preset ([#446])
• Add support field to Street Lamp preset ([#448])
• Update icon of Bicycle Parking preset
• Improve naming of horse facilities ([#413])
• Add bike services field to Sports and Outdoor Shops presets as an optional field ([#464])
• Add ref field to Subway Entrance preset ([#465])
• Update allowed geometry types of some playground equipment presets ([#466])

New and Changed Fields

• Add field for seamark:rescue_station:category tag to Lifeboat Station preset ([#382])
• Add trolley:deposit field ([#414])
• Add (new) lifeguard and supervised fields to Beach preset
• Add fields for crossing=traffic_signals presets ([#453], [#456])
• Add more fields to Tree preset ([#455])
• Add flashing_lights field to pedestrian crossing presets ([#449])
• Add values to beauty field ([#427])
• Use emoji and unicode symbols for mtb:scale:imba values ([#462])

Bugfixes

• Don't snake-casing values of the network field ([#375])
• allow maxspeed:advisory field everywhere ([#389]
• Fix code of Ticket Validator preset ([#391])
• Fix tag for birthing centers ([#398])
• Fix name and tags of highway=construction preset ([#443], [#416])
• Avoid snake_case on not:name ([#424])
• Disallow Runway preset on areas
• Allow Hot Springs to be mapped as areas ([#436])
• Allow Parcel Lockers to be mapped as areas ([#458])
• Change Golf Cartpath preset to use highway=path by default ([#327])

Deprecated Tags

• ~~building:roof:shape~~ :arrow_right: roof:shape ([#337])
• ~~healthcare=birthing_center~~ :arrow_right: healthcare=birthing_centre ([#398])

Documentation and Other Changes

• Add code formatting check and workflow
• Update and use some new temaki icons
• Fix documentation link for office=coworking preset ([#403])
• Add json schema configuration ([#432])