Перейти до вмісту
GET/api/hazard/earthquake/1 кредит

Землетруси

Наскрізний проксі до сервісу подій землетрусів FDSN Геологічної служби США (USGS). Це сейсмологічні дані — історичні й оновлювані майже в реальному часі, — а не астрологічний розрахунок; вони доступні тут, щоб для мунданної астрології та пошуку кореляцій із подіями можна було отримувати і події, і дані карт через один API. Кожен параметр запиту передається в USGS без змін, тож працює весь набір параметрів FDSN: `starttime` і `endtime` у форматі ISO 8601 (за замовчуванням — останні тридцять днів), обмежувальний прямокутник через `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` або коло через `latitude`/`longitude` з `maxradius` чи `maxradiuskm`, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, PAGER `alertlevel`, `eventtype`, `reviewstatus`, `limit` до 20000, `offset` і `orderby`. Відповідь — GeoJSON FeatureCollection від USGS без змін: об’єкт `metadata` з кількістю результатів `count` і список `features`, де кожен запис має `geometry` з [довгота, широта, глибина в км] та об’єкт `properties` з магнітудою, описом місця, часом `time` у мілісекундах від епохи, повідомленнями очевидців про відчуті поштовхи, інтенсивністю за шкалою Меркаллі та Community, значущістю, прапорцем цунамі й URL сторінки події на сайті USGS. Параметр `format` ігнорується: завжди використовується geojson. Якщо USGS недоступна, ендпоінт повертає 503.

https://api.occultapi.com/api/hazard/earthquake/
Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…

Параметри запиту (42)

Передаються в URL-адресі. Усі необов’язкові, якщо не позначено інше, і їх можна поєднувати: спершу фільтр, потім сторінка, потім сортування.

ПараметрТипПрикладПризначення
alertlevelstringgreenОбмежити подіями з певним рівнем тривоги PAGERодне з: green, orange, red, yellow
catalogstring—Обмежити подіями з певного каталогу
contributorstring—Обмежити подіями, наданими певним постачальником даних
endtimestring2024-12-31Кінець часового вікна (ISO8601). За замовчуванням: поточний час

Дата ISO або дата й час. Включно.

eventidstring—Обрати конкретну подію за ID (передбачає includeallorigins та includeallmagnitudes)

ДОВІЛЬНИЙ ID події USGS (напр. 'us7000abcd'). Вибір ID передбачає includeallorigins та includeallmagnitudes. Передається через проксі без змін.

eventtypestring—Обмежити подіями певного типу (напр. 'earthquake' відфільтровує події, що не є землетрусами)
includeallmagnitudesboolean—Додати всі магнітуди для кожної події (за замовчуванням: false)
includealloriginsboolean—Додати всі джерела (origins) для кожної події (за замовчуванням: false)
includearrivalsboolean—Додати вступи фаз (за замовчуванням: false, НАРАЗІ НЕ РЕАЛІЗОВАНО)
includedeletedstring—Додати видалені події (за замовчуванням: false). Значення 'only' повертає лише видалені події

Власний опис параметра в ендпоінті подає його як булеве значення плюс 'only' («Додати видалені події (за замовчуванням: false). Значення 'only' повертає лише видалені події»). Локальної перевірки немає: значення передається через проксі в USGS, і перевіряє його саме USGS.

одне з: true, false, only
includesupersededboolean—Додати замінені продукти (за замовчуванням: false). Працює лише з eventid
latitudenumber26.9124Широта центру для пошуку в колі [-90, 90]. Потребує longitude та maxradius/maxradiuskm

Центр кругового пошуку, використовується разом із longitude і maxradiuskm.

limitinteger20Макс. кількість подій у відповіді [1, 20000]

Скільки записів повертати на сторінці.

longitudenumber75.7873Довгота центру для пошуку в колі [-180, 180]
maxalertlevelstringgreenОбмежити подіями з рівнем тривоги PAGER ≤ цього значенняодне з: green, orange, red, yellow
maxcdinumber—Макс. інтенсивність, визначена спільнотою (DYFI) [0, 12]
maxdepthnumber—Макс. глибина в км [-100, 1000]
maxgapnumber—Макс. азимутальний проміжок у градусах [0, 360]
maxlatitudenumber—Північна межа обмежувального прямокутника [-90, 90]
maxlongitudenumber—Східна межа обмежувального прямокутника [-360, 360]
maxmagnitudenumber9Макс. магнітуда
maxmminumber—Макс. інтенсивність за модифікованою шкалою Меркаллі (ShakeMap) [0, 12]
maxradiusnumber—Макс. радіус у градусах від центральної точки [0, 180]. Несумісний із maxradiuskm
maxradiuskmnumber500Макс. радіус у км від центральної точки [0, 20001.6]. Несумісний із maxradius

Радіус пошуку в кілометрах навколо latitude/longitude.

maxsiginteger—Макс. значущість
minalertlevelstringgreenОбмежити подіями з рівнем тривоги PAGER ≥ цього значенняодне з: green, orange, red, yellow
mincdinumber—Мін. інтенсивність, визначена спільнотою (DYFI)
mindepthnumber—Мін. глибина в км [-100, 1000]
minfeltinteger—Мін. кількість відповідей DYFI [1, ∞]
mingapnumber—Мін. азимутальний проміжок у градусах [0, 360]
minlatitudenumber—Південна межа обмежувального прямокутника [-90, 90]
minlongitudenumber—Західна межа обмежувального прямокутника [-360, 360]. Прямокутники можуть перетинати лінію зміни дат, якщо використати minlongitude < -180 або maxlongitude > 180
minmagnitudenumber6Мін. магнітуда

Нижня межа магнітуди за Ріхтером. 6 і вище — сильний землетрус.

minsiginteger—Мін. значущість
nodatainteger204Код статусу HTTP, який повертається, якщо дані не знайдено (204 або 404)одне з: 204, 404
offsetinteger0Повертати результати, починаючи з цього номера (з нумерацією від 1)

Скільки записів пропустити (для пагінації).

orderbystringmagnitudeУпорядкувати результати за полемодне з: magnitude, magnitude-asc, time, time-asc
productcodestring—Повернути подію, пов’язану з цим кодом продукту

ДОВІЛЬНИЙ код продукту USGS. Передається через проксі без змін.

producttypestring—Обмежити подіями з цим типом продукту (напр. moment-tensor, focal-mechanism, shakemap, losspager, dyfi)
reviewstatusstringautomaticОбмежити подіями з певним статусом перевіркиодне з: automatic, reviewed
starttimestring2024-01-01Початок часового вікна (ISO8601, напр. 2022-01-01 або 2022-01-01T00:00:00). За замовчуванням: NOW - 30 днів

Дата ISO або дата й час. Включно.

updatedafterstring—Обмежити подіями, оновленими після цього часу (ISO8601)

Обмеження ФОРМАТУ. ISO 8601. Передається в USGS без змін.

Приклад запиту

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

Відповідь

{
  "_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."
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.