Geographic coordinates of populated place

GET /{lang}/places/geoname

Returns geographic coordinates for the given placename (region, city, village, etc.). The method returns the place whose name is most similar to the search string. Service based on GeoNames database.

Request

Base URL
https://api.opentripmap.com/0.1
Auth
API key in query parameter apikey
TypeScript
https://skmtc.dev/opentripmap/apis/opentripmap-api/docs/:lang/places/geoname/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

langstring required

Two-letter language code (ISO639-1). The following values are available: en (english), ru (russian)

Query parameters

namestring required

Placename

countrystring

Two-letter country code, ISO-3166 (optional). Default is all countries.

Response

Returns geographic coordinates

namestring required

The name of the place

countrystring required

ISO-3166 2-letter country code

lonnumber double required

Longitude

latnumber double required

Latitude

timezonestring

The iana timezone id

populationinteger

Population count

partial_matchboolean

A sign that the method did not return an exact match for the requested name

Example response

{
  "country": "RU",
  "timezone": "Europe/Moscow",
  "name": "Moscow",
  "lon": 37.61556,
  "lat": 55.75222,
  "population": 10381222
}

Changes

No recorded changes to this operation across all 1 revision of this API.