Address geocoding
Street address to coordinates and postcode, from OpenStreetMap and OpenAddresses house numbers. Write the address the way a person would. The example is Derybasivska 10, Odesa.
Query parameters
Street, house number and city in one string.
ISO 3166-1 alpha-2 country filter.
Results, 1 to 20. Default 5.
Response schema
12 fields
Derived from the example response, nested as the JSON is.
The payload. Everything an endpoint returns sits under this key.
data[]
carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.
Human-readable name.
City the airport serves.
ISO 3166-1 alpha-2 country code.
Latitude.
Longitude.
Where the answer on this call came from: direct_carrier or warm_db.
Errors
A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.
No Authorization: Bearer *** or X-API-Key header.
The key was not recognised.
q is missing.
curl 'https://api.navo24.com/v1/geo/address?q=Deribasivska%2010%20Odesa&cc=UA&limit=1' \
-H "Authorization: Bearer tmcp_YOUR_API_KEY"const res = await fetch("https://api.navo24.com/v1/geo/address?q=Deribasivska%2010%20Odesa&cc=UA&limit=1", {
headers: {
"Authorization": "Bearer tmcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.get(
"https://api.navo24.com/v1/geo/address?q=Deribasivska%2010%20Odesa&cc=UA&limit=1",
headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json(){
"data": [
{
"kind": "address",
"name": "Дерибасівська вулиця 10",
"street": "Дерибасівська вулиця",
"housenumber": "10",
"city": "Одеса",
"postcode": "65026",
"country_code": "UA",
"lat": 46.484352,
"lng": 30.741688,
"source": "osm"
}
],
"took_ms": 190.9
}