Documentation

OSM Buildings

Leaflet Layer

Mapbox GL

Data Tiles

Data Tiles

Our data is based on XYZ tiles.
Data format is GeoJSON with geometry projection EPSG:4326 (WGS84).

Request Schema

GET http(s)://({abcd}.)data.osmbuildings.org/0.2/anonymous/tile/15/{x}/{y}.json
URL element Description
abcd optional subdomain for load balancing
x horizontal position of tile at zoom level 15
y vertical position of tile at zoom level 15

Example

https://data.osmbuildings.org/0.2/anonymous/tile/15/17605/10743.json

Feature ID

Unique identifier of building part. Re-use original OSM id wit h a prefix.
NOTICE: this will change soon for a building id that groups related parts

Feature Attributes

Attribute OSM Tags Description
name name building name
type building type of building
i.e. commerce, residence
building links building parts by using the same value for each part
NOTICE: this is about to change soon
height height total building height - in meters
minHeight min_height height at which a building part starts vertically (floating) - in meters
levels levels total building levels
minLevel min_level levels at which a building part starts vertically (floating)
color building:colour dominant color of building facade
named colors, rgb() or #hex values
material building:material, building:facade:material dominant material name
shape building:shape building shape if unusual
i.e. sphere, pyramid
roofShape roof:shape roof shape
i.e. skillion, hipped, flat, dome
roofHeight roof:height roof height (included in total height) - in meters
roofLevels roof:levels roof levels (adds to buildings levels)
roofColor roof:colour dominant roof color
named colors, rgb() or #hex values
roofMaterial roof:material dominant roof material name
roofDirection roof:direction, roof:orientation direction where a roof is facing, different rules for roof types, - clockwise in degrees from north
roofAngle roof:angle inclination of roof faces, could be used for height calculation - in degrees upwards from horizon