Перейти к основному содержимому
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`, `alertlevel` по PAGER, `eventtype`, `reviewstatus`, `limit` до 20000, `offset` и `orderby`. Ответ — GeoJSON FeatureCollection от USGS в исходном виде: объект `metadata` с числом результатов `count` и список `features`, где у каждой записи есть `geometry` с [долгота, широта, глубина в км] и объект `properties` с магнитудой, описанием места, временем `time` в миллисекундах от начала эпохи, числом сообщений об ощущениях, интенсивностью по Меркалли и по оценке сообщества, значимостью, флагом цунами и 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'. Если он указан, подразумеваются 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). По умолчанию: текущий момент минус 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. Подробнее — в справочнике ошибок.