oneapi
Autentificare
Mediu v1 / Mediu

Căutare în catalog

Filtre pe interval, magnitudine, adâncime, calitatea soluției și, opțional, o rază geografică.

GET
https://oneapi.ro/api/mediu/v1/seism/cauta

Parametri de interogare

NumeTipDescriereValori acceptate
de_laopțional string | null Prima dată inclusă, AAAA-LL-ZZ. ex. 1977-01-01
pana_laopțional string | null Ultima dată inclusă, AAAA-LL-ZZ. ex. 1977-12-31
magnitudine_minopțional number | null Magnitudinea minimă. 0 – 10
magnitudine_maxopțional number | null Magnitudinea maximă. 0 – 10
adancime_minopțional number | null Adâncimea minimă, în kilometri. 0 – 1000
adancime_maxopțional number | null Adâncimea maximă, în kilometri. 0 – 1000
calitateopțional string | null Clasa soluției: A, B, C sau D. ABCD
raza_kmopțional number | null Raza filtrului geografic, în kilometri. Cere un centru: ori lat+lng, ori siruta. 1 – 1000
latopțional number | null Latitudinea centrului filtrului geografic. Cere lng și raza_km. 41 – 50
lngopțional number | null Longitudinea centrului. Cere lat și raza_km. 19 – 32
sirutaopțional integer | null Codul SIRUTA al unei localități sau al unui UAT, ca centru al filtrului geografic — alternativă la lat+lng. Se rezolvă la fel ca la /seism/langa: punctul localității, iar în lipsa lui centroidul UAT-ului. Un cod care nu se rezolvă întoarce eroare, nu toată țara. 1
per_paginaopțional text Câte evenimente pe pagină, maximum 500. Implicit 50. ex. 100
paginaopțional text Pagina, numărată de la 1. ex. 1

Cum se comportă

  • Adâncimea separă două regimuri seismice distincte în România: cutremurele crustale (sub 30 km), locale și cu efecte concentrate, și cele vrâncene de adâncime intermediară (70–200 km), care se resimt pe suprafețe uriașe. Un filtru pe adâncime nu e un detaliu tehnic — separă două fenomene.
  • Filtrul geografic e opțional, dar cere un centru ȘI o rază. Centrul se dă în două feluri: lat+lng sau siruta. O rază fără centru, un centru fără rază ori un cod SIRUTA care nu se rezolvă întorc 422, nu un rezultat aparent filtrat.
  • Filtrele de magnitudine și adâncime exclud evenimentele la care valoarea nu e determinată — 339 fără magnitudine, 3.453 fără adâncime.
  • Paginarea e prin pagina și per_pagina; meta.paginare.total spune câte evenimente satisfac filtrele, independent de pagină.

La ce folosește

  • Extragi toate evenimentele dintr-un interval pentru un studiu sau un raport, cu paginare.
  • Izolezi cutremurele crustale de cele de adâncime intermediară, care în România se comportă complet diferit.
  • Filtrezi pe calitatea soluției când ai nevoie doar de localizări bine constrânse.

Structura răspunsului

