This is the latest version from 2024-08.
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 |
curl -o "philly.json" "https://data.onegeo.co/api/?token=ONEGEO_API_KEY&bbox=-75.25750,39.90128,-75.10153,40.01280"
A GeoJSON FeatureCollection that contains all matching buildings.
Read more about the Data Format.
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 |
curl -o "sphere.json" "https://data.onegeo.co/api/?token=ONEGEO_API_KEY&feature=037111f-0b9e666-6c"
A GeoJSON FeatureCollection that contains a single building and/or its parts.
Read more about the Data Format.
Get statistcs ahead of a real building request.
Additional filters are not yet supported.
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. |
curl -o "stats.json" "https://data.onegeo.co/stats/?token=ONEGEO_API_KEY&bbox=-75.25750,39.90128,-75.10153,40.01280"
A GeoJSON FeatureCollection that contains a single Feature with statistics properties.
https://data.onegeo.co/search/?token=ONEGEO_API_KEY&query=query
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
| query | required | Your search term. Can be a continents, countries, states, cities or other location names. |
curl -o "search.json" "https://data.onegeo.co/search/?token=ONEGEO_API_KEY&query=berlin"
A GeoJSON FeatureCollection that contains all matching locations as Features.
A curated list of building types.
https://data.onegeo.co/meta/types/token=ONEGEO_API_KEY
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
curl -o "types.json" "https://data.onegeo.co/meta/types/?token=ONEGEO_API_KEY"
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",
...
]
Lists attribution and license information of our available data sets.
https://data.onegeo.co/meta/sources/token=ONEGEO_API_KEY
| URL element | Description | |
|---|---|---|
| token | required | ONEGEO API key Get your key here |
curl -o "sources.json" "https://data.onegeo.co/meta/sources/?token=ONEGEO_API_KEY"
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"
},
...
]
