API
This is the latest API version 2.2.1 from 2024-03.
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"
Building details by ID
Using a new endpoint and our latest and stable ONEGEO ID schema.
URL Schema
https://data.onegeo.co/api/?token=ONEGEO_API_KEY&feature=feature
URL element | Description | |
---|---|---|
token | required | ONEGEO API key Get your key here |
feature | required | ONEGEO ID |
Example
curl -o "sphere.json" "https://data.onegeo.co/api/?token=ONEGEO_API_KEY&feature=037111f-0b9e666-6c"
DEPECATED URL Schema
This is using inconsistent and instable id's from various sources.
https://data.onegeo.co/features/?token=ONEGEO_API_KEY&id=id
Search locations
URL Schema
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 continent, country, state, city or other location's name. |
Example
curl -o "search.json" "https://data.onegeo.co/search/?token=ONEGEO_API_KEY&query=berlin"
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
[
"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
[{
"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"
},
...
]