/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-адресі. Усі необов’язкові, якщо не позначено інше, і їх можна поєднувати: спершу фільтр, потім сторінка, потім сортування.
| Параметр | Тип | Приклад | Призначення | |
|---|---|---|---|---|
| alertlevel | string | green | Обмежити подіями з певним рівнем тривоги PAGERодне з: green, orange, red, yellow | |
| catalog | string | — | Обмежити подіями з певного каталогу | |
| contributor | string | — | Обмежити подіями, наданими певним постачальником даних | |
| endtime | string | 2024-12-31 | Кінець часового вікна (ISO8601). За замовчуванням: поточний час Дата ISO або дата й час. Включно. | |
| eventid | string | — | Обрати конкретну подію за ID (передбачає includeallorigins та includeallmagnitudes) ДОВІЛЬНИЙ ID події USGS (напр. 'us7000abcd'). Вибір ID передбачає includeallorigins та includeallmagnitudes. Передається через проксі без змін. | |
| eventtype | string | — | Обмежити подіями певного типу (напр. 'earthquake' відфільтровує події, що не є землетрусами) | |
| includeallmagnitudes | boolean | — | Додати всі магнітуди для кожної події (за замовчуванням: false) | |
| includeallorigins | boolean | — | Додати всі джерела (origins) для кожної події (за замовчуванням: false) | |
| includearrivals | boolean | — | Додати вступи фаз (за замовчуванням: false, НАРАЗІ НЕ РЕАЛІЗОВАНО) | |
| includedeleted | string | — | Додати видалені події (за замовчуванням: false). Значення 'only' повертає лише видалені події Власний опис параметра в ендпоінті подає його як булеве значення плюс 'only' («Додати видалені події (за замовчуванням: false). Значення 'only' повертає лише видалені події»). Локальної перевірки немає: значення передається через проксі в USGS, і перевіряє його саме USGS. одне з: true, false, only | |
| includesuperseded | boolean | — | Додати замінені продукти (за замовчуванням: false). Працює лише з eventid | |
| latitude | number | 26.9124 | Широта центру для пошуку в колі [-90, 90]. Потребує longitude та maxradius/maxradiuskm Центр кругового пошуку, використовується разом із longitude і maxradiuskm. | |
| limit | integer | 20 | Макс. кількість подій у відповіді [1, 20000] Скільки записів повертати на сторінці. | |
| longitude | number | 75.7873 | Довгота центру для пошуку в колі [-180, 180] | |
| maxalertlevel | string | green | Обмежити подіями з рівнем тривоги PAGER ≤ цього значенняодне з: green, orange, red, yellow | |
| maxcdi | number | — | Макс. інтенсивність, визначена спільнотою (DYFI) [0, 12] | |
| maxdepth | number | — | Макс. глибина в км [-100, 1000] | |
| maxgap | number | — | Макс. азимутальний проміжок у градусах [0, 360] | |
| maxlatitude | number | — | Північна межа обмежувального прямокутника [-90, 90] | |
| maxlongitude | number | — | Східна межа обмежувального прямокутника [-360, 360] | |
| maxmagnitude | number | 9 | Макс. магнітуда | |
| maxmmi | number | — | Макс. інтенсивність за модифікованою шкалою Меркаллі (ShakeMap) [0, 12] | |
| maxradius | number | — | Макс. радіус у градусах від центральної точки [0, 180]. Несумісний із maxradiuskm | |
| maxradiuskm | number | 500 | Макс. радіус у км від центральної точки [0, 20001.6]. Несумісний із maxradius Радіус пошуку в кілометрах навколо latitude/longitude. | |
| maxsig | integer | — | Макс. значущість | |
| minalertlevel | string | green | Обмежити подіями з рівнем тривоги PAGER ≥ цього значенняодне з: green, orange, red, yellow | |
| mincdi | number | — | Мін. інтенсивність, визначена спільнотою (DYFI) | |
| mindepth | number | — | Мін. глибина в км [-100, 1000] | |
| minfelt | integer | — | Мін. кількість відповідей DYFI [1, ∞] | |
| mingap | number | — | Мін. азимутальний проміжок у градусах [0, 360] | |
| minlatitude | number | — | Південна межа обмежувального прямокутника [-90, 90] | |
| minlongitude | number | — | Західна межа обмежувального прямокутника [-360, 360]. Прямокутники можуть перетинати лінію зміни дат, якщо використати minlongitude < -180 або maxlongitude > 180 | |
| minmagnitude | number | 6 | Мін. магнітуда Нижня межа магнітуди за Ріхтером. 6 і вище — сильний землетрус. | |
| minsig | integer | — | Мін. значущість | |
| nodata | integer | 204 | Код статусу HTTP, який повертається, якщо дані не знайдено (204 або 404)одне з: 204, 404 | |
| offset | integer | 0 | Повертати результати, починаючи з цього номера (з нумерацією від 1) Скільки записів пропустити (для пагінації). | |
| orderby | string | magnitude | Упорядкувати результати за полемодне з: magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | Повернути подію, пов’язану з цим кодом продукту ДОВІЛЬНИЙ код продукту USGS. Передається через проксі без змін. | |
| producttype | string | — | Обмежити подіями з цим типом продукту (напр. moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | Обмежити подіями з певним статусом перевіркиодне з: automatic, reviewed | |
| starttime | string | 2024-01-01 | Початок часового вікна (ISO8601, напр. 2022-01-01 або 2022-01-01T00:00:00). За замовчуванням: NOW - 30 днів Дата ISO або дата й час. Включно. | |
| updatedafter | string | — | Обмежити подіями, оновленими після цього часу (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. Детальніше — у довіднику помилок.