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

:mega: Release Highlights

• Rename highway=track preset to "Track / Land-Access Road" ([#288])
• Allow the website tag to be used on any feature ([#503])

Thanks to all contributors: [@westnordost], [@arch0345], [@matkoniecz], [@flacombe], [@Kazing], [@kjonosm], [@k-yle], [@Binnette], all translators and everyone else who suggested improvements!

New Presets

• Add presets for Workwear Store and Suits Store ([#478])
• Add Yurt preset ([#489])
• Add Informal Foot Path preset ([#493])
• Create preset for route=railway ([#483])
• Add preset for sport=table_football ([#485])
• Add Radar Speed Sign preset ([#442])
• Add preset for highway=emergency_access_point ([#504])
• Add more barrier presets ([#506])
• Add presets for bike tube and pizza vending machines ([#516])
• Add preset for cemetery=sector ([#517])
• Add Grave preset ([#522])
• Add hidden preset for building=manufacture ([#524])

Regional Presets

• add support for moped links in the NL ([#484])

Changed Presets

• Make all entrance fields available in the Main Entrance preset ([#491])
• Add oneway field to Tram Track preset
• Add additional terms to Service Area preset ([#495])
• Make the multipolygon relation type searchable ([#481])
• Add Wheelchair field to Emergency Exits
• Add lane_markings field to some road presets ([#479])
• Drop description field from Valley and Cape presets
• Add ref field to Milestone preset ([#474])
• Rename tourism=alpine_hut preset to "Mountain Lodge" ([#480])
• Improve terms of crossing and traffic calming presets/fields ([#508])
• Remove Crop field from Farmyard preset and add terms ([#513])
• Update power presets following transformer tagging extension ([#447])

New and Changed Fields

• Increment camera:direction by 5 degrees at a time ([#482])
• Made target and country fields case sensitive ([#490])
• Add a field for sport=table_football to the Pub, Bar and Restaurant presets ([#485])
• Add maxwidth as optional field to some road presets and the Ferry Route preset ([#518])

Bugfixes

• Fix broken Carpet Hanger preset ([#486])
• Fix spelling of not title cased aliases
• Avoid converting Destination field to snake case ([#515])
• Fix wrong tag used in Emergency Water Tank preset (replace wrong tag ~~landuse=reservoire~~ with man_made=storage_tank) ([#525])

Deprecated Tags

• Drop deprecation rule for fenced=yes tag ([#514])
• Add deprecation and new tag for (naval) military bases ([#510])
• Fix replacements of deprecated golf tags
• Replace ~~shop=general_store~~ with shop=general ([#476])
• Replace ~~shop=office_supplies~~ with shop=stationery ([#477])
• Drop preset for deprecated waterway=riverbank tag

Documentation and Other Changes

• Clean up unnecessary uses of the wikimedia_commons field (which is a universal field)
• Clean up unnecessary uses of the name field (which is a universal field)
• Clean up unnecessary uses of the start_date field (which is a universal field)
• Make roof:colour field to work with iD's color picker widget ([#500])