GEThttps://api.occultapi.com/api/hazard/tsunami/events/

Цунамі

Параметри запитуу форматі JSON, передаються в URL

Щоб надіслати запит, вставте API-ключ вище.

Фрагмент коду

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

Наскрізний проксі до Глобальної історичної бази даних цунамі Національних центрів екологічної інформації NOAA (NOAA NCEI). Це історичний геофізичний каталог, а не астрологічний розрахунок; він сягає другого тисячоліття до н. е., і роки до нашої ери подано від’ємними числами. Параметри запиту передаються в NOAA без змін. Основні з них — `year`, `minYear` і `maxYear`, `day` і `month`, `country`, `area` і `regionCode` (числові коди океанських басейнів, напр. 85 для Японії, 50 для Середземномор’я і 89 для західного узбережжя Південної Америки; кілька кодів можна передати через кому), прямокутник широти й довготи, `minCauseCode`/`maxCauseCode` (0 — невідомо, 1 — землетрус, 6 — вулкан, 8 — зсув, 9 — метеорологічна причина, 10 — вибух, 11 — астрономічний приплив тощо), `minEventValidity`/`maxEventValidity` за шкалою від -1 (помилкова) до 4 (достовірна), а також пороги висоти хвилі, магнітуди землетрусу, кількості загиблих, поранених, зруйнованих будинків і збитків у мільйонах доларів. Деякі з них мають ще й форму 'amount order' — грубу шкалу категорій 0-4 для випадків, коли точне значення не зафіксовано. Для пагінації — `page`, `itemsPerPage` і `order` (напр. `year:asc`). Відповідь — у власному форматі NOAA зі списком `items`. Кожен елемент містить id, складові дати, `eventValidity`, `causeCode`, id пов’язаних подій землетрусу чи виверження вулкана, країну й `locationName`, `regionCode`, широту й довготу, `maxWaterHeight` у метрах, кількість зафіксованих заплесків, інтенсивність цунамі та категорії загиблих і збитків як для регіону-джерела, так і для події загалом.

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

