API Documentation
This is the latest version from 2024-08.
Buildings by bounding box
URL Schema
https://data.onegeo.co/api/?token=ONEGEO_API_KEY&bbox=bbox
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
| bbox | required | Comma separated geo coordinates for west, south, east, north bounds of your area of interest. Extent is limited to 0.5 x 0.5 geo degrees. |
| min_height | Minimum building height in meters | |
| max_height | Maximum building height in meters | |
| types | Comma separated list of building types | |
| countries | Comma separated list of country codes |
Example
curl -o "philly.json" "https://data.onegeo.co/api/?token=ONEGEO_API_KEY&bbox=-75.25750,39.90128,-75.10153,40.01280"
Result
A GeoJSON FeatureCollection that contains all matching buildings.
Read more about the Data Format.
Buildings by location
URL Schema
https://data.onegeo.co/api/?token=ONEGEO_API_KEY&search=search
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
| search | required | A location search query, i.e. an address or a point of interest. Must be URL encoded. |
Example
curl -o "unhq.json" "https://data.onegeo.co/api/?token=ONEGEO_API_KEY&search=405+e+45+st+nyc"
Result
A GeoJSON FeatureCollection that contains all matching buildings.
Read more about the Data Format.
Building details by ID
URL Schema
https://data.onegeo.co/api/?token=ONEGEO_API_KEY&feature=id
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
| id | required | ONEGEO ID |
Example
curl -o "sphere.json" "https://data.onegeo.co/api/?token=ONEGEO_API_KEY&feature=037111f-0b9e666-6c"
Result
A GeoJSON FeatureCollection that contains a single building and/or its parts.
Read more about the Data Format.
Statistics by bounding box
Get statistcs ahead of a real building request.
Additional filters are not yet supported.
URL Schema
https://data.onegeo.co/stats/?token=ONEGEO_API_KEY&bbox=bbox
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
| bbox | required | Comma separated geo coordinates for west, south, east, north bounds of your area of interest. |
Example
curl -o "stats.json" "https://data.onegeo.co/stats/?token=ONEGEO_API_KEY&bbox=-75.25750,39.90128,-75.10153,40.01280"
Result
A GeoJSON FeatureCollection that contains a single Feature with statistics properties.
Building types
A curated list of building types.
URL schema
https://data.onegeo.co/meta/types/token=ONEGEO_API_KEY
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
Example
curl -o "types.json" "https://data.onegeo.co/meta/types/?token=ONEGEO_API_KEY"
Result
A JSON list of all available building types.
[
"administration",
"agriculture",
"agriculture:barn",
"agriculture:farm",
"agriculture:greenhouse",
"agriculture:stable",
"commerce",
"commerce:retail",
"culture",
"culture:religion",
"culture:sports",
"education",
"education:college",
"education:kindergarten",
"education:school",
"education:university",
...
]
Data sources
Lists attribution and license information of our available data sets.
URL schema
https://data.onegeo.co/meta/sources/token=ONEGEO_API_KEY
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
Example
curl -o "sources.json" "https://data.onegeo.co/meta/sources/?token=ONEGEO_API_KEY"
Result
A JSON list of all data sources.
[{
"attribution": "OpenStreetMap Contributors",
"license": "ODbL",
"year": 2019,
"url": "https://openstreetmap.org/copyright"
}, {
"attribution": "Microsoft Building Data 2018",
"license": "ODbL",
"year": 2018,
"url": "https://wiki.openstreetmap.org/wiki/Microsoft_Building_Footprint_Data#June_2018_Release"
},
...
]
