From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg roof:shape
Roof4 0.jpg
Roof shape type. Edit or translate this description.
Group: Properties
Used on these elements
should not be used on nodesshould not be used on waysmay be used on areasuse on relations unspecified
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.


These tags require an area feature tagged was a 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:

Roof shape

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

Image Roof0 0.jpg Roof1 0.jpg Roof2 0.jpg Roof2 3.jpg Roof2 4.jpg Roof2 5.jpg
roof:shape flat skillion gabled half-hipped hipped pyramidal
Image Roof4 0.jpg Roof4 2.jpg Roof5 6.jpg Roof8.jpg Roof5 0.jpg Roof3 1.jpg
roof:shape gambrel mansard dome onion round saltbox

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

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

This section is a wiki template, editable here.

See also