İçeriğe atla
GET/api/hazard/earthquake/1 kredi

Deprem olayları

ABD Jeolojik Araştırmalar Kurumu'nun (USGS) FDSN deprem olayı hizmetine doğrudan aktarım yapan bir proxy. Bu, astrolojik bir hesaplama değil, tarihsel ve neredeyse gerçek zamanlı bir sismoloji veri setidir; mundan astroloji ve olay korelasyonu çalışmalarında olaylar ile harita verilerinin tek bir API üzerinden alınabilmesi için sunulur. Tüm sorgu parametreleri USGS'ye değiştirilmeden iletilir; bu yüzden FDSN parametrelerinin tamamı kullanılabilir: ISO 8601 biçiminde `starttime` ve `endtime` (varsayılan: son otuz gün), `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` ile sınırlayıcı kutu ya da `latitude`/`longitude` ile birlikte `maxradius` veya `maxradiuskm` kullanılarak daire, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, PAGER `alertlevel`, `eventtype`, `reviewstatus`, en fazla 20000 olabilen `limit`, `offset` ve `orderby`. Yanıt, USGS'nin döndürdüğü GeoJSON FeatureCollection'ın aynısıdır: sonuç sayısını (`count`) içeren bir `metadata` nesnesi ve bir `features` listesi. Listedeki her girişte [boylam, enlem, km cinsinden derinlik] veren bir `geometry` ile büyüklük, yer açıklaması, epok milisaniyesi cinsinden `time`, hissedilme bildirimleri, Mercalli ve Topluluk şiddeti, önem derecesi, tsunami bayrağı ve USGS olay sayfası URL'sini içeren bir `properties` nesnesi bulunur. `format` parametresi yok sayılır ve her zaman geojson kullanılır. USGS'ye ulaşılamazsa endpoint 503 döndürür.

https://api.occultapi.com/api/hazard/earthquake/
İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

X-API-Key: yt_live_a1b2c3d4_…

Sorgu parametreleri (42)

URL'de gönderilir. Aksi belirtilmedikçe hepsi isteğe bağlıdır ve birlikte kullanılabilir: önce filtreleme, sonra sayfalama, en son sıralama uygulanır.

ParametreTürÖrnekNe işe yarar
alertlevelstringgreenBelirli bir PAGER uyarı seviyesine sahip olaylarla sınırlarşunlardan biri: green, orange, red, yellow
catalogstring—Belirli bir katalogdaki olaylarla sınırlar
contributorstring—Belirli bir katkı verenin sağladığı olaylarla sınırlar
endtimestring2024-12-31Zaman aralığının sonu (ISO8601). Varsayılan: şu an

ISO tarihi veya tarih-saat. Bu değer dahildir.

eventidstring—Belirli bir olayı kimliğiyle seçer (includeallorigins ve includeallmagnitudes otomatik olarak uygulanır)

