Locations v1 / Geometrie & hărți

Geometria unui UAT

Poligonul oficial (ANCPI) al UAT-ului (cod_siruta) ca GeoJSON. ?simplificat=1 = payload mic.

GET

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

Parametri de cale

NumeTipDescriereExemplu

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

Parametri de interogare

NumeTipDescriereValori acceptate

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

Cum se comportă

Poligonul oficial ANCPI al UAT-ului, ca GeoJSON. ?simplificat=1 pentru payload mic.

La ce folosește

Desenarea limitei unei comune/oraș pe hartă, ca zonă de livrare vizuală.
Point-in-polygon local: descarci poligonul UAT-ului o dată și testezi puncte pe client.
Definirea unui geofence pentru o zonă de acoperire sau de tarifare.

Structura răspunsului

CâmpTipDescriere

data.cod string Codul entității (cheia publică a nivelului).opțional

data.cod_siruta integer Cheia publică (SIRUTA) a UAT-ului.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/uat/54975/geometrie?simplificat=1

{
    "data": {
        "cod_siruta": 54975,
        "nume": "Cluj-Napoca",
        "simplificat": true,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            23.621322321,
                            46.860083492
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

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

{
    "data": {
        "cod_siruta": 54975,
        "nume": "Cluj-Napoca",
        "simplificat": false,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            23.621322321,
                            46.860083492
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/155243/geometrie?simplificat=1

{
    "data": {
        "cod_siruta": 155243,
        "nume": "Timișoara",
        "simplificat": true,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            21.175639715,
                            45.829462496
                        ]
                    ]
                ]
            ]
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/1071/geometrie?simplificat=1

{
    "data": {
        "cod_siruta": 1071,
        "nume": "Ciugud",
        "simplificat": true,
        "geometrie": {
            "type": "MultiPolygon",
            "coordinates": [
                [
                    [
                        [
                            23.685744897,
                            46.088559105
                        ]
                    ]
                ]
            ]
        }
    },
    "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	UAT-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."
            ]
        }
    }
}