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=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"

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 continents, countries, states, cities or other location names.

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" }, ... ]