Locations v1 / Geometrie & hărți

Geometria unei regiuni

Poligonul oficial (ANCPI) al regiunii (cod NUTS) ca GeoJSON. ?simplificat=1 = payload mic.

GET

https://oneapi.ro/api/locations/v1/regiuni/{cod}/geometrie

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul NUTS 2 al regiunii de dezvoltare (ex. RO11).

Parametri de interogare

NumeTipDescriereValori acceptate

simplificatopțional string | null Geometrie cu mai puține puncte. 01

Cum se comportă

Poligonul oficial al regiunii, ca GeoJSON. ?simplificat=1 pentru payload mic.

La ce folosește

Conturul unei regiuni de dezvoltare pe hartă, ca grupare peste județe.
Choropleth la nivelul celor 8 regiuni NUTS-2, pentru raportări regionale.
Verificare vizuală a ariei acoperite de o operațiune regională.

Structura răspunsului

CâmpTipDescriere

data.cod string Cod NUTS-2 al regiunii (RO11, RO12…).opțional

data.cod_siruta integer Codul SIRUTA (cheia publică a entității).opțional

data.nume string Denumirea entității.

data.simplificat boolean Poligonul întors e cel simplificat (mai puține puncte), nu cel complet.

data.geometrie object Geometrie GeoJSON (MultiPolygon): type + coordinates.

data.geometrie.type string Tipul geometriei GeoJSON (Polygon sau MultiPolygon).

data.geometrie.coordinates[] mixed Coordonatele poligonului, în format GeoJSON (lng, lat).

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/regiuni/RO11/geometrie

{
    "data": {
        "cod": "RO11",
        "nume": "Nord-Vest",
        "simplificat": false,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            24.179521103,
                            46.804675675
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/regiuni/RO11/geometrie?simplificat=1

{
    "data": {
        "cod": "RO11",
        "nume": "Nord-Vest",
        "simplificat": true,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            23.574469046,
                            46.497163087
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/regiuni/RO32/geometrie

{
    "data": {
        "cod": "RO32",
        "nume": "București-Ilfov",
        "simplificat": false,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            26.303283772,
                            44.767737987
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

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	Regiunea nu există.
422	validare	Un parametru nu a trecut validarea (`simplificat`); `detalii` spune care şi de ce.
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": "validare",
        "mesaj": "Un parametru nu a trecut validarea (simplificat); detalii spune care şi de ce.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}