|Roof shape type.|
|Used on these elements|
|Documented values: 19|
|Status: de facto|
|Tools for this tag|
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.
These tags require an area feature tagged with building=* or building:part=*.
See Simple 3D buildings for more tags used to describe the shape and appearance of buildings.
Common values are shown below, with example diagrams:
You can characterize the roof shape of a building using a catalogue of well-known roof types.
Other common values.
|side_hipped||Half of a hipped roof, not the same as half-hipped. One vertical gabled side, one 'hip' with three sloped faced. This is common on semi-detached properties where the whole building has a hipped roof, but each house has a side_hipped roof.|
|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|
value with problems
|saltbox, double_saltbox, quadruple_saltbox||conflicting definitions and meanings of "saltbox" in this context. |
|conical||duplicate of cone|
|lean_to||Unclear, probably should be skillion.|
|shed||Mono-pitched roofing, also sawtooth|
|gabled_row||Unclear, sometimes used on a sawtooth roof, sometimes a row of gabled terrace.|
|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=*.|
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).
This section is a wiki template, editable here.
Possible tagging mistakes
- roof:material=* - Outer material for the building roof
- Simple 3D Buildings
- ↑ By some users/editors, the roof shape which is shown on this picture may be interpreted as double_saltbox, whereas saltbox then has only one upper roof edge.
- ↑ What is a saltbox?, Tagging ML, 12 Feb 2020