Locations v1 / Geometrie & hărți

Geometria unui județ

Poligonul oficial (ANCPI) al județului ca GeoJSON. ?simplificat=1 = payload mic pentru web.

GET

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

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

Parametri de interogare

NumeTipDescriereValori acceptate

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

Cum se comportă

Poligonul oficial ANCPI, ca GeoJSON standard — se dă direct la Leaflet/Mapbox.
?simplificat=1 reduce dramatic payload-ul (ex. județ: ~1 MB → ~21 kB), ideal pentru web.

La ce folosește

Desenarea conturului unui județ pe o hartă Leaflet/Mapbox, ca overlay administrativ.
Choropleth pe județe: fiecare poligon primește o culoare după o metrică (vânzări, densitate).
Clip/mask geografic — restrângi un layer sau o interogare la limita județului.

Structura răspunsului

CâmpTipDescriere

data.cod string Codul entității (cheia publică a nivelului).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

Coordonatele sunt scurtate aici.

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/geometrie?simplificat=1

{
    "data": {
        "cod": "CJ",
        "nume": "Cluj",
        "simplificat": true,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            23.595830529,
                            46.48709052
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/AB/geometrie

{
    "data": {
        "cod": "AB",
        "nume": "Alba",
        "simplificat": false,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            22.811951729,
                            46.568869031
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/geometrie

{
    "data": {
        "cod": "CJ",
        "nume": "Cluj",
        "simplificat": false,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            24.022721145,
                            47.361963181
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/B/geometrie

{
    "data": {
        "cod": "B",
        "nume": "București",
        "simplificat": false,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            26.10083726,
                            44.54079319
                        ]
                    ]
                ]
            ]
        }
    },
    "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	Județul 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."
            ]
        }
    }
}