Locations v1 / Meteo

Acoperire meteo

Cât de departe merge stratul meteo: câte staţii avem, câte au date, de când şi până când. De citit înainte de a cere o serie pe un interval lung.

GET

https://oneapi.ro/api/locations/v1/meteo/acoperire

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Acoperirea NU e uniformă: unele stații au serii de peste un secol, altele câteva decenii. primul_an de aici e cel mai vechi din toată rețeaua, nu al fiecărei stații — pe cel al stației îl vezi în /meteo/statii.
Ruta e gratuită, ca orice rută de acoperire din platformă: trebuie să poți afla ce conține stratul înainte de a plăti pentru el.

La ce folosește

Verifici, înainte de a integra, cât de departe merge seria și câte stații au date.
Afișezi într-o pagină de stare cât de complet e stratul meteo.

Structura răspunsului

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

CâmpTipDescriere

statii integer Câte stații are rețeaua importată.

statii_cu_date integer Câte dintre ele au efectiv serie zilnică.

statii_fara_pozitie integer Câte stații au serie dar n-au coordonate (fără fișă de catalog la sursă). Se interoghează prin ?statie=<wsi>; nu apar în rutele geografice.

legate_la_uat integer Câte stații au putut fi legate spațial la un UAT.

judete_acoperite integer Câte județe au cel puțin o stație.

primul_an integer Cel mai vechi an cu măsurători din toată rețeaua.

ultimul_an integer Cel mai recent an cu măsurători.

zile_masurate integer Numărul total de zile-stație importate.

observatie string Precizare despre cum se citeşte răspunsul: o convenţie de calcul sau o limită a datelor.

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/acoperire

{
    "data": {
        "statii": 160,
        "statii_cu_date": 160,
        "statii_fara_pozitie": 20,
        "legate_la_uat": 139,
        "judete_acoperite": 41,
        "primul_an": 1871,
        "ultimul_an": 2026,
        "zile_masurate": 5247825,
        "observatie": "Acoperirea NU e uniformă: unele stații au serii de peste un secol, altele câteva decenii. Verifică `primul_an` al stației înainte de a cere un interval. `statii_fara_pozitie` sunt stații pentru care portalul publică serie dar nu și coordonate — se pot interoga prin `?statie=<wsi>`, dar nu apar în căutările geografice.",
        "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

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	modul_interzis	Tokenul nu are acces la modulul rutei.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}