API Documentation
Access to global building attributes and geometry
Buildings by region
URL Schema
https://data.3dbuildings.com/download/{region_id}.json.zip?token={token}
| URL element | Description |
|---|---|
| region_id | Region ID, can be Continent name Country code Country code / State Code Country code / City name see Regions |
| token | Your API access token |
Examples
curl -o "Europe.json.zip" "https://data.3dbuildings.com/download/Europe.json.zip?token=YOUR_TOKEN"
curl -o "Germany.json.zip" "https://data.3dbuildings.com/download/DE.json.zip?token=YOUR_TOKEN"
curl -o "Berlin.json.zip" "https://data.3dbuildings.com/download/DE/Berlin.json.zip?token=YOUR_TOKEN"
Buildings by bounding box
URL Schema
https://data.3dbuildings.com/download.json?token={token}&bbox={w},{s},{e},{n}
| URL element | Description |
|---|---|
| token | Your API access token |
| w, s, e, n | Geo coordinates for west, south, east, north bounds of your area of interest |
Example
curl -o "in-Berlin.json" "https://data.3dbuildings.com/download.json?token=YOUR_TOKEN&bbox=13.2065,52.4021,13.5745,52.6126"
Buildings by ID
URL Schema
https://data.3dbuildings.com/feature/{feature_id}.json?token={token}
| URL element | Description |
|---|---|
| feature_id | Building ID |
| token | Your API access token |
Example
curl -o "438396411.json" "https://data.3dbuildings.com/feature/osm-w438396411.json?token=YOUR_TOKEN"
Regions
URL Schema
https://data.3dbuildings.com/download/{region_id}/?token={token}
| URL element | Description |
|---|---|
| region_id | Optional enclosing Region ID, can be empty Continent name Country code |
| token | Your API access token |
Examples
curl -o "Continents.json" "https://data.3dbuildings.com/download/?token=YOUR_TOKEN"
curl -o "Europe.json" "https://data.3dbuildings.com/download/Europe/?token=YOUR_TOKEN"
curl -o "Germany.json" "https://data.3dbuildings.com/download/DE/?token=YOUR_TOKEN"