Business v1 / Locații

Profilul economic al unei zone

Câte firme sunt în jurul punctului, în ce stare și ce fac — top 5 sectoare CAEN. Varianta
agregată a rutei /firme/aproape, fără lista de firme.

pe_categorie dă compoziția ÎNTREGII zone, indiferent de filtru, iar total respectă filtrul: fără
asta, „câte funcționează aici" cerea citirea tuturor rândurilor din /firme/aproape — șase cereri
pentru o rază mică, la fiecare afișare.

GET

https://oneapi.ro/api/business/v1/firme/zona

Parametri de interogare

NumeTipDescriereValori acceptate

latopțional string | null Latitudinea centrului (WGS84), în România. ex. 46.77ex. 44.43ex. 47.17

lngopțional string | null Longitudinea centrului (WGS84), în România. ex. 23.59ex. 26.10ex. 27.57

raza_kmopțional string | null Raza în km: între 0,05 şi 25; implicit 0,5. ex. 1ex. 2

stareopțional string | null Categoria de stare, nu denumirea ONRC: cele 197 de denumiri se reduc la şapte categorii, iar
„ce funcţionează aici" e o întrebare despre categorie. in: aici, nu permisiv ca restul:
o valoare greşită trebuie să dea 422, nu o zonă goală care arată ca o zonă fără firme. activasuspendatadizolvatalichidareradiatainsolventaalta

Cum se comportă

Câte firme sunt în jurul punctului şi ce fac — primele 5 sectoare CAEN. Varianta agregată a rutei /firme/aproape.
Aceeaşi legare prin stradă şi aceeaşi acoperire de ~71% ca la /firme/aproape; totalul e al firmelor găsibile, nu al tuturor celor din zonă.
Denumirile CAEN se rezolvă pe reviziile în care codurile chiar există — datele ANAF amestecă Rev.2, Rev.3 şi coduri vechi de Rev.1.

La ce folosește

Fişa economică a unui cartier sau a unei zone comerciale, într-un singur apel.
Compararea a două amplasamente după densitatea şi profilul firmelor din jur.
Un widget de context în aplicaţii imobiliare: ce se întâmplă economic în jurul adresei.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

centru.lat number Latitudinea punctului cerut (ecou).

centru.lng number Longitudinea punctului cerut (ecou).

raza_km number Raza folosită, în km.

stare string | null

total integer Câte firme găsibile sunt în cerc (vezi acoperirea de ~71%).

pe_categorie[].categorie string Categoria din clasificarea sursei.

pe_categorie[].nr integer Numărul de elemente din grupa asta.

top_caen[].cod string Codul CAEN al sectorului.

top_caen[].denumire string | null Denumirea sectorului, din revizia în care codul există.

top_caen[].nr integer Câte firme din zonă au acest CAEN principal.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/zona?lat=46.77&lng=23.59&raza_km=1

{
    "data": {
        "centru": {
            "lat": 46.77,
            "lng": 23.59
        },
        "raza_km": 1,
        "stare": null,
        "total": 9945,
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 4683
            }
        ],
        "top_caen": [
            {
                "cod": "6831",
                "denumire": "Agenții imobiliare",
                "nr": 381
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/zona?lat=44.43&lng=26.10&raza_km=1&stare=activa

{
    "data": {
        "centru": {
            "lat": 44.43,
            "lng": 26.1
        },
        "raza_km": 1,
        "stare": "activa",
        "total": 10077,
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 12206
            }
        ],
        "top_caen": [
            {
                "cod": "6820",
                "denumire": "Închirierea și subînchirierea bunurilor imobiliare proprii sau închiriate",
                "nr": 327
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/zona?lat=47.17&lng=27.57&raza_km=2

{
    "data": {
        "centru": {
            "lat": 47.17,
            "lng": 27.57
        },
        "raza_km": 2,
        "stare": null,
        "total": 32650,
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 17964
            }
        ],
        "top_caen": [
            {
                "cod": "4711",
                "denumire": "Comerț cu amănuntul în magazine nespecializate, cu vânzare predominantă de produse alimentare, băuturi și tutun",
                "nr": 908
            }
        ]
    }
}

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	validare	Un parametru nedeclarat ori o valoare care nu trece validarea (`lat`, `lng`, `raza_km`). Câmpul vinovat e în `detalii`.
422	parametri_invalizi	Parametrii `lat` și `lng` sunt obligatorii.
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 nedeclarat ori o valoare care nu trece validarea (lat, lng, raza_km). Câmpul vinovat e în detalii.",
        "detalii": {
            "lat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}