GETAPI key

Reverse geocoding

GETapi.navo24.com/v1/geo/reverse

Nearest places to a coordinate, closest first, with the distance in km. Filter by kind to answer "which port or rail terminal is nearest to this warehouse". The example is a point in central Odesa.

Query parameters

latnumberrequired

Latitude, -90 to 90.

lngnumberrequired

Longitude, -180 to 180. lon is accepted too.

kindsstring

Comma-separated place kinds: city, port, airport, rail, logistics, region, country. Omit for all kinds.

radius_kmnumber

Search radius, 0.1 to 200 km. Default 50.

limitinteger

Results, 1 to 50. Default 5.

Response schema

12 fields

Derived from the example response, nested as the JSON is.

dataobject[]

The payload. Everything an endpoint returns sits under this key.

data[]object

idnumber

Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.

kindstring

carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.

namestring

Human-readable name.

country_codestring

ISO 3166-1 alpha-2 country code.

countrystring

Country name.

latnumber

Latitude.

lngnumber

Longitude.

populationnumber

locodestring

UN/LOCODE of the place.

distance_kmnumber

took_msnumber

Errors

A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.

missing_key401

No Authorization: Bearer *** or X-API-Key header.

invalid_key401

The key was not recognised.

invalid_request400

lat or lng is missing, not a number, or out of range.

rate_limited429

More than 120 requests in one minute from one IP.

curl 'https://api.navo24.com/v1/geo/reverse?lat=46.4848&lng=30.7417&kinds=port%2Crail&radius_km=50&limit=2' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.navo24.com/v1/geo/reverse?lat=46.4848&lng=30.7417&kinds=port%2Crail&radius_km=50&limit=2", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.navo24.com/v1/geo/reverse?lat=46.4848&lng=30.7417&kinds=port%2Crail&radius_km=50&limit=2",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": [
    {
      "id": 698740,
      "kind": "city",
      "name": "Odesa",
      "country_code": "UA",
      "country": "Ukraine",
      "lat": 46.48572,
      "lng": 30.74383,
      "population": 1010537,
      "locode": "UAODS",
      "distance_km": 0.192
    },
    {
      "id": 698733,
      "kind": "rail",
      "name": "Odesa-Port",
      "country_code": "UA",
      "country": "Ukraine",
      "lat": 46.48755,
      "lng": 30.74501,
      "esr": "400305",
      "distance_km": 0.397
    }
  ],
  "took_ms": 2.4
}