Mediu v1 / Mediu

Un cutremur anume

Codul e momentul originii, compactat: 19770304T192154.

GET

https://oneapi.ro/api/mediu/v1/seism/{cod}

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul evenimentului seismic din catalogul ROMPLUS (ex. 19770304T192154).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Codul e momentul originii, compactat: cutremurul din 4 martie 1977 e 19770304T192154. Catalogul nu are identificatori proprii, iar momentul e unic în practică — la import, un singur eveniment din 39.597 a împărțit secunda cu altul.
Ruta acceptă doar formatul exact AAAALLZZTHHMMSS; orice altceva nu se potrivește pe rută.

La ce folosește

Adânceşti un eveniment găsit într-o listă, cu toate magnitudinile și incertitudinile soluției.
Pui într-un raport un link stabil către un cutremur anume.

Structura răspunsului

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

CâmpTipDescriere

eveniment.cod string Cheia publică a evenimentului: momentul originii compactat, AAAALLZZTHHMMSS.

eveniment.data_ora string Momentul originii, în UTC. La evenimentele istorice ora poate fi o convenție (00:00:00), nu o observație.

eveniment.an integer Anul, util la filtrare și grupare.

eveniment.latitudine number Latitudinea epicentrului (WGS84).

eveniment.longitudine number Longitudinea epicentrului (WGS84).

eveniment.adancime_km number Adâncimea focarului, în kilometri. null când sursa nu a determinat-o.

eveniment.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ă.

eveniment.magnitudine number Magnitudinea de lucru: Mw dacă există, altfel ML, altfel MD. null la 339 de evenimente.

eveniment.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ă.

eveniment.magnitudini object Toate magnitudinile determinate, pe scări, fiecare cu eroarea ei.

eveniment.magnitudini.Mw number Magnitudinea moment, dacă e determinată.

eveniment.magnitudini.Mw_eroare number Incertitudinea Mw.

eveniment.magnitudini.ML number Magnitudinea locală (Richter), dacă e determinată.

eveniment.magnitudini.ML_eroare number Incertitudinea ML.

eveniment.magnitudini.MD number Magnitudinea de durată, dacă e determinată.

eveniment.magnitudini.MD_eroare number Incertitudinea MD.

eveniment.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.

eveniment.solutie.eroare_orizontala_km number Eroarea orizontală a localizării.

eveniment.solutie.rms number Reziduul RMS al soluției.

eveniment.solutie.elipsa_smaj_km number Semiaxa mare a elipsei de eroare.

eveniment.solutie.elipsa_smin_km number Semiaxa mică a elipsei de eroare.

eveniment.solutie.elipsa_azimut integer Azimutul elipsei de eroare, în grade.

eveniment.solutie.nr_faze integer Câte faze seismice au intrat în soluție.

eveniment.solutie.nr_statii integer Câte stații au contribuit.

eveniment.solutie.nr_magnitudini integer Câte determinări de magnitudine s-au mediat.

eveniment.solutie.gap_azimutal integer Cel mai mare unghi fără stații, în grade. Peste ~180° localizarea e slab constrânsă.

eveniment.solutie.calitate string Clasa de calitate a soluției, A–D, așa cum o atribuie INFP.

sursa object Catalogul ROMPLUS al Institutului Național de Cercetare-Dezvoltare pentru Fizica Pământului, cu licența lui.

sursa.nume string Catalogul și instituția care îl publică.

sursa.url string Pagina oficială a catalogului.

sursa.licenta string Temeiul reutilizării.

Exemple de răspuns

GEThttps://oneapi.ro/api/mediu/v1/seism/18021026T105500

{
    "data": {
        "eveniment": {
            "cod": "18021026T105500",
            "data_ora": "1802-10-26 12: 39: 24+01: 44: 24",
            "an": 1802,
            "latitudine": 45.7,
            "longitudine": 26.6,
            "adancime_km": 150,
            "adancime_fixata": false,
            "magnitudine": 7.9,
            "tip_magnitudine": "Mw",
            "magnitudini": {
                "Mw": 7.9
            },
            "solutie": {
                "calitate": "D"
            }
        },
        "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."
        }
    }
}

GEThttps://oneapi.ro/api/mediu/v1/seism/19401110T013907

{
    "data": {
        "eveniment": {
            "cod": "19401110T013907",
            "data_ora": "1940-11-10 03: 39: 07+02",
            "an": 1940,
            "latitudine": 45.8,
            "longitudine": 26.7,
            "adancime_km": 150,
            "adancime_fixata": false,
            "magnitudine": 7.7,
            "tip_magnitudine": "Mw",
            "magnitudini": {
                "Mw": 7.7
            },
            "solutie": {
                "calitate": "C"
            }
        },
        "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."
        }
    }
}

GEThttps://oneapi.ro/api/mediu/v1/seism/17380611T100000

{
    "data": {
        "eveniment": {
            "cod": "17380611T100000",
            "data_ora": "1738-06-11 11: 44: 24+01: 44: 24",
            "an": 1738,
            "latitudine": 45.7,
            "longitudine": 26.6,
            "adancime_km": 130,
            "adancime_fixata": false,
            "magnitudine": 7.7,
            "tip_magnitudine": "Mw",
            "magnitudini": {
                "Mw": 7.7
            },
            "solutie": {
                "calitate": "D"
            }
        },
        "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."
        }
    }
}

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.
404	negasit	Nu există un eveniment cu acest cod în catalog.
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": "negasit",
        "mesaj": "Nu există un eveniment cu acest cod în catalog."
    }
}