oneapi
Autentificare
Mediu v1 / Mediu

Cutremurele din jurul unui loc

Punctul se dă fie ca siruta (rezolvat prin modulul Locations), fie ca lat + lng.

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

Parametri de interogare

NumeTipDescriereValori acceptate
raza_kmopțional number | null Raza de căutare, în kilometri. Implicit 50, maximum 1000. 1 – 1000
magnitudine_minopțional number | null Doar evenimentele peste această magnitudine. 0 – 10
limitaopțional integer | null Câte evenimente să întoarcă, maximum 500. Implicit 50. 1 – 500
sortareopțional string | null distanta (implicit), magnitudine — cele mai puternice primele — ori recente. distantamagnitudinerecente
latopțional number | null Latitudinea punctului. Cere lng. 41 – 50
lngopțional number | null Longitudinea punctului. Cere lat. 19 – 32
sirutaopțional integer | null Codul SIRUTA al localității sau UAT-ului. Alternativă la lat + lng. 1

Cum se comportă

  • Punctul se dă fie ca siruta, fie ca lat + lng — nu amândouă. Codul SIRUTA se rezolvă prin modulul Locations.
  • Când SIRUTA e al unei localități, punctul e chiar localitatea. Când e al unui UAT, punctul e centroidul UAT-ului, care într-o comună întinsă poate cădea la zeci de kilometri de sat — răspunsul spune care dintre cele două a fost folosit, în punct.nivel.
  • Distanța e calculată pe elipsoid, în kilometri reali. La latitudinea României un grad de longitudine are ~70 km și unul de latitudine ~111 km, deci o rază calculată în grade ar fi o elipsă.
  • Cele mai mari cutremure din jurul unei localități — pagina pe care o caută oricine își cumpără o casă — se cer cu sortare=magnitudine: cele mai puternice primele, la egalitate cel mai apropiat. Evenimentele din catalogul vechi fără magnitudine ajung la coadă. sortare=recente pune cel mai nou eveniment primul; implicit ordinea e după distanță.
  • Numerele sunt evenimente înregistrate, nu evenimente produse. Catalogul are 1 eveniment în secolul X și peste 33.000 în secolul XXI — diferența e instrumentație, nu seismicitate. Sub magnitudinea 3 devine complet abia din anii 1980, odată cu rețeaua seismică modernă. Nu compara numărătorile între epoci.

La ce folosește

  • Arăți istoricul seismic din jurul unei adrese într-o aplicație imobiliară sau de asigurări.
  • Documentezi într-o expertiză ce evenimente s-au înregistrat în apropierea unui amplasament.
  • Compari două localități după cutremurele înregistrate în jurul lor.

Structura răspunsului

CâmpTipDescriere
data.punct object Punctul folosit, cu sursa lui: coordonate date direct sau deduse dintr-un cod SIRUTA.
data.punct.lat number Latitudinea efectiv folosită.
data.punct.lng number Longitudinea efectiv folosită.
data.punct.sursa string siruta sau coordonate.
data.punct.cod_siruta integer Codul rezolvat, când s-a dat siruta.
data.punct.nume string Denumirea entității rezolvate.
data.punct.nivel string localitate (punct precis) sau uat_centroid (centrul unei suprafețe).
data.raza_km number Raza aplicată.
data.sortare string distanta | magnitudine | recente.
data.inregistrari integer Câte evenimente conține răspunsul.
data.evenimente[].distanta_km number Distanța de la punct până la epicentru, în kilometri.
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.observatie string Avertismentul de completitudine a catalogului.
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.distanta object Cum sunt măsurate distanţele din răspuns. Apare pe orice răspuns care conţine o distanţă.
meta.distanta.metoda string Mereu linie_dreapta: distanţa geodezică pe suprafaţa Pământului, nu pe drum.
meta.distanta.detaliu string Aceeaşi informaţie, în cuvinte.

Exemple de răspuns

GEThttps://oneapi.ro/api/mediu/v1/seism/langa?siruta=54984&raza_km=100&magnitudine_min=3
{
    "data": {
        "punct": {
            "lat": 46.78,
            "lng": 23.559444444444,
            "sursa": "siruta",
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca",
            "nivel": "localitate"
        },
        "raza_km": 100,
        "sortare": "distanta",
        "inregistrari": 14,
        "evenimente": [
            {
                "cod": "16030505T000000",
                "data_ora": "1603-05-05 01: 44: 24+01: 44: 24",
                "an": 1603,
                "latitudine": 46.8,
                "longitudine": 23.6,
                "adancime_km": 9.9,
                "adancime_fixata": true,
                "magnitudine": 4.7,
                "tip_magnitudine": "Mw",
                "magnitudini": {
                    "Mw": 4.7
                },
                "solutie": {
                    "calitate": "D"
                },
                "distanta_km": 3.8
            }
        ],
        "observatie": "Numerele sunt evenimente ÎNREGISTRATE, nu evenimente produse. Catalogul are 1 eveniment în secolul X și peste 33.000 în secolul XXI — diferența e instrumentație, nu seismicitate. Sub magnitudinea 3, catalogul devine complet abia din anii 1980, odată cu rețeaua seismică modernă. Nu compara numărătorile între epoci.",
        "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": {
        "distanta": {
            "metoda": "linie_dreapta",
            "detaliu": "Distanţele sunt geodezice, în linie dreaptă pe suprafaţa Pământului (WGS84) — nu pe drum."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitCodul SIRUTA nu a putut fi rezolvat la o coordonată.
422validareNiciun punct dat, ambele forme date deodată, sau o coordonată fără perechea ei.
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": "Niciun punct dat, ambele forme date deodată, sau o coordonată fără perechea ei.",
        "detalii": {
            "raza_km": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}