oneapi
Autentificare
Locations v1 / Meteo

Detaliu stație meteo

O staţie întreagă: identificatorul WSI, poziţia, de când are date, câte zile şi ce parametri. Identificatorul se foloseşte apoi în seriile zilnice şi în normale.

GET
https://oneapi.ro/api/locations/v1/meteo/statii/{wsi}

Parametri de cale

NumeTipDescriereExemplu
wsiobligatoriu string Identificatorul WIGOS al staţiei meteo (ex. 0-20000-0-15208).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Codul e WSI (WIGOS Station Identifier), forma folosită de ANM. Nu inventa coduri: lista completă e la /locations/v1/meteo/statii.

La ce folosește

  • Verifici întinderea seriei unei stații înainte de a cere un interval lung de date.
  • Afli în ce UAT și județ cade o stație pe care ai primit-o ca referință în alt răspuns.

Structura răspunsului

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

CâmpTipDescriere
statie.wsi string Identificatorul OMM al stației.
statie.nume string Denumirea stației. null la stațiile fără fișă de catalog.
statie.latitudine number Latitudinea, în grade zecimale (WGS 84).
statie.longitudine number Longitudinea, în grade zecimale (WGS 84).
statie.fara_catalog boolean true dacă stația are serie dar nu și fișă de catalog (fără nume, fără coordonate, invizibilă în căutările geografice).
statie.localitate object UAT-ul în care cade stația ({cod_siruta, nume}); null dacă e în afara oricărui UAT.
statie.localitate.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
statie.localitate.nume string Numele, aşa cum îl publică sursa.
statie.judet string Judeţul la care se referă valoarea.
statie.judet_cod string Codul judeţului, două litere.
statie.primul_an integer Primul an cu măsurători.
statie.ultimul_an integer Ultimul an cu măsurători.
statie.zile_cu_date integer Câte zile măsurate are stația în total.
statie.parametri array Codurile parametrilor publicați: ta/tn/tx temperaturi, r precipitații, ff vânt, p presiune la nivelul mării.
sursa object Sursa datelor: Administrația Națională de Meteorologie, seria zilnică oficială, licență CC-BY-4.0. Conține și data ultimei importări.
sursa.nume string Denumirea sursei oficiale.
sursa.url string Adresa publică a sursei.
sursa.licenta string Licenţa sub care sursa permite reutilizarea.

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/meteo/statii/0-20000-0-15208
{
    "data": {
        "statie": {
            "wsi": "0-20000-0-15208",
            "nume": "Alba Iulia",
            "latitudine": 46.063911,
            "longitudine": 23.563402,
            "fara_catalog": false,
            "localitate": {
                "cod_siruta": 1017,
                "nume": "Alba Iulia"
            },
            "judet": "Alba",
            "judet_cod": "AB",
            "primul_an": 1881,
            "ultimul_an": 2026,
            "zile_cu_date": 43155,
            "parametri": [
                "ff",
                "p",
                "r",
                "ta",
                "tn",
                "tx"
            ]
        },
        "sursa": {
            "nume": "Administrația Națională de Meteorologie (ANM) — date climatologice zilnice, controlate calitativ",
            "url": "https://odp.meteoromania.ro/",
            "licenta": "CC BY 4.0, 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ă stație cu codul WSI dat.
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ă stație cu codul WSI dat."
    }
}