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

URL Schema

[protocol=https|http]://{subdomain=a.|b.|c.|d.}data.osmbuildings.org/0.2/anonymous/tile/15/{x}/{y}.json

Example

https://data.osmbuildings.org/0.2/anonymous/tile/15/17605/10743.json
URL element Description
protocol http or https are available
subdomain optional subdomain for load balancing
x horizontal position of tile at zoom level 15
NOTICE: other zoom levels will be available soon
y vertical position of tile at zoom level 15
NOTICE: other zoom levels will be available soon

Feature Attributes

Attribute OSM Tags Description
id (not an attribute) unique identifier of building part, attempts to re-use original OSM id
NOTICE: this is about to change soon for a building id that groups related parts
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 will be dropped soon with new id schema coming
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