Параметр	Тип	Приклад	Призначення
area	string	—	Штат, провінція чи префектура джерела цунамі
assocDeposits	string	—	Фільтр за пов’язаними відкладеннями цунамі
causeCode	string	—	Код(и) причини через кому. 0 — невідомо, 1 — землетрус, 2 — сумнівний землетрус, 3 — землетрус і зсув, 4 — вулкан і землетрус, 5 — вулкан/землетрус/зсув, 6 — вулкан, 7 — вулкан і зсув, 8 — зсув, 9 — метеорологічна причина, 10 — вибух, 11 — астрономічний приплив. Приклад: 2,9,11 Список через кому, напр. '2,9,11'. 0 — невідомо; 1 — землетрус; 2 — сумнівний землетрус; 3 — землетрус і зсув; 4 — вулкан і землетрус; 5 — вулкан/землетрус/зсув; 6 — вулкан; 7 — вулкан і зсув; 8 — зсув; 9 — метеорологічна причина; 10 — вибух; 11 — астрономічний приплив. одне з: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
commentsEnd	string	—	Коментарі закінчуються на ДОВІЛЬНИЙ текст — «коментарі закінчуються на».
commentsInclude	string	—	Коментарі містять ДОВІЛЬНИЙ текст — «коментарі містять».
commentsMatch	string	—	Коментарі точно збігаються з ДОВІЛЬНИЙ текст — «коментарі точно збігаються з».
commentsNot	string	—	Коментарі не містять ДОВІЛЬНИЙ текст — «коментарі не містять».
commentsStart	string	—	Коментарі починаються з ДОВІЛЬНИЙ текст — «коментарі починаються з».
country	string	—	Країна, де виникло джерело цунамі (напр. Японія)
day	integer	—	День події (1–31)
id	integer	—	Точний ID події
itemsPerPage	integer	—	Кількість елементів на сторінці
locEnd	string	—	Назва місця закінчується на ДОВІЛЬНИЙ текст — «назва місця закінчується на».
locInclude	string	—	Назва місця містить ДОВІЛЬНИЙ текст — «назва місця містить».
locMatch	string	—	Назва місця точно збігається з ДОВІЛЬНИЙ текст — «назва місця точно збігається з».
locNot	string	—	Назва місця не містить ДОВІЛЬНИЙ текст — «назва місця не містить».
locStart	string	—	Назва місця починається з ДОВІЛЬНИЙ текст — «назва місця починається з». Передається через проксі в NOAA.
maxCauseCode	integer	—	Макс. код причини. 0 — невідомо, 1 — землетрус, 2 — сумнівний землетрус, 3 — землетрус і зсув, 4 — вулкан і землетрус, 5 — вулкан/землетрус/зсув, 6 — вулкан, 7 — вулкан і зсув, 8 — зсув, 9 — метеорологічна причина, 10 — вибух, 11 — астрономічний приплив. Приклад: 2,9,11
maxDamageAmountOrder	integer	—	Опис макс. збитків. 0 — немає, 1 — ОБМЕЖЕНІ (<$1M), 2 — ПОМІРНІ ($1–5M), 3 — ЗНАЧНІ ($5–25M), 4 — НАДЗВИЧАЙНІ (>$25M)
maxDamageAmountOrderTotal	integer	—	Опис макс. загальних збитків. 0 — немає, 1 — ОБМЕЖЕНІ (<$1M), 2 — ПОМІРНІ ($1–5M), 3 — ЗНАЧНІ ($5–25M), 4 — НАДЗВИЧАЙНІ (>$25M)
maxDamageMillionsDollars	number	—	Макс. збитки в мільйонах доларів
maxDamageMillionsDollarsTotal	number	—	Макс. загальні збитки в мільйонах доларів (цунамі + подія-джерело)
maxDeaths	integer	—	Макс. кількість загиблих від цунамі
maxDeathsAmountOrder	integer	—	Опис макс. кількості загиблих. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
maxDeathsAmountOrderTotal	integer	—	Опис макс. загальної кількості загиблих. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
maxDeathsTotal	integer	—	Макс. загальна кількість загиблих від цунамі та події-джерела
maxEqMagnitude	number	—	Макс. магнітуда землетрусу [0.0, 9.9]
maxEventValidity	integer	—	Макс. достовірність події. −1 — помилкова, 0 — немає, 1 — дуже сумнівна, 2 — сумнівна, 3 — ймовірна, 4 — достовірна
maxHousesDestroyed	integer	—	Макс. кількість зруйнованих будинків
maxHousesDestroyedAmountOrder	integer	—	Опис макс. кількості зруйнованих будинків. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
maxId	integer	—	Максимальний ID події
maxInjuries	integer	—	Макс. кількість поранених від цунамі
maxInjuriesAmountOrder	integer	—	Опис макс. кількості поранених. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
maxLatitude	number	—	Макс. широта [−90, 90]
maxLongitude	number	—	Макс. довгота [−180, 180]
maxMaxWaterHeight	number	—	Верхня межа максимальної висоти води над рівнем моря (м)
maxNumRunups	integer	—	Макс. кількість місць заплеску, пов’язаних із подією
maxRunupHoriz	number	—	Верхня межа максимальної горизонтальної відстані затоплення вглиб суходолу (м)
maxYear	integer	—	Максимальний рік
minCauseCode	integer	—	Мін. код причини. 0 — невідомо, 1 — землетрус, 2 — сумнівний землетрус, 3 — землетрус і зсув, 4 — вулкан і землетрус, 5 — вулкан/землетрус/зсув, 6 — вулкан, 7 — вулкан і зсув, 8 — зсув, 9 — метеорологічна причина, 10 — вибух, 11 — астрономічний приплив. Приклад: 2,9,11
minDamageAmountOrder	integer	—	Опис мін. збитків. 0 — немає, 1 — ОБМЕЖЕНІ (<$1M), 2 — ПОМІРНІ ($1–5M), 3 — ЗНАЧНІ ($5–25M), 4 — НАДЗВИЧАЙНІ (>$25M)
minDamageAmountOrderTotal	integer	—	Опис мін. загальних збитків. 0 — немає, 1 — ОБМЕЖЕНІ (<$1M), 2 — ПОМІРНІ ($1–5M), 3 — ЗНАЧНІ ($5–25M), 4 — НАДЗВИЧАЙНІ (>$25M)
minDamageMillionsDollars	number	—	Мін. збитки в мільйонах доларів
minDamageMillionsDollarsTotal	number	—	Мін. загальні збитки в мільйонах доларів (цунамі + подія-джерело)
minDeaths	integer	—	Мін. кількість загиблих від цунамі
minDeathsAmountOrder	integer	—	Опис мін. кількості загиблих. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
minDeathsAmountOrderTotal	integer	—	Опис мін. загальної кількості загиблих. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
minDeathsTotal	integer	—	Мін. загальна кількість загиблих від цунамі та події-джерела
minEqMagnitude	number	—	Мін. магнітуда землетрусу [0.0, 9.9]
minEventValidity	integer	—	Мін. достовірність події. −1 — помилкова, 0 — немає, 1 — дуже сумнівна, 2 — сумнівна, 3 — ймовірна, 4 — достовірна
minHousesDestroyed	integer	—	Мін. кількість зруйнованих будинків
minHousesDestroyedAmountOrder	integer	—	Опис мін. кількості зруйнованих будинків. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
minId	integer	—	Мінімальний ID події
minInjuries	integer	—	Мін. кількість поранених від цунамі
minInjuriesAmountOrder	integer	—	Опис мін. кількості поранених. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
minLatitude	number	—	Мін. широта [−90, 90]
minLongitude	number	—	Мін. довгота [−180, 180]
minMaxWaterHeight	number	—	Нижня межа максимальної висоти води над рівнем моря (м)
minNumRunups	integer	—	Мін. кількість місць заплеску, пов’язаних із подією
minRunupHoriz	number	—	Нижня межа максимальної горизонтальної відстані затоплення вглиб суходолу (м)
minYear	integer	—	Мінімальний рік
month	integer	—	Місяць події (1–12)
oceanicTsunami	boolean	—	Фільтр за океанічним цунамі (true/false)
op	string	—	Логічний оператор для фільтрів
order	string	—	Порядок сортування. Приклади: year:asc, month:desc Обмеження ФОРМАТУ, а не фіксований перелік значень: '<field>:asc' або '<field>:desc', напр. 'year:asc', 'month:desc'. Назва поля має бути такою, яку розпізнає NOAA; локально не перевіряється.
page	integer	—	Номер сторінки
regionCode	string	—	Код(и) регіону. 87 — Аляска (включно з Алеутськими островами), 40 — Чорне й Каспійське моря, 74 — Карибське море, 78 — Центральна Африка, 84 — Китай/Північна й Південна Корея/Філіппіни/Тайвань, 81 — східне узбережжя Австралії/Нова Зеландія/острови південної частини Тихого океану, 75 — східне узбережжя США й Канади, 76 — Американська/Мексиканська затока, 80 — Гаваї/атол Джонстон/острів Мідвей, 60 — Індійський океан (включно із західним узбережжям Австралії), 83 — Індонезія (Тихий океан) і Малайзія, 85 — Японія, 86 — Камчатка й Курильські острови, 50 — Середземне море, 82 — Нова Каледонія/Нова Гвінея/Соломонові острови/Вануату, 73 — північно-східна Атлантика, 72 — північно-західна Атлантика, 30 — Червоне море й Перська затока, 70 — південно-східна Атлантика, 71 — південно-західна Атлантика, 77 — західне узбережжя Африки, 88 — західне узбережжя Північної та Центральної Америки, 89 — західне узбережжя Південної Америки. Приклад: 87,30,89 Список числових кодів регіонів через кому, напр. '87,30,89'. Значення: 30 Червоне море й Перська затока; 40 Чорне й Каспійське моря; 50 Середземне море; 60 Індійський океан (включно із західним узбережжям Австралії); 70 південно-східна Атлантика; 71 південно-західна Атлантика; 72 північно-західна Атлантика; 73 північно-східна Атлантика; 74 Карибське море; 75 східне узбережжя США й Канади; 76 Американська/Мексиканська затока; 77 західне узбережжя Африки; 78 Центральна Африка; 80 Гаваї/атол Джонстон/острів Мідвей; 81 східне узбережжя Австралії/Нова Зеландія/острови південної частини Тихого океану; 82 Нова Каледонія/Нова Гвінея/Соломонові острови/Вануату; 83 Індонезія (Тихий океан) і Малайзія; 84 Китай/Північна й Південна Корея/Філіппіни/Тайвань; 85 Японія; 86 Камчатка й Курильські острови; 87 Аляска (включно з Алеутськими островами); 88 західне узбережжя Північної та Центральної Америки; 89 західне узбережжя Південної Америки. Передається через проксі в NOAA NCEI без змін. одне з: 30, 40, 50, 60, 70, 71, 72, 73, 74, 75, 76, 77, 78, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89
runupArea	string	—	Штат/провінція/префектура місця заплеску
runupCountry	string	—	Країна місця заплеску
runupDoubtful	string	—	Достовірність заплеску: n — OK, y — сумнівний, m — метеорологічний, a — атмосферний Одна літера: n = OK, y = сумнівний, m = метеорологічний, a = атмосферний. одне з: n, y, m, a
runupLocEnd	string	—	Назва місця заплеску закінчується на ДОВІЛЬНИЙ текст — «назва місця заплеску закінчується на».
runupLocInclude	string	—	Назва місця заплеску містить ДОВІЛЬНИЙ текст — «назва місця заплеску містить».
runupLocMatch	string	—	Назва місця заплеску точно збігається з ДОВІЛЬНИЙ текст — «назва місця заплеску точно збігається з».
runupLocNot	string	—	Назва місця заплеску не містить ДОВІЛЬНИЙ текст — «назва місця заплеску не містить».
runupLocStart	string	—	Назва місця заплеску починається з ДОВІЛЬНИЙ текст — «назва місця заплеску починається з».
runupMaxDamageAmountOrder	integer	—	Опис макс. збитків від заплеску. 0 — немає, 1 — ОБМЕЖЕНІ (<$1M), 2 — ПОМІРНІ ($1–5M), 3 — ЗНАЧНІ ($5–25M), 4 — НАДЗВИЧАЙНІ (>$25M)
runupMaxDamageMillionsDollars	number	—	Макс. збитки в місці заплеску (млн $)
runupMaxDeaths	integer	—	Макс. кількість загиблих у місці заплеску
runupMaxDeathsAmountOrder	integer	—	Опис макс. кількості загиблих від заплеску. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
runupMaxDistance	integer	—	Макс. відстань від джерела до заплеску (км)
runupMaxHeight	number	—	Верхня межа максимальної висоти води в місці заплеску (м)
runupMaxHousesDestroyed	integer	—	Макс. кількість зруйнованих будинків у місці заплеску
runupMaxHousesDestroyedAmountOrder	integer	—	Опис макс. кількості зруйнованих заплеском будинків. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
runupMaxInjuries	integer	—	Макс. кількість поранених у місці заплеску
runupMaxInjuriesAmountOrder	integer	—	Опис макс. кількості поранених від заплеску. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
runupMaxTravelTime	integer	—	Макс. час поширення (хвилини)
runupMaxTroughHt	number	—	Верхня межа максимального пониження води нижче рівня моря (м)
runupMeasureType	integer	—	Тип вимірювання: 1 — висота води за свідченнями очевидців, 2 — мареограф, 3 — глибоководний датчик, 4 — висота води за післяподієвим обстеженням, 5 — висота заплеску за післяподієвим обстеженням, 6 — атмосферна хвиля, 7 — сейша, 8 — висота заплеску в гавані, 9 — слід бризок, 10 — глибина потоку
runupMinDamageAmountOrder	integer	—	Опис мін. збитків від заплеску. 0 — немає, 1 — ОБМЕЖЕНІ (<$1M), 2 — ПОМІРНІ ($1–5M), 3 — ЗНАЧНІ ($5–25M), 4 — НАДЗВИЧАЙНІ (>$25M)
runupMinDamageMillionsDollars	number	—	Мін. збитки в місці заплеску (млн $)
runupMinDeaths	integer	—	Мін. кількість загиблих у місці заплеску
runupMinDeathsAmountOrder	integer	—	Опис мін. кількості загиблих від заплеску. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
runupMinDistance	integer	—	Мін. відстань від джерела до заплеску (км)
runupMinHeight	number	—	Нижня межа максимальної висоти води в місці заплеску (м)
runupMinHousesDestroyed	integer	—	Мін. кількість зруйнованих будинків у місці заплеску
runupMinHousesDestroyedAmountOrder	integer	—	Опис мін. кількості зруйнованих заплеском будинків. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
runupMinInjuries	integer	—	Мін. кількість поранених у місці заплеску
runupMinInjuriesAmountOrder	integer	—	Опис мін. кількості поранених від заплеску. 0 — немає, 1 — мало (~1–50), 2 — декілька (~51–100), 3 — багато (~101–1000), 4 — дуже багато (>1000)
runupMinTravelTime	integer	—	Мін. час поширення (хвилини)
runupMinTroughHt	number	—	Нижня межа максимального пониження води нижче рівня моря (м)
runupRegion	string	—	Код(и) регіону заплеску. 87 — Аляска (включно з Алеутськими островами), 40 — Чорне й Каспійське моря, 74 — Карибське море, 78 — Центральна Африка, 84 — Китай/Північна й Південна Корея/Філіппіни/Тайвань, 81 — східне узбережжя Австралії/Нова Зеландія/острови південної частини Тихого океану, 75 — східне узбережжя США й Канади, 76 — Американська/Мексиканська затока, 80 — Гаваї/атол Джонстон/острів Мідвей, 60 — Індійський океан (включно із західним узбережжям Австралії), 83 — Індонезія (Тихий океан) і Малайзія, 85 — Японія, 86 — Камчатка й Курильські острови, 50 — Середземне море, 82 — Нова Каледонія/Нова Гвінея/Соломонові острови/Вануату, 73 — північно-східна Атлантика, 72 — північно-західна Атлантика, 30 — Червоне море й Перська затока, 70 — південно-східна Атлантика, 71 — південно-західна Атлантика, 77 — західне узбережжя Африки, 88 — західне узбережжя Північної та Центральної Америки, 89 — західне узбережжя Південної Америки. Приклад: 87,30,89 Числові коди регіонів через кому — ті самі коди з тими самими значеннями, що й для regionCode, але вони стосуються місця заплеску, а не джерела цунамі. одне з: 30, 40, 50, 60, 70, 71, 72, 73, 74, 75, 76, 77, 78, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89
tsuAssoc	string	—	Фільтр за зв’язком із цунамі
year	integer	—	Точний рік події

Повний довідник цього ендпоінта