Geographical Database

Reverse Query

The Compute Asset geographical database can be used to perform reverse geocoding.

Currently the following queries are supported:

parameter type example
lat floating 12.858268
lon float 34.294471
radius float 1
size integer 10
layers comma separated address,venue
sources comma separated oa,gn
country comma separated FR,GB

A list of geographical feature within the radius away from the point (lat, lon) will be returned along with

  1. distance away (in kilometres)
  2. confidence (0.0 to 1.0)

Data Sources

All Citizen Ecosystems come with a default set of global data sources to get them started fast.

Global Data Sources

Currently the following data sources are being used:

  1. OpenStreetMap - http://www.openstreetmap.org/
  2. OpenAddresses - http://openaddresses.io/
  3. Who's on First - https://whosonfirst.org/
  4. GeoNames - http://www.geonames.org/

The following data sources are being evaluated to be added as one of the default data sources.

  1. Overture - https://overturemaps.org/

Local Data Sources

Area Entities (e.g. region, district, building etc.) have their own data sources with their own rules.

Geographical Layers

Geographical Layers (Layers) can be use to group similar geographical features together.

Currently the following are supported:

layer description
venue points of interest, businesses, things with walls
address places with a street address
street streets,roads,highways
country places that issue passports, nations, nation-states
macroregion a related group of regions.
region states and provinces
macrocounty a related group of counties.
county official governmental area; usually bigger than a locality, almost always smaller than a region
locality towns, hamlets, cities
localadmin local administrative boundaries
borough a local administrative boundary, currently only used for New York City
neighbourhood social communities, neighbourhoods
coarse alias for simultaneously using all administrative layers (everything except venue and address)