Key:roof:shape

From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg roof:shape
Marienkapelle und Wohnhaus (Schafhausermühle).jpg
Description
Roof shape type Show/edit corresponding data item.
Group: buildings
Used on these elements
may be used on nodesshould not be used on waysmay be used on areas (and multipolygon relations)should not be used on relations (except multipolygon relations)
Documented values: 21
Requires
Useful combination
Status: de facto

The key roof:shape=* is used to describe the shape of a building's roof, or the shape of the roof of a building part.

Tagging

OOjs UI icon reference.svg Related page : Simple 3D buildings, for more tags used to describe the shape and appearance of buildings.

Area

Common values

Roof shape

You can characterize the roof shape of a building using a catalogue of well-known roof types.

Image Roof Gabled.png Roof Flat.png Roof Hipped.png Roof Pyramidal.png Roof Skillion.png Roof Half Hipped.png Roof Hip and Gable.png Tejado mariposa.svg
roof:shape gabled flat hipped pyramidal skillion half-hipped hipped-and-gabled butterfly
Image Roof Round.png Roof Gambrel.png Roof Mansard.png Roof Dome.png Roof Onion.png Roof Sawtooth.png
roof:shape round gambrel mansard dome onion sawtooth
Image Roof Cone.png Roof Crosspitched.png Roof Side Hipped.png Roof Side Half Hipped.png Roof Gabled Height Moved.png
roof:shape cone crosspitched side_hipped side_half-hipped gabled_height_moved
Other common values
Value Comment
many Marks that building has multiple different roof shapes at once. Such building may have building:part=* carrying own roof:shape values. History described in detail in roof:shape=many

Other roof tags

Key Comment
roof:orientation=along/across For roofs with a ridge the ridge is assumed to be parallel to the longest side of the building (roof:orientation=along). But it can be tagged explicitly with this tag.
roof:height=* The height of the building (i.e. the height of the façade) is calculated as the building's total height=* minus roof:height=*.
roof:angle=* Alternatively to roof:height=*, roof height can be indicated implicitly by providing the inclination of the sides (in degrees).
roof:levels=* Number of floors within the roof, which are not already counted in building:levels=*.
roof:direction=* Direction from back side of roof to front, i.e. the direction towards which the main face of the roof is looking.
roof:material=* The outermost material of the roof. Useful in conjunction with roof:colour=*.
roof:colour=* The (dominant) colour of the roof. Useful in conjunction with roof:material=*.

This section is a wiki template, editable here.

Problems and mistakes

Values with problems

Value Image Comment
saltbox, double_saltbox, triple_saltbox, quadruple_saltbox Roof Saltbox.png Inconsistent definitions of "saltbox" by some editors/users (through displayed images).

The roof shapes displayed as an image by some editors/users in one case represent a "saltbox" with only one top edge of the roof (which is the usual definition of a building with a saltbox roof, see also  Saltbox house), and in another case a "saltbox" with two top roof edges (which is also called a double_saltbox). See also this mailing list discussion "What is a saltbox?" (Tagging ML, 12 Feb 2020) – with no clear results – and the fairly clear definitions on OSM-4D/Roof table.

conical Roof Cone.png Duplicate of cone
lean_to Unclear, should probably be skillion.
shed Mono-pitched roofing, also sawtooth
gabled_row Unclear, sometimes used on a sawtooth roof, sometimes a row of gabled terrace.

Possible tagging mistakes

If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!

See also

Proposed tags

Some roofs (e.g., square buildings) cannot be accurately modeled with the simple techniques described on this page.

Additional roof shapes are suggested in S3DB Proposals, including advanced approaches for manual modelling (e.g., ProposedRoofLines or parts of OSM-4D/Roof table).