CâmpTipDescriere
data.evenimente[].cod string Cheia publică a evenimentului: momentul originii compactat, AAAALLZZTHHMMSS.
data.evenimente[].data_ora string Momentul originii, în UTC. La evenimentele istorice ora poate fi o convenție (00:00:00), nu o observație.
data.evenimente[].an integer Anul, util la filtrare și grupare.
data.evenimente[].latitudine number Latitudinea epicentrului (WGS84).
data.evenimente[].longitudine number Longitudinea epicentrului (WGS84).
data.evenimente[].adancime_km number Adâncimea focarului, în kilometri. null când sursa nu a determinat-o.
data.evenimente[].adancime_fixata boolean true dacă adâncimea a fost FIXATĂ de analist, nu determinată din date. Sunt 6.839 de astfel de evenimente — tratează-le altfel într-o analiză.
data.evenimente[].magnitudine number Magnitudinea de lucru: Mw dacă există, altfel ML, altfel MD. null la 339 de evenimente.
data.evenimente[].tip_magnitudine string Scara din care provine magnitudine: Mw, ML sau MD. Nu compara valori între scări diferite fără s-o iei în seamă.
data.evenimente[].magnitudini object Toate magnitudinile determinate, pe scări, fiecare cu eroarea ei.
data.evenimente[].magnitudini.Mw number Magnitudinea moment, dacă e determinată.
data.evenimente[].magnitudini.Mw_eroare number Incertitudinea Mw.
data.evenimente[].magnitudini.ML number Magnitudinea locală (Richter), dacă e determinată.
data.evenimente[].magnitudini.ML_eroare number Incertitudinea ML.
data.evenimente[].magnitudini.MD number Magnitudinea de durată, dacă e determinată.
data.evenimente[].magnitudini.MD_eroare number Incertitudinea MD.
data.evenimente[].solutie object Calitatea localizării: eroarea orizontală, RMS-ul, elipsa de eroare, numărul de faze și de stații, lacuna azimutală și clasa de calitate.
data.evenimente[].solutie.eroare_orizontala_km number Eroarea orizontală a localizării.
data.evenimente[].solutie.rms number Reziduul RMS al soluției.
data.evenimente[].solutie.elipsa_smaj_km number Semiaxa mare a elipsei de eroare.
data.evenimente[].solutie.elipsa_smin_km number Semiaxa mică a elipsei de eroare.
data.evenimente[].solutie.elipsa_azimut integer Azimutul elipsei de eroare, în grade.
data.evenimente[].solutie.nr_faze integer Câte faze seismice au intrat în soluție.
data.evenimente[].solutie.nr_statii integer Câte stații au contribuit.
data.evenimente[].solutie.nr_magnitudini integer Câte determinări de magnitudine s-au mediat.
data.evenimente[].solutie.gap_azimutal integer Cel mai mare unghi fără stații, în grade. Peste ~180° localizarea e slab constrânsă.
data.evenimente[].solutie.calitate string Clasa de calitate a soluției, A–D, așa cum o atribuie INFP.
data.sursa object Catalogul ROMPLUS al Institutului Național de Cercetare-Dezvoltare pentru Fizica Pământului, cu licența lui.
data.sursa.nume string Catalogul și instituția care îl publică.
data.sursa.url string Pagina oficială a catalogului.
data.sursa.licenta string Temeiul reutilizării.
meta.paginare.pagina integer Pagina curentă, numărată de la 1.
meta.paginare.per_pagina integer Câte înregistrări are o pagină.
meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.
meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/mediu/v1/seism/cauta?de_la=1977-01-01&pana_la=1977-12-31&magnitudine_min=5
{
    "data": {
        "evenimente": [
            {
                "cod": "19770304T192154",
                "data_ora": "1977-03-04 21: 21: 54+02",
                "an": 1977,
                "latitudine": 45.77,
                "longitudine": 26.76,
                "adancime_km": 94,
                "adancime_fixata": false,
                "magnitudine": 7.4,
                "tip_magnitudine": "Mw",
                "magnitudini": {
                    "Mw": 7.4
                },
                "solutie": {
                    "calitate": "B"
                }
            }
        ],
        "sursa": {
            "nume": "Catalogul ROMPLUS — Institutul Naţional de Cercetare-Dezvoltare pentru Fizica Pământului (INCDFP)",
            "url": "https://www.infp.ro/index.php?i=romplus",
            "licenta": "Date de sector public, reutilizabile conform Legii 109/2007, cu indicarea sursei."
        }
    },
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 50,
            "total": 1,
            "pagini": 1
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareRază fără coordonate, coordonate fără rază, clasă de calitate necunoscută, sau valori în afara intervalelor.
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": "validare",
        "mesaj": "Rază fără coordonate, coordonate fără rază, clasă de calitate necunoscută, sau valori în afara intervalelor.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}