From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg 3dmr
The ID of the 3D Model Repository's 3D representation of the feature. Edit or translate this description.
Group: Annotations
URL pattern$1
Used on these elements
may be used on nodesmay be used on waysmay be used on areasmay be used on relations
See also
Status: abandonedPage for proposal

The ID of a 3D model of the feature, hosted on the 3D Model Repository.

The 3D Model Repository is a free and open collection of 3D models, under licenses compatible with OSM data. These can be used by 3D renderers to go beyond what's possible with Simple 3D Buildings and similar tagging schemes, while still relying on OSM data for the rest of the scene.


Usage of the tag is 3dmr=<id>, where id is the ID of the model in the 3D Model Repository.

A 3D renderer supporting this tag may then ...

  • obtain the model from the 3D Model Repository and place it in that location, and
  • ignore the tagged OSM elements for 3D rendering, to avoid duplication.

Additional tags

At least the following existing keys are taken into account to scale and rotate a generic model:

Other tags and conventions (e.g. deriving a bollard's rotation from the way containing it, ...) should also be taken into account by data consumers supporting this tag.

Suitable features

The tag applies to all elementsnode nodes, way ways, area areas, and relation relations. When applied to a relation (e.g. a bridge relation or parking relation) or outline (e.g. a building=*) area), features that semantically belong to these "root" elements should also be replaced with the model.

Creating new elements for the sole purpose of linking a model from the 3D Model Repository should be avoided wherever possible. Usually, this is a sign that the linked model does not have the intended granularity: Instead of creating a single model containing both a castle and the decorative fountains in front of it, for example, the model should be subdivided into separate models for the building and fountains. These can then be easily linked to existing OSM elements.


Photo Tagging Interpretation
Coburg-Marktplatz-Brunnen-W.jpg node node or area area, tagged Link to an external model for an historic fountain. This id will only appear in the database once, as the fountain is unique.
Bench.jpg 4 node nodes, each tagged

The direction key defines the facing of the bench, as usual.

Link to a model for the bench design. There will be four instances of the same model.


Rathaus Muenchen - Panorama.jpg area area, tagged Link to a model of the building. Like the fountain example, but also replaces any building:part=* elements and indoor features of this building.


Golden Gate Bridge as seen from Battery East.jpg area area, tagged Link to a model of the bridge. Implicitly includes the road(s) and other features on top of the bridge, as well as bridge:support=* and other related elements.

Rendering examples


London Eye with tag


Four benches with this tag as

Police-Box (TARDIS)

See also