Locations v1 / Geo & reverse

Reverse address

From a point (lat/lng) → the nearest complete address (street + house number) plus the distance.

GET

https://oneapi.ro/api/locations/v1/adresa-inversa

Query parameters

NameTypeDescriptionAccepted values

latrequired number Latitude, WGS 84. -90 – 90

lngrequired number Longitude, WGS 84. -180 – 180

How it behaves

The nearest complete address (street + number) to a point, plus the distance.

What it is for

Prefilling the delivery address from a pin moved on the map while placing an order.
Confirming the address from a courier's GPS position at pickup or drop-off.
Normalising raw GPS points into readable addresses for reports.

Response structure

FieldTypeDescription

data.numar string The house number of the nearest address.

data.strada.id integer The internal id of the address's street — the key for /strazi/{id}.

data.strada.nume string The name of the street the address is on.

data.localitate.cod_siruta integer The locality's SIRUTA code — chainable to /localitati/{cod}.

data.localitate.nume string The name of the locality.

data.cod_postal string | null The postal code of the address (Ministry of Finance data); null if it is not mapped.

data.lat number The latitude of the address point (not of the queried point).

data.lng number The longitude of the address point.

data.distanta_m integer Distance (metres) from the queried point to the returned address.

meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

meta.distanta object How the distances in the response are measured. Present on every response that carries a distance.

meta.distanta.metoda string Always linie_dreapta (straight line): the geodesic distance over the Earth's surface, not by road.

meta.distanta.detaliu string The same information, in words.

Response examples

GEThttps://oneapi.ro/api/locations/v1/adresa-inversa?lat=44.4268&lng=26.1025

{
    "data": {
        "numar": "2",
        "strada": {
            "id": 219631,
            "nume": "Dimitrie Cantemir"
        },
        "localitate": {
            "cod_siruta": 179178,
            "nume": "București Sectorul 4"
        },
        "cod_postal": null,
        "lat": 44.4256212,
        "lng": 26.1026599,
        "distanta_m": 132
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "distanta": {
            "metoda": "linie_dreapta",
            "detaliu": "Distanţele sunt geodezice, în linie dreaptă pe suprafaţa Pământului (WGS84) — nu pe drum."
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/adresa-inversa?lat=46.77&lng=23.59

{
    "data": {
        "numar": "1",
        "strada": {
            "id": 14967,
            "nume": "Iuliu Maniu"
        },
        "localitate": {
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca"
        },
        "cod_postal": "400095",
        "lat": 46.7702351,
        "lng": 23.5905329,
        "distanta_m": 48
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "distanta": {
            "metoda": "linie_dreapta",
            "detaliu": "Distanţele sunt geodezice, în linie dreaptă pe suprafaţa Pământului (WGS84) — nu pe drum."
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/adresa-inversa?lat=47.1585&lng=27.6014

{
    "data": {
        "numar": "42",
        "strada": {
            "id": 28069,
            "nume": "Tudor Vladimirescu"
        },
        "localitate": {
            "cod_siruta": 95079,
            "nume": "Iași"
        },
        "cod_postal": "700311",
        "lat": 47.158297467465836,
        "lng": 27.601314305835803,
        "distanta_m": 23
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "distanta": {
            "metoda": "linie_dreapta",
            "detaliu": "Distanţele sunt geodezice, în linie dreaptă pe suprafaţa Pământului (WGS84) — nu pe drum."
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/adresa-inversa?lat=46.7712&lng=23.6236

{
    "data": {
        "numar": "11",
        "strada": {
            "id": 15607,
            "nume": "Slănic"
        },
        "localitate": {
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca"
        },
        "cod_postal": "400413",
        "lat": 46.77112863909324,
        "lng": 23.62343295918785,
        "distanta_m": 15
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "distanta": {
            "metoda": "linie_dreapta",
            "detaliu": "Distanţele sunt geodezice, în linie dreaptă pe suprafaţa Pământului (WGS84) — nu pe drum."
        }
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Token missing, invalid, expired or revoked.
403	feature_indisponibil	The current plan does not include the feature the route depends on.
422	parametri_invalizi	`lat`/`lng` missing or invalid.
429	cota_depasita	The plan's monthly quota has been exceeded (see `Retry-After`).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "parametri_invalizi",
        "mesaj": "lat/lng missing or invalid.",
        "detalii": {
            "lat": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}