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