/api/hazard/earthquake/1 krediDeprem 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/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.
| Parametre | Tür | Örnek | Ne işe yarar | |
|---|---|---|---|---|
| alertlevel | string | green | Belirli bir PAGER uyarı seviyesine sahip olaylarla sınırlarşunlardan biri: green, orange, red, yellow | |
| catalog | string | — | Belirli bir katalogdaki olaylarla sınırlar | |
| contributor | string | — | Belirli bir katkı verenin sağladığı olaylarla sınırlar | |
| endtime | string | 2024-12-31 | Zaman aralığının sonu (ISO8601). Varsayılan: şu an ISO tarihi veya tarih-saat. Bu değer dahildir. | |
| eventid | string | — | 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. | |
| eventtype | string | — | Belirli türdeki olaylarla sınırlar (ör. 'earthquake' deprem dışındaki olayları eler) | |
| includeallmagnitudes | boolean | — | Her olay için tüm büyüklükleri dahil eder (varsayılan: false) | |
| includeallorigins | boolean | — | Her olay için tüm kaynakları dahil eder (varsayılan: false) | |
| includearrivals | boolean | — | Faz varışlarını dahil eder (varsayılan: false, ŞU ANDA UYGULANMIYOR) | |
| includedeleted | string | — | 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 | |
| includesuperseded | boolean | — | Yerini yenisine bırakmış ürünleri dahil eder (varsayılan: false). Yalnızca eventid ile çalışır | |
| latitude | number | 26.9124 | Daire araması için merkez enlem [-90, 90]. longitude ve maxradius/maxradiuskm gerektirir Dairesel aramanın merkezi; longitude ve maxradiuskm ile birlikte kullanılır. | |
| limit | integer | 20 | Döndürülecek en fazla olay sayısı [1, 20000] Sayfa başına döndürülecek kayıt sayısı. | |
| longitude | number | 75.7873 | Daire araması için merkez boylam [-180, 180] | |
| maxalertlevel | string | green | PAGER uyarı seviyesi ≤ bu değer olan olaylarla sınırlarşunlardan biri: green, orange, red, yellow | |
| maxcdi | number | — | Maksimum Topluluk Tarafından Belirlenen Şiddet (DYFI) [0, 12] | |
| maxdepth | number | — | Maksimum derinlik, km cinsinden [-100, 1000] | |
| maxgap | number | — | Maksimum azimut boşluğu, derece cinsinden [0, 360] | |
| maxlatitude | number | — | Sınırlayıcı kutunun kuzey sınırı [-90, 90] | |
| maxlongitude | number | — | Sınırlayıcı kutunun doğu sınırı [-360, 360] | |
| maxmagnitude | number | 9 | Maksimum büyüklük | |
| maxmmi | number | — | Maksimum Değiştirilmiş Mercalli Şiddeti (ShakeMap) [0, 12] | |
| maxradius | number | — | Merkez noktadan derece cinsinden maksimum yarıçap [0, 180]. maxradiuskm ile birlikte kullanılamaz | |
| maxradiuskm | number | 500 | Merkez noktadan km cinsinden maksimum yarıçap [0, 20001.6]. maxradius ile birlikte kullanılamaz latitude/longitude çevresinde kilometre cinsinden arama yarıçapı. | |
| maxsig | integer | — | Maksimum önem derecesi | |
| minalertlevel | string | green | PAGER uyarı seviyesi ≥ bu değer olan olaylarla sınırlarşunlardan biri: green, orange, red, yellow | |
| mincdi | number | — | Minimum Topluluk Tarafından Belirlenen Şiddet (DYFI) | |
| mindepth | number | — | Minimum derinlik, km cinsinden [-100, 1000] | |
| minfelt | integer | — | Minimum DYFI yanıt sayısı [1, ∞] | |
| mingap | number | — | Minimum azimut boşluğu, derece cinsinden [0, 360] | |
| minlatitude | number | — | Sınırlayıcı kutunun güney sınırı [-90, 90] | |
| minlongitude | number | — | Sınırlayıcı kutunun batı sınırı [-360, 360]. Dikdörtgenler minlongitude < -180 veya maxlongitude > 180 kullanılarak tarih çizgisini geçebilir | |
| minmagnitude | number | 6 | Minimum 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. | |
| minsig | integer | — | Minimum önem derecesi | |
| nodata | integer | 204 | Veri bulunamadığında döndürülen HTTP durum kodu (204 veya 404)şunlardan biri: 204, 404 | |
| offset | integer | 0 | Sonuçları bu sıradan itibaren döndürür (1 tabanlı) Sayfalama için atlanacak kayıt sayısı. | |
| orderby | string | magnitude | Sonuçları alana göre sıralarşunlardan biri: magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | Bu ürün koduyla ilişkili olayı döndürür SERBEST BİÇİMLİ USGS ürün kodu. Olduğu gibi aktarılır. | |
| producttype | string | — | Bu ürün türüne sahip olaylarla sınırlar (ör. moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | Belirli bir inceleme durumuna sahip olaylarla sınırlarşunlardan biri: automatic, reviewed | |
| starttime | string | 2024-01-01 | Zaman 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. | |
| updatedafter | string | — | 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.