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