SERBEST BİÇİMLİ USGS olay kimliği (ör. 'us7000abcd'. Bir kimlik seçildiğinde includeallorigins ve includeallmagnitudes otomatik olarak uygulanır. Olduğu gibi aktarılır.

eventtypestring—Belirli türdeki olaylarla sınırlar (ör. 'earthquake' deprem dışındaki olayları eler)
includeallmagnitudesboolean—Her olay için tüm büyüklükleri dahil eder (varsayılan: false)
includealloriginsboolean—Her olay için tüm kaynakları dahil eder (varsayılan: false)
includearrivalsboolean—Faz varışlarını dahil eder (varsayılan: false, ŞU ANDA UYGULANMIYOR)
includedeletedstring—Silinmiş olayları dahil eder (varsayılan: false). Yalnızca silinmiş olayları döndürmek için 'only' kullanın

Endpoint'in kendi parametre açıklaması bunu boolean artı 'only' olarak tanımlar ("Silinmiş olayları dahil eder (varsayılan: false). Yalnızca silinmiş olayları döndürmek için 'only' kullanın". Yerel bir kontrol yoktur - değer USGS'ye aktarılır ve doğrulamayı USGS yapar.

şunlardan biri: true, false, only
includesupersededboolean—Yerini yenisine bırakmış ürünleri dahil eder (varsayılan: false). Yalnızca eventid ile çalışır
latitudenumber26.9124Daire araması için merkez enlem [-90, 90]. longitude ve maxradius/maxradiuskm gerektirir

Dairesel aramanın merkezi; longitude ve maxradiuskm ile birlikte kullanılır.

limitinteger20Döndürülecek en fazla olay sayısı [1, 20000]

Sayfa başına döndürülecek kayıt sayısı.

longitudenumber75.7873Daire araması için merkez boylam [-180, 180]
maxalertlevelstringgreenPAGER uyarı seviyesi ≤ bu değer olan olaylarla sınırlarşunlardan biri: green, orange, red, yellow
maxcdinumber—Maksimum Topluluk Tarafından Belirlenen Şiddet (DYFI) [0, 12]
maxdepthnumber—Maksimum derinlik, km cinsinden [-100, 1000]
maxgapnumber—Maksimum azimut boşluğu, derece cinsinden [0, 360]
maxlatitudenumber—Sınırlayıcı kutunun kuzey sınırı [-90, 90]
maxlongitudenumber—Sınırlayıcı kutunun doğu sınırı [-360, 360]
maxmagnitudenumber9Maksimum büyüklük
maxmminumber—Maksimum Değiştirilmiş Mercalli Şiddeti (ShakeMap) [0, 12]
maxradiusnumber—Merkez noktadan derece cinsinden maksimum yarıçap [0, 180]. maxradiuskm ile birlikte kullanılamaz
maxradiuskmnumber500Merkez noktadan km cinsinden maksimum yarıçap [0, 20001.6]. maxradius ile birlikte kullanılamaz

latitude/longitude çevresinde kilometre cinsinden arama yarıçapı.

maxsiginteger—Maksimum önem derecesi
minalertlevelstringgreenPAGER uyarı seviyesi ≥ bu değer olan olaylarla sınırlarşunlardan biri: green, orange, red, yellow
mincdinumber—Minimum Topluluk Tarafından Belirlenen Şiddet (DYFI)
mindepthnumber—Minimum derinlik, km cinsinden [-100, 1000]
minfeltinteger—Minimum DYFI yanıt sayısı [1, ∞]
mingapnumber—Minimum azimut boşluğu, derece cinsinden [0, 360]
minlatitudenumber—Sınırlayıcı kutunun güney sınırı [-90, 90]
minlongitudenumber—Sınırlayıcı kutunun batı sınırı [-360, 360]. Dikdörtgenler minlongitude < -180 veya maxlongitude > 180 kullanılarak tarih çizgisini geçebilir
minmagnitudenumber6Minimum büyüklük

Richter ölçeğinde alt büyüklük sınırı. 6 ve üzeri büyük deprem sayılır.

minsiginteger—Minimum önem derecesi
nodatainteger204Veri bulunamadığında döndürülen HTTP durum kodu (204 veya 404)şunlardan biri: 204, 404
offsetinteger0Sonuçları bu sıradan itibaren döndürür (1 tabanlı)

Sayfalama için atlanacak kayıt sayısı.

orderbystringmagnitudeSonuçları alana göre sıralarşunlardan biri: magnitude, magnitude-asc, time, time-asc
productcodestring—Bu ürün koduyla ilişkili olayı döndürür

SERBEST BİÇİMLİ USGS ürün kodu. Olduğu gibi aktarılır.

producttypestring—Bu ürün türüne sahip olaylarla sınırlar (ör. moment-tensor, focal-mechanism, shakemap, losspager, dyfi)
reviewstatusstringautomaticBelirli bir inceleme durumuna sahip olaylarla sınırlarşunlardan biri: automatic, reviewed
starttimestring2024-01-01Zaman aralığının başlangıcı (ISO8601, ör. 2022-01-01 veya 2022-01-01T00:00:00). Varsayılan: ŞU AN - 30 gün

ISO tarihi veya tarih-saat. Bu değer dahildir.

updatedafterstring—Bu zamandan sonra güncellenmiş olaylarla sınırlar (ISO8601)

BİÇİM kısıtı. ISO 8601. USGS'ye olduğu gibi aktarılır.

Örnek istek

curl "https://api.occultapi.com/api/hazard/earthquake/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Yanıt

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"type\": \"FeatureCollection\", \"metadata\": {\"generated\": 1788775941000, \"url\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson\", \"title\": \"USGS Earthquakes\", \"status\": 200, \"api\": \"2.7.0\", \"count\": 10949}, \"features\": [{\"type\": \"Feature\", \"properties\": {\"mag\": 1.3, \"place\": \"78 km WNW of Tyonek, Alaska\", \"time\": 1788775260489, \"updated\": 1788775310002, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/aka2026rsrmqf\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=aka2026rsrmqf&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 26, \"net\": \"ak\", \"code\": \"a2026rsrmqf\", \"ids\": \",aka2026rsrmqf,\", \"sources\": \",ak,\", \"types\": \",origin,phase-data,\", \"nst\": 17, \"dmin\": 0, \"rms\": 0.3, \"gap\": 92, \"magType\": \"ml\", \"type\": \"earthquake\", \"title\": \"M 1.3 - 78 km WNW of Tyonek, Alaska\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-152.516, 61.307, 4.2]}, \"id\": \"aka2026rsrmqf\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 2.2, \"place\": \"36 km W of Happy Valley, Alaska\", \"time\": 1788774950719, \"updated\": 1788775176753, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/aka2026rsridv\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=aka2026rsridv&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 74, \"net\": \"ak\", \"code\": \"a2026rsridv\", \"ids\": \",aka2026rsridv,\", \"sources\": \",ak,\", \"types\": \",origin,phase-data,\", \"nst\": 68, \"dmin\": 0.3, \"rms\": 0.6, \"gap\": 53, \"magType\": \"ml\", \"type\": \"earthquake\", \"title\": \"M 2.2 - 36 km W of Happy Valley, Alaska\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-152.39, 59.98, 79.6]}, \"id\": \"aka2026rsridv\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 1.7, \"place\": \"28 km NNW of Pāhala, Hawaii\", \"time\": 1788774479410, \"updated\": 1788774689400, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/hv75030377\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=hv75030377&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 44, \"net\": \"hv\", \"code\": \"75030377\", \"ids\": \",hv75030377,\", \"sources\": \",hv,\", \"types\": \",origin,phase-data,\", \"nst\": 17, \"dmin\": 0.0364, \"rms\": 0.200000003, \"gap\": 68, \"magType\": \"md\", \"type\": \"earthquake\", \"title\": \"M 1.7 - 28 km NNW of Pāhala, Hawaii\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-155.594665527344, 19.4323329925537, 37.8300018310547]}, \"id\": \"hv75030377\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 0.7, \"place\": \"6 km WNW of Cobb, CA\", \"time\": 1788774330340, \"updated\": 1788775642619, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/nc75431077\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=nc75431077&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 8, \"net\": \"nc\", \"code\": \"75431077\", \"ids\": \",nc75431077,\", \"sources\": \",nc,\", \"types\": \",nearby-cities,origin,phase-data,scitech-link,\", \"nst\": 8, \"dmin\": 0.002696, \"rms\": 0.01, \"gap\": 122, \"magType\": \"md\", \"type\": \"earthquake\", \"title\": \"M 0.7 - 6 km WNW of Cobb, CA\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-122.793663024902, 38.8376655578613, 1.87999999523163]}, \"id\": \"nc75431077\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 1.5, \"place\": \"29 km W of Toyah, Texas\", \"time\": 1788773169470, \"updated\": 1788773302767, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/tx2026rpuovc\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=tx2026rpuovc&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 35, \"net\": \"tx\", \"code\": \"2026rpuovc\", \"ids\": \",tx2026rpuovc,\", \"sources\": \",tx,\", \"types\": \",origin,phase-data,\", \"nst\": 5, \"dmin\": 0.2, \"rms\": 1.2, \"gap\": 215, \"magType\": \"ml\", \"type\": \"earthquake\", \"title\": \"M 1."
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.