Загружаем песочницу
curl "https://api.occultapi.com/api/hazard/earthquake/" \
-H "X-API-Key: $OCCULT_API_KEY"Сквозной прокси к сервису событий землетрясений FDSN Геологической службы США (USGS). Это исторические и почти оперативные сейсмологические данные, а не астрологический расчёт; эндпоинт нужен, чтобы в мунданной астрологии и при поиске связей с событиями получать и сами события, и данные карт через один API. Все параметры запроса передаются в USGS без изменений, поэтому доступен весь набор параметров FDSN: `starttime` и `endtime` в ISO 8601 (по умолчанию — последние тридцать дней), ограничивающий прямоугольник через `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` или круг через `latitude`/`longitude` с `maxradius` или `maxradiuskm`, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, `alertlevel` по PAGER, `eventtype`, `reviewstatus`, `limit` до 20000, `offset` и `orderby`. Ответ — GeoJSON FeatureCollection от USGS в исходном виде: объект `metadata` с числом результатов `count` и список `features`, где у каждой записи есть `geometry` с [долгота, широта, глубина в км] и объект `properties` с магнитудой, описанием места, временем `time` в миллисекундах от начала эпохи, числом сообщений об ощущениях, интенсивностью по Меркалли и по оценке сообщества, значимостью, флагом цунами и URL страницы события на сайте USGS. Параметр `format` игнорируется: всегда используется geojson. Если USGS недоступна, эндпоинт возвращает 503.
| Параметр | Тип | Пример | Назначение | |
|---|---|---|---|---|
| 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'. Если он указан, подразумеваются 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). По умолчанию: текущий момент минус 30 дней Дата ISO или дата-время. Включительно. | |
| updatedafter | string | — | Только события, обновлённые после этого момента (ISO8601) Ограничение ФОРМАТА. ISO 8601. Передаётся в USGS как есть. |