3dbuildings Maps API
Data Format • Data API • Maps API • Feature API
Data is segmented into tiles, formats are GeoJSON or Vector Tiles.
URL Schema
GET http(s)://({abcd-})data.3dbuildings.com/tile/{z}/{x}/{y}.{format}?token={token}
URL element | Description |
---|---|
abcd | Alternative hosts a-data, b-data, c-data, d-data for load balancing |
z | Zoom level of requested tile 12 features represented as points 13-16 gradually detailed geometry 17 maximum quality, ~10 cm resolution 18+ not provided, clients need to scale up from level 17 |
x | Horizontal position of tile at zoom level |
y | Vertical position of tile at zoom level |
format | Format can be json for GeoJSON or pbf for Vector Tile |
token | Your API access token |
Example
curl -o "15-17605-10743.json" "https://data.3dbuildings.com/tile/15/17605/10743.json?token=YOUR_TOKEN"
Integration
Mapbox GL
The referenced style definition takes care for further url handling.
<script>
let map = new mapboxgl.Map({
container: 'map',
style: 'https://data.3dbuildings.com/tile/style/buildings.json?token=YOUR_TOKEN',
...
});
</script>
OSM Buildings
<script>
let map = new OSMBuildings(...)
map.addMapTiles(...);
map.addGeoJSONTiles('https://{s}-data.3dbuildings.com/tile/{z}/{x}/{y}.json?token=YOUR_TOKEN');
</script>
Leaflet
<script>
let map = new L.Map(...);
new L.TileLayer(...).addTo(map);
let osmb = new OSMBuildings(map).load('https://{s}-data.3dbuildings.com/tile/{z}/{x}/{y}.json?token=YOUR_TOKEN');
</script>