Locations v1 / Proximitate & zone

Vecinii unui UAT

UAT-urile adiacente (care împart graniță) cu un UAT, ordonate după lungimea graniței
comune. Identificat prin cod_siruta.

GET

https://oneapi.ro/api/locations/v1/uat/{cod}/vecini

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Ordonate după lungimea graniței comune (descrescător).

La ce folosește

Extinderea unei zone de livrare la comunele/orașele UAT vecine.
Alocarea curierilor pe UAT-uri adiacente pentru rute compacte.
Identificarea localităților de graniță relevante pentru servicii municipale.

Structura răspunsului

CâmpTipDescriere

data[].cod_siruta integer Codul SIRUTA al UAT-ului vecin (cheia publică).

data[].nume string Denumirea UAT-ului vecin.

data[].tip string Tipul UAT-ului vecin (municipiu/oraș/comună).

data[].judet.cod string Indicativul auto al județului vecinului — poate diferi de al UAT-ului cerut.

data[].judet.nume string Numele județului vecinului.

data[].lungime_granita_m integer Lungimea graniței comune, în metri.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/54975/vecini

{
    "data": [
        {
            "cod_siruta": 55687,
            "nume": "Apahida",
            "tip": "comuna",
            "judet": {
                "cod": "CJ",
                "nume": "Cluj"
            },
            "lungime_granita_m": 23833
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/155243/vecini

{
    "data": [
        {
            "cod_siruta": 155314,
            "nume": "Giroc",
            "tip": "comuna",
            "judet": {
                "cod": "TM",
                "nume": "Timiș"
            },
            "lungime_granita_m": 15129
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/1071/vecini

{
    "data": [
        {
            "cod_siruta": 1017,
            "nume": "Alba Iulia",
            "tip": "municipiu",
            "judet": {
                "cod": "AB",
                "nume": "Alba"
            },
            "lungime_granita_m": 17064
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

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.
404	negasit	UAT-ul nu există.
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": "negasit",
        "mesaj": "UAT-ul nu există."
    }
}