oneapi
Autentificare
Mediu v1 / Mediu

O stație de monitorizare

Detaliile stației, instrumentele ei și ultima valoare măsurată pentru fiecare poluant.

GET
https://oneapi.ro/api/mediu/v1/aer/statii/{cod}

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul staţiei din reţeaua naţională de monitorizare a calităţii aerului (ex. RO0073A).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • date spune ce avem NOI, nu ce spune catalogul. Câmpurile activa, prima_observatie şi ultima_observatie descriu staţia aşa cum o publică EEA — şi nu coincid cu acoperirea noastră. 10 din cele 187 de staţii n-au nicio măsurătoare importată, deşi apar activa: true cu o primă observaţie din 2008; iar ultima_observatie e null pe 186 din 187, fiindcă sursa lasă capătul deschis la staţiile în funcţiune. Ramura date — are, zile, prima_zi, ultima_zi, poluanti — e calculată din măsurătorile noastre. Verific-o înainte de a cere serii pentru o staţie.
  • Un punct de prelevare e un INSTRUMENT care măsoară un singur poluant. O stație are mai multe, iar sursa raportează măsurătorile per instrument, nu per stație — de aceea le vezi separat.
  • ultimele_valori conține cea mai recentă valoare orară din fereastra importată, per poluant. Fiecare poartă vechime_ore și invechita — o valoare de acum trei zile e tot ce are sursa pentru stația aia, dar nu descrie prezentul.
  • Ruta acceptă doar coduri EoI (două litere, patru cifre, o literă): RO0073A.

La ce folosește

  • Vezi ce măsoară concret o stație și cu ce metodă.
  • Iei ultima valoare pentru fiecare poluant al unei stații, într-un singur apel.

Structura răspunsului

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

CâmpTipDescriere
statie object Aceleași câmpuri ca un element din data.statii[] la /aer/statii.
puncte_de_prelevare[].cod string Codul instrumentului (SPO-…).
puncte_de_prelevare[].poluant string Poluantul măsurat.
puncte_de_prelevare[].metoda string Tipul măsurătorii (de regulă automatic).
puncte_de_prelevare[].prima_observatie string De când măsoară.
puncte_de_prelevare[].ultima_observatie string Până când. null = încă activ.
puncte_de_prelevare[].activ boolean Dacă instrumentul e în funcțiune.
ultimele_valori[].poluant string Poluantul.
ultimele_valori[].valoare number Ultima valoare orară.
ultimele_valori[].unitate string Unitatea de măsură.
ultimele_valori[].ora string Ora la care a fost măsurată.
ultimele_valori[].vechime_ore integer De câte ore e valoarea asta cea mai recentă.
ultimele_valori[].invechita boolean true peste 6 ore vechime — nu o prezenta ca „acum".
ultimele_valori[].referinta_legala.prag number Pragul legal pentru poluant.
ultimele_valori[].referinta_legala.se_aplica_la string La ce se aplică pragul: media, maxim sau maxim_8h.
ultimele_valori[].referinta_legala.observatie string De ce nu poți compara direct valoarea izolată cu pragul.
observatie string Avertismentul despre reprezentativitate și date neverificate.
sursa object Sursa și licența.
statie.cod string Codul european al stației.
statie.cod_national string Codul folosit de rețeaua națională.
statie.latitudine number Latitudinea stației.
statie.longitudine number Longitudinea stației.
statie.altitudine integer Altitudinea, în metri.
statie.tip string Tipul stației: trafic, industrial, fond. Contează la comparații: o stație de trafic nu se compară cu una de fond.
statie.zona string Zona: urbană, suburbană, rurală.
statie.localitate object Localitatea în care cade stația, legată la nomenclatorul Locations.
statie.judet string Județul.
statie.judet_cod string Indicativul auto al județului.
statie.prima_observatie string De când există date pentru stație.
statie.ultima_observatie null Ultima zi cu date. null înseamnă că stația n-are serie zilnică agregată.
statie.activa boolean Dacă stația mai raportează.
statie.poluanti Poluanții măsurați de stație.

Exemple de răspuns

GEThttps://oneapi.ro/api/mediu/v1/aer/statii/RO0008R
{
    "data": {
        "statie": {
            "cod": "RO0008R",
            "cod_national": "RO-EM-3",
            "latitudine": 47.324686,
            "longitudine": 25.134839,
            "altitudine": 912,
            "tip": "background",
            "zona": "rural",
            "localitate": {
                "cod_siruta": 149851,
                "nume": "Poiana Stampei"
            },
            "judet": "Suceava",
            "judet_cod": "SV",
            "prima_observatie": "2010-01-01",
            "ultima_observatie": null,
            "activa": true,
            "date": {
                "are": true,
                "zile": 326,
                "prima_zi": "2026-07-01",
                "ultima_zi": "2026-09-22",
                "poluanti": [
                    "CO",
                    "NO2",
                    "O3",
                    "SO2"
                ]
            }
        },
        "puncte_de_prelevare": [
            {
                "cod": "SPO-RO0008R_00010_100",
                "poluant": "CO",
                "metoda": "automatic",
                "prima_observatie": "2010-01-01",
                "ultima_observatie": null,
                "activ": true
            }
        ],
        "ultimele_valori": [
            {
                "poluant": "CO",
                "valoare": 0.067,
                "unitate": "mg/m³",
                "ora": "2026-09-22 09: 00: 00+03",
                "vechime_ore": 351,
                "invechita": true,
                "referinta_legala": {
                    "prag": 10,
                    "se_aplica_la": "maxim_8h",
                    "observatie": "Pragul se aplică maximului mediilor pe 8 ore, nu acestei valori izolate — decât dacă e chiar o valoare orară."
                }
            }
        ],
        "observatie": "Valorile sunt măsurate la STAȚIE, nu în localitate: la câțiva kilometri, sau lângă o arteră aglomerată, pot fi complet diferite. Datele din fereastra curentă sunt NEVERIFICATE — operatorul le poate corecta sau invalida ulterior. Mediile zilnice se publică doar când ziua are cel puțin 18 ore valide; `ore_valide` spune întotdeauna pe ce se sprijină cifra. O zi cu `masurare: zilnica` e o probă de laborator pe 24 de ore (PM10/PM2,5 gravimetric): media e chiar proba, fără minim, maxim ori ore.",
        "sursa": {
            "nume": "European Environment Agency — Air Quality Download Service (date raportate de România prin RNMCA/ANPM)",
            "url": "https://eeadmz1-downloads-webapp.azurewebsites.net/",
            "licenta": "Politica de reutilizare a EEA — reutilizare permisă cu indicarea sursei."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există o stație cu acest cod.
429cota_depasitaCota 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": "negasit",
        "mesaj": "Nu există o stație cu acest cod."
    }
}