Geomelon API (1.0)

Download OpenAPI specification:

Read-only geospatial & metadata API

cities

Find cities closest to the given lan/lot

query Parameters
preferredLanguages
string
Default: "en"
lon
required
number
lat
required
number

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Find the most populous cities near given lan/lot

query Parameters
preferredLanguages
string
Default: "en"
lon
required
number
lat
required
number

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get distance between two cities in km

query Parameters
city2
required
string
city1
required
string

Responses

Response samples

Content type
application/json
{
  • "distanceKm": 0
}

List cities with optional filters, pagination, translations, and name search

query Parameters
sort
string
Example: sort=population_desc
offset
number
Default: 0
limit
number
Default: 20
preferredLanguages
string
Default: "en,fr,ja,hi"
name
string
Example: name=dallas
maxPopulation
number
minPopulation
number
regionId
string
countryCode
string
Example: countryCode=us

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get city by ID, including country and region info

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "964512d1-f150-4876-87ec-0ba47aef694a",
  • "wikidataId": "Q1492",
  • "name": "Barcelona",
  • "localizedName": "Q1492",
  • "population": 1702547,
  • "latitude": 41.3825,
  • "longitude": 2.176944444,
  • "elevation": 9,
  • "area": 101.3,
  • "postalCode": "08001–08042",
  • "officialWebsite": "https://www.barcelona.cat",
  • "timeZone": "UTC+01:00",
  • "dialingCode": "93",
  • "normalizedName": "barcelona",
  • "translations": [
    ],
  • "distanceKm": 12.5,
  • "countryId": "a1e06cc1-817c-429f-84f4-6ab51dac9bfa",
  • "countryName": "Spain",
  • "countryCode": "ES",
  • "countryEmoji": "🇪🇸",
  • "countryTelephoneCode": "+34",
  • "regionName": "Catalonia",
  • "regionCode": "ES-CT",
  • "regionId": "dde1e1c6-ca22-48e6-8ad7-f97b141c1929"
}

Get all translations for a city

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get settlement types for a city

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

countries

List of countries

query Parameters
limit
number
Default: 200
Example: limit=200

Maximum number of results

offset
number
Default: 0
Example: offset=0

Number of results to skip

telephoneCode
string
Example: telephoneCode=+34

Filter by telephone code

name
string
Example: name=Spa

Prefix search on country name (English and preferred-language translations)

preferredLanguages
string
Example: preferredLanguages=fr,es,en

Comma-separated language codes. Affects localizedName and translation name search.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get country by ID

path Parameters
id
required
string
Example: 509a2a0a-5ec6-483e-8381-4bea4422ac26

Responses

Response samples

Content type
application/json
{
  • "id": "a1e06cc1-817c-429f-84f4-6ab51dac9bfa",
  • "wikidataId": "Q29",
  • "name": "Spain",
  • "emoji": "🇪🇸",
  • "headOfState": "Felipe VI of Spain",
  • "headOfGovernment": "Pedro Sánchez",
  • "isoCode": "ES",
  • "telephoneCode": "+34",
  • "trunkPrefix": "0",
  • "licencePlateCode": "E",
  • "drivingSide": "right",
  • "preferredLanguageId": "a3d69219-5e64-4fef-a137-10bceb326e3d",
  • "translations": [
    ],
  • "regions": [
    ]
}

Get translations for a country

path Parameters
id
required
string
Example: 509a2a0a-5ec6-483e-8381-4bea4422ac26
query Parameters
preferredLanguages
string
Default: "en"
Example: preferredLanguages=en,fr,hi

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get regions in the country

path Parameters
id
required
string
Example: 509a2a0a-5ec6-483e-8381-4bea4422ac26

Responses

Response samples

Content type
application/json
[
  • {
    }
]

regions

List regions, optionally filtered by country

query Parameters
countryId
string
Example: countryId=509a2a0a-5ec6-483e-8381-4bea4422ac26

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get region by ID

path Parameters
id
required
string
Example: 63df31a3-ca32-4970-8b5e-bcf9a11426e6

Responses

Response samples

Content type
application/json
{
  • "id": "dde1e1c6-ca22-48e6-8ad7-f97b141c1929",
  • "wikidataId": "Q5705",
  • "name": "Catalonia",
  • "countryId": "a1e06cc1-817c-429f-84f4-6ab51dac9bfa",
  • "population": 8034743,
  • "code": "ES-CT",
  • "latitude": 41.85,
  • "longitude": 1.566666666,
  • "country": {
    }
}

Get translations for a region

path Parameters
id
required
string
Example: 63df31a3-ca32-4970-8b5e-bcf9a11426e6
query Parameters
preferredLanguages
string
Default: "en"
Example: preferredLanguages=en,fr,hi

Responses

Response samples

Content type
application/json
[
  • {
    }
]

languages

List languages with pagination

query Parameters
limit
number
Default: 200
Example: limit=200

Maximum number of results

offset
number
Default: 0
Example: offset=0

Number of results to skip

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get language by ID

path Parameters
id
required
string
Example: 6aa910e2-07b2-4f0e-a1ec-194e85c4f35b

Responses

Response samples

Content type
application/json
{
  • "id": "abbf9d44-2b77-464b-bca4-90026a66182c",
  • "wikidataId": "Q256",
  • "name": "Turkish",
  • "isoCode": "tr",
  • "citiesCount": 252088
}