Locations v1 / Demografie

Analiză demografică pe zonă

⭐ Populația totală, numărul de localități și densitatea pe o rază (km) în jurul unui
punct — „câți oameni în jurul acestei coordonate".

GET

https://oneapi.ro/api/locations/v1/analiza-zona

Parametri de interogare

NumeTipDescriereValori acceptate

latobligatoriu number Latitudinea centrului. -90 – 90

lngobligatoriu number Longitudinea centrului. -180 – 180

raza_kmobligatoriu number Raza în km. 0.1 – 200

Cum se comportă

⭐ „Câți oameni în jurul acestei coordonate?" — populația totală, numărul de localități și densitatea pe o rază.

La ce folosește

Studiu de piață: câți locuitori cad în raza de X km a unei potențiale locații de magazin/farmacie/PUDO.
Dimensionarea unei zone de serviciu (curier, medic de familie) în jurul unui punct fix.
Estimarea rapidă a audienței pentru o campanie geo-targetată pornind de la o coordonată.

Structura răspunsului

CâmpTipDescriere

data.centru object Ecou al punctului primit (lat/lng).

data.centru.lat number Latitudine (WGS84).

data.centru.lng number Longitudine (WGS84).

data.raza_km number Raza cercului analizat, în km (ecou al cererii).

data.nr_localitati integer Câte localități au centroidul în interiorul cercului.

data.populatie_totala integer Suma populației (RPL2021) a localităților cuprinse.

data.suprafata_kmp number Aria cercului (π·rază²), nu suma suprafețelor localităților.

data.densitate number | null populatie_totala / suprafata_kmp (locuitori/km²).

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/analiza-zona?lat=46.77&lng=23.59&raza_km=2

{
    "data": {
        "centru": {
            "lat": 46.77,
            "lng": 23.59
        },
        "raza_km": 2,
        "nr_localitati": 0,
        "populatie_totala": 0,
        "suprafata_kmp": 12.57,
        "densitate": 0
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/analiza-zona?lat=44.43&lng=26.10&raza_km=1

{
    "data": {
        "centru": {
            "lat": 44.43,
            "lng": 26.1
        },
        "raza_km": 1,
        "nr_localitati": 5,
        "populatie_totala": 1425404,
        "suprafata_kmp": 3.14,
        "densitate": 453950.3
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/analiza-zona?lat=47.16&lng=27.60&raza_km=5

{
    "data": {
        "centru": {
            "lat": 47.16,
            "lng": 27.6
        },
        "raza_km": 5,
        "nr_localitati": 4,
        "populatie_totala": 281478,
        "suprafata_kmp": 78.54,
        "densitate": 3583.9
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+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.
422	parametri_invalizi	lipsă `lat`/`lng`/`raza_km`.
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": "lipsă lat/lng/raza_km.",
        "detalii": {
            "lat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}