Sign in

v1

latestSwagger 2.02026-07-14211635.2 KB
Geography APIs

Search all cities from lat/long or countrycode

Search cities according to given criterias. Either lat/long + radius or country code. A limit can be given but cannot exceed 50 results.<br /> A significant city will be defined according to the pourcent of population within a country.

get/cities/findcitiesfromlatlong

Query parameters

language'en' | 'fr' | 'de' | 'es' required

the language code of the language you want the content to be returned

countrycodestring

if you want to limit the result to one country

locationstring

The Lat/Long of the location your are seeking cities ( ex. 45.4478988,3.23456)

radiusinteger

Radius in km for a lat/long search. Default is 20km and there is no maximum, but need to be combined with limit. code is passed

limitinteger

Limit of the result. Default is 20 rows, and maximum is 50.

offsetinteger

offset of the result set

sort'distance,desc' | 'distance,asc' | 'population,desc' | 'population,asc' | 'elevation,desc' | 'elevation,asc' | 'name,desc' | 'name,asc' | 'timezone,asc' | 'timezone,desc' required

The order you want the result ordered. Default is population while when entering a lat/long, you can order the results by distance from requested lat/long point

Response

Success

countinteger
messagestring
statusstring

Status of the response