Locations v1 / Geo & reverse

Adresa inversă

Dintr-un punct (lat/lng) → cea mai apropiată adresă completă (stradă + număr) + distanța.

GET

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

Parametri de interogare

NumeTipDescriereValori acceptate

latobligatoriu number Latitudine WGS84. -90 – 90

lngobligatoriu number Longitudine WGS84. -180 – 180

Cum se comportă

Cea mai apropiată adresă completă (stradă + număr) de un punct + distanța.

La ce folosește

Pre-completarea adresei de livrare dintr-un pin mutat pe hartă la plasarea comenzii.
Confirmarea adresei din poziția GPS a curierului la ridicare/predare.
Normalizarea unor puncte GPS brute în adrese lizibile pentru rapoarte.

Structura răspunsului

CâmpTipDescriere

data.numar string Numărul poștal al celei mai apropiate adrese.

data.strada.id integer Id-ul intern al străzii adresei — cheia pentru /strazi/{id}.

data.strada.nume string Denumirea străzii pe care se află adresa.

data.localitate.cod_siruta integer Codul SIRUTA al localității — chainable spre /localitati/{cod}.

data.localitate.nume string Denumirea localității.

data.cod_postal string | null Codul poștal al adresei (MFP); null dacă nu e mapat.

data.lat number Latitudinea punctului de adresă (nu a punctului interogat).

data.lng number Longitudinea punctului de adresă.

data.distanta_m integer Distanța (metri) de la punctul interogat la adresa returnată.

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

meta.distanta object Cum sunt măsurate distanţele din răspuns. Apare pe orice răspuns care conţine o distanţă.

meta.distanta.metoda string Mereu linie_dreapta: distanţa geodezică pe suprafaţa Pământului, nu pe drum.

meta.distanta.detaliu string Aceeaşi informaţie, în cuvinte.

Exemple de răspuns

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."
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	parametri_invalizi	`lat`/`lng` lipsă/invalid.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "parametri_invalizi",
        "mesaj": "lat/lng lipsă/invalid.",
        "detalii": {
            "lat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}