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

2024-Mar-14

• Fix URLs to icons from the maki icon set in the taginfo-project output ([schema-builder#119])