Cargando el Playground
curl "https://api.occultapi.com/api/hazard/tsunami/events/" \
-H "X-API-Key: $OCCULT_API_KEY"Un proxy transparente de la Global Historical Tsunami Database de los National Centers for Environmental Information de NOAA. Es un catálogo geofísico histórico, no un cálculo astrológico, y se remonta al segundo milenio a. C.: los años anteriores a la era común aparecen como números negativos. Los parámetros de consulta se reenvían sin cambios a NOAA. Los principales son `year`, `minYear` y `maxYear`, `day` y `month`, `country`, `area` y `regionCode` (códigos numéricos de cuenca oceánica, como 85 para Japón, 50 para el Mediterráneo y 89 para la costa oeste de Sudamérica; se pueden indicar varios separados por comas), un rectángulo de latitud y longitud, `minCauseCode`/`maxCauseCode` (0 desconocida, 1 terremoto, 6 volcán, 8 deslizamiento de tierra, 9 meteorológica, 10 explosión, 11 marea astronómica, entre otros), `minEventValidity`/`maxEventValidity` en una escala de -1 errónea a 4 definitiva, y umbrales de altura de ola, magnitud del terremoto, muertes, heridos, viviendas destruidas y daños en millones de dólares. Varios de ellos también existen en forma de «orden de magnitud», una clasificación aproximada de 0-4 que se usa cuando nunca se registró una cifra exacta. La paginación usa `page`, `itemsPerPage` y `order` (por ejemplo, `year:asc`). La respuesta es la estructura propia de NOAA, con una lista `items`. Cada elemento lleva un id, las partes de la fecha, `eventValidity`, `causeCode`, los id de los eventos de terremoto o volcán vinculados, el país y `locationName`, `regionCode`, la latitud y la longitud, `maxWaterHeight` en metros, el número de remontes registrados, la intensidad del tsunami y las bandas de orden de magnitud de muertes y daños tanto para la región de origen como para el evento en su conjunto.
| Parámetro | Tipo | Ejemplo | Para qué sirve | |
|---|---|---|---|---|
| area | string | — | Estado, provincia o prefectura del origen del tsunami | |
| assocDeposits | string | — | Filtrar por depósitos de tsunami asociados | |
| causeCode | string | — | Código(s) de causa, separados por comas. 0-Desconocida, 1-Terremoto, 2-Terremoto dudoso, 3-Terremoto y deslizamiento de tierra, 4-Volcán y terremoto, 5-Volcán/terremoto/deslizamiento de tierra, 6-Volcán, 7-Volcán y deslizamiento de tierra, 8-Deslizamiento de tierra, 9-Meteorológica, 10-Explosión, 11-Marea astronómica. Ejemplo: 2,9,11 Lista separada por comas, p. ej., '2,9,11'. 0 Desconocida; 1 Terremoto; 2 Terremoto dudoso; 3 Terremoto y deslizamiento de tierra; 4 Volcán y terremoto; 5 Volcán/terremoto/deslizamiento de tierra; 6 Volcán; 7 Volcán y deslizamiento de tierra; 8 Deslizamiento de tierra; 9 Meteorológica; 10 Explosión; 11 Marea astronómica. uno de: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 | |
| commentsEnd | string | — | Los comentarios terminan con Texto en FORMATO LIBRE: «los comentarios terminan con». | |
| commentsInclude | string | — | Los comentarios incluyen Texto en FORMATO LIBRE: «los comentarios incluyen». | |
| commentsMatch | string | — | Los comentarios coinciden exactamente con Texto en FORMATO LIBRE: «los comentarios coinciden exactamente con». | |
| commentsNot | string | — | Los comentarios no incluyen Texto en FORMATO LIBRE: «los comentarios no incluyen». | |
| commentsStart | string | — | Los comentarios empiezan por Texto en FORMATO LIBRE: «los comentarios empiezan por». | |
| country | string | — | País donde se produjo el origen del tsunami (p. ej., Japón) | |
| day | integer | — | Día del evento (1–31) | |
| id | integer | — | ID exacto del evento | |
| itemsPerPage | integer | — | Número de elementos por página | |
| locEnd | string | — | El nombre del lugar termina con Texto en FORMATO LIBRE: «el nombre del lugar termina con». | |
| locInclude | string | — | El nombre del lugar incluye Texto en FORMATO LIBRE: «el nombre del lugar incluye». | |
| locMatch | string | — | El nombre del lugar coincide exactamente con Texto en FORMATO LIBRE: «el nombre del lugar coincide exactamente con». | |
| locNot | string | — | El nombre del lugar no incluye Texto en FORMATO LIBRE: «el nombre del lugar no incluye». | |
| locStart | string | — | El nombre del lugar empieza por Texto en FORMATO LIBRE: «el nombre del lugar empieza por». Se reenvía a NOAA. | |
| maxCauseCode | integer | — | Código de causa máximo. 0-Desconocida, 1-Terremoto, 2-Terremoto dudoso, 3-Terremoto y deslizamiento de tierra, 4-Volcán y terremoto, 5-Volcán/terremoto/deslizamiento de tierra, 6-Volcán, 7-Volcán y deslizamiento de tierra, 8-Deslizamiento de tierra, 9-Meteorológica, 10-Explosión, 11-Marea astronómica. Ejemplo: 2,9,11 | |
| maxDamageAmountOrder | integer | — | Descripción del daño máximo. 0-Ninguno, 1-LIMITADO (<$1M), 2-MODERADO ($1–5M), 3-GRAVE ($5–25M), 4-EXTREMO (>$25M) | |
| maxDamageAmountOrderTotal | integer | — | Descripción del daño total máximo. 0-Ninguno, 1-LIMITADO (<$1M), 2-MODERADO ($1–5M), 3-GRAVE ($5–25M), 4-EXTREMO (>$25M) | |
| maxDamageMillionsDollars | number | — | Daño máximo en millones de dólares | |
| maxDamageMillionsDollarsTotal | number | — | Daño total máximo en millones de dólares (tsunami + evento de origen) | |
| maxDeaths | integer | — | Número máximo de muertes causadas por el tsunami | |
| maxDeathsAmountOrder | integer | — | Descripción del número máximo de muertes. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| maxDeathsAmountOrderTotal | integer | — | Descripción del número total máximo de muertes. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| maxDeathsTotal | integer | — | Número total máximo de muertes causadas por el tsunami y el evento de origen | |
| maxEqMagnitude | number | — | Magnitud máxima del terremoto [0.0, 9.9] | |
| maxEventValidity | integer | — | Validez máxima del evento. −1-errónea, 0-ninguna, 1-muy dudosa, 2-cuestionable, 3-probable, 4-definitiva | |
| maxHousesDestroyed | integer | — | Número máximo de viviendas destruidas | |
| maxHousesDestroyedAmountOrder | integer | — | Descripción del número máximo de viviendas destruidas. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| maxId | integer | — | ID máximo del evento | |
| maxInjuries | integer | — | Número máximo de heridos causados por el tsunami | |
| maxInjuriesAmountOrder | integer | — | Descripción del número máximo de heridos. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| maxLatitude | number | — | Latitud máxima [−90, 90] | |
| maxLongitude | number | — | Longitud máxima [−180, 180] | |
| maxMaxWaterHeight | number | — | Máximo de la altura máxima del agua sobre el nivel del mar (m) | |
| maxNumRunups | integer | — | Número máximo de lugares de remonte asociados al evento | |
| maxRunupHoriz | number | — | Máximo de la distancia horizontal máxima de inundación tierra adentro (m) | |
| maxYear | integer | — | Año máximo | |
| minCauseCode | integer | — | Código de causa mínimo. 0-Desconocida, 1-Terremoto, 2-Terremoto dudoso, 3-Terremoto y deslizamiento de tierra, 4-Volcán y terremoto, 5-Volcán/terremoto/deslizamiento de tierra, 6-Volcán, 7-Volcán y deslizamiento de tierra, 8-Deslizamiento de tierra, 9-Meteorológica, 10-Explosión, 11-Marea astronómica. Ejemplo: 2,9,11 | |
| minDamageAmountOrder | integer | — | Descripción del daño mínimo. 0-Ninguno, 1-LIMITADO (<$1M), 2-MODERADO ($1–5M), 3-GRAVE ($5–25M), 4-EXTREMO (>$25M) | |
| minDamageAmountOrderTotal | integer | — | Descripción del daño total mínimo. 0-Ninguno, 1-LIMITADO (<$1M), 2-MODERADO ($1–5M), 3-GRAVE ($5–25M), 4-EXTREMO (>$25M) | |
| minDamageMillionsDollars | number | — | Daño mínimo en millones de dólares | |
| minDamageMillionsDollarsTotal | number | — | Daño total mínimo en millones de dólares (tsunami + evento de origen) | |
| minDeaths | integer | — | Número mínimo de muertes causadas por el tsunami | |
| minDeathsAmountOrder | integer | — | Descripción del número mínimo de muertes. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| minDeathsAmountOrderTotal | integer | — | Descripción del número total mínimo de muertes. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| minDeathsTotal | integer | — | Número total mínimo de muertes causadas por el tsunami y el evento de origen | |
| minEqMagnitude | number | — | Magnitud mínima del terremoto [0.0, 9.9] | |
| minEventValidity | integer | — | Validez mínima del evento. −1-errónea, 0-ninguna, 1-muy dudosa, 2-cuestionable, 3-probable, 4-definitiva | |
| minHousesDestroyed | integer | — | Número mínimo de viviendas destruidas | |
| minHousesDestroyedAmountOrder | integer | — | Descripción del número mínimo de viviendas destruidas. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| minId | integer | — | ID mínimo del evento | |
| minInjuries | integer | — | Número mínimo de heridos causados por el tsunami | |
| minInjuriesAmountOrder | integer | — | Descripción del número mínimo de heridos. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| minLatitude | number | — | Latitud mínima [−90, 90] | |
| minLongitude | number | — | Longitud mínima [−180, 180] | |
| minMaxWaterHeight | number | — | Mínimo de la altura máxima del agua sobre el nivel del mar (m) | |
| minNumRunups | integer | — | Número mínimo de lugares de remonte asociados al evento | |
| minRunupHoriz | number | — | Mínimo de la distancia horizontal máxima de inundación tierra adentro (m) | |
| minYear | integer | — | Año mínimo | |
| month | integer | — | Mes del evento (1–12) | |
| oceanicTsunami | boolean | — | Filtrar por tsunami oceánico (true/false) | |
| op | string | — | Operador lógico para los filtros | |
| order | string | — | Criterio de ordenación. Ejemplos: year:asc, month:desc Restricción de FORMATO y no un enum fijo: '<field>:asc' o '<field>:desc', p. ej., 'year:asc', 'month:desc'. El nombre del campo debe ser uno que NOAA reconozca; no se valida localmente. | |
| page | integer | — | Número de página | |
| regionCode | string | — | Código(s) de región. 87 - Alaska (incluidas las islas Aleutianas), 40 - Mar Negro y mar Caspio, 74 - Mar Caribe, 78 - África central, 84 - China/Corea del Norte y del Sur/Filipinas/Taiwán, 81 - Costa este de Australia/Nueva Zelanda/islas del Pacífico Sur, 75 - Costa este de EE. UU. y Canadá, 76 - Golfo de América/México, 80 - Hawái/atolón Johnston/isla Midway, 60 - Océano Índico (incluida la costa oeste de Australia), 83 - Indonesia (océano Pacífico) y Malasia, 85 - Japón, 86 - Kamchatka e islas Kuriles, 50 - Mar Mediterráneo, 82 - Nueva Caledonia/Nueva Guinea/islas Salomón/Vanuatu, 73 - Océano Atlántico nororiental, 72 - Océano Atlántico noroccidental, 30 - Mar Rojo y golfo Pérsico, 70 - Océano Atlántico suroriental, 71 - Océano Atlántico suroccidental, 77 - Costa oeste de África, 88 - Costa oeste de Norteamérica y Centroamérica, 89 - Costa oeste de Sudamérica. Ejemplo: 87,30,89 Lista separada por comas de códigos numéricos de región, p. ej., '87,30,89'. Significados: 30 Mar Rojo y golfo Pérsico; 40 Mar Negro y mar Caspio; 50 Mar Mediterráneo; 60 Océano Índico (incl. la costa oeste de Australia); 70 Océano Atlántico suroriental; 71 Océano Atlántico suroccidental; 72 Océano Atlántico noroccidental; 73 Océano Atlántico nororiental; 74 Mar Caribe; 75 Costa este de EE. UU. y Canadá; 76 Golfo de América/México; 77 Costa oeste de África; 78 África central; 80 Hawái/atolón Johnston/isla Midway; 81 Costa este de Australia/Nueva Zelanda/islas del Pacífico Sur; 82 Nueva Caledonia/Nueva Guinea/islas Salomón/Vanuatu; 83 Indonesia (océano Pacífico) y Malasia; 84 China/Corea del Norte y del Sur/Filipinas/Taiwán; 85 Japón; 86 Kamchatka e islas Kuriles; 87 Alaska (incl. las islas Aleutianas); 88 Costa oeste de Norteamérica y Centroamérica; 89 Costa oeste de Sudamérica. Se reenvía tal cual a NOAA NCEI. uno de: 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 | — | Estado/provincia/prefectura del lugar de remonte | |
| runupCountry | string | — | País del lugar de remonte | |
| runupDoubtful | string | — | Validez del remonte: n-OK, y-Dudosa, m-Meteorológica, a-Atmosférica Una sola letra: n = OK, y = Dudosa, m = Meteorológica, a = Atmosférica. uno de: n, y, m, a | |
| runupLocEnd | string | — | El nombre del lugar de remonte termina con Texto en FORMATO LIBRE: «el nombre del lugar de remonte termina con». | |
| runupLocInclude | string | — | El nombre del lugar de remonte incluye Texto en FORMATO LIBRE: «el nombre del lugar de remonte incluye». | |
| runupLocMatch | string | — | El nombre del lugar de remonte coincide exactamente con Texto en FORMATO LIBRE: «el nombre del lugar de remonte coincide exactamente con». | |
| runupLocNot | string | — | El nombre del lugar de remonte no incluye Texto en FORMATO LIBRE: «el nombre del lugar de remonte no incluye». | |
| runupLocStart | string | — | El nombre del lugar de remonte empieza por Texto en FORMATO LIBRE: «el nombre del lugar de remonte empieza por». | |
| runupMaxDamageAmountOrder | integer | — | Descripción del daño máximo en el remonte. 0-Ninguno, 1-LIMITADO (<$1M), 2-MODERADO ($1–5M), 3-GRAVE ($5–25M), 4-EXTREMO (>$25M) | |
| runupMaxDamageMillionsDollars | number | — | Daño máximo en el lugar de remonte (millones de $) | |
| runupMaxDeaths | integer | — | Número máximo de muertes en el lugar de remonte | |
| runupMaxDeathsAmountOrder | integer | — | Descripción del número máximo de muertes en el remonte. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| runupMaxDistance | integer | — | Distancia máxima del origen al remonte (km) | |
| runupMaxHeight | number | — | Máximo de la altura máxima del agua en el lugar de remonte (m) | |
| runupMaxHousesDestroyed | integer | — | Número máximo de viviendas destruidas en el lugar de remonte | |
| runupMaxHousesDestroyedAmountOrder | integer | — | Descripción del número máximo de viviendas destruidas en el remonte. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| runupMaxInjuries | integer | — | Número máximo de heridos en el lugar de remonte | |
| runupMaxInjuriesAmountOrder | integer | — | Descripción del número máximo de heridos en el remonte. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| runupMaxTravelTime | integer | — | Tiempo de propagación máximo (minutos) | |
| runupMaxTroughHt | number | — | Máximo del descenso máximo del agua por debajo del nivel del mar (m) | |
| runupMeasureType | integer | — | Tipo de medición: 1-Altura del agua según testigos, 2-Mareógrafo, 3-Mareógrafo de aguas profundas, 4-Altura del agua según estudio posterior, 5-Altura de remonte según estudio posterior, 6-Onda atmosférica, 7-Seiche, 8-Altura de remonte en puerto, 9-Marca de salpicadura, 10-Profundidad del flujo | |
| runupMinDamageAmountOrder | integer | — | Descripción del daño mínimo en el remonte. 0-Ninguno, 1-LIMITADO (<$1M), 2-MODERADO ($1–5M), 3-GRAVE ($5–25M), 4-EXTREMO (>$25M) | |
| runupMinDamageMillionsDollars | number | — | Daño mínimo en el lugar de remonte (millones de $) | |
| runupMinDeaths | integer | — | Número mínimo de muertes en el lugar de remonte | |
| runupMinDeathsAmountOrder | integer | — | Descripción del número mínimo de muertes en el remonte. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| runupMinDistance | integer | — | Distancia mínima del origen al remonte (km) | |
| runupMinHeight | number | — | Mínimo de la altura máxima del agua en el lugar de remonte (m) | |
| runupMinHousesDestroyed | integer | — | Número mínimo de viviendas destruidas en el lugar de remonte | |
| runupMinHousesDestroyedAmountOrder | integer | — | Descripción del número mínimo de viviendas destruidas en el remonte. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| runupMinInjuries | integer | — | Número mínimo de heridos en el lugar de remonte | |
| runupMinInjuriesAmountOrder | integer | — | Descripción del número mínimo de heridos en el remonte. 0-Ninguno, 1-Pocos (~1–50), 2-Algunos (~51–100), 3-Muchos (~101–1000), 4-Muchísimos (>1000) | |
| runupMinTravelTime | integer | — | Tiempo de propagación mínimo (minutos) | |
| runupMinTroughHt | number | — | Mínimo del descenso máximo del agua por debajo del nivel del mar (m) | |
| runupRegion | string | — | Código(s) de región del remonte. 87 - Alaska (incluidas las islas Aleutianas), 40 - Mar Negro y mar Caspio, 74 - Mar Caribe, 78 - África central, 84 - China/Corea del Norte y del Sur/Filipinas/Taiwán, 81 - Costa este de Australia/Nueva Zelanda/islas del Pacífico Sur, 75 - Costa este de EE. UU. y Canadá, 76 - Golfo de América/México, 80 - Hawái/atolón Johnston/isla Midway, 60 - Océano Índico (incluida la costa oeste de Australia), 83 - Indonesia (océano Pacífico) y Malasia, 85 - Japón, 86 - Kamchatka e islas Kuriles, 50 - Mar Mediterráneo, 82 - Nueva Caledonia/Nueva Guinea/islas Salomón/Vanuatu, 73 - Océano Atlántico nororiental, 72 - Océano Atlántico noroccidental, 30 - Mar Rojo y golfo Pérsico, 70 - Océano Atlántico suroriental, 71 - Océano Atlántico suroccidental, 77 - Costa oeste de África, 88 - Costa oeste de Norteamérica y Centroamérica, 89 - Costa oeste de Sudamérica. Ejemplo: 87,30,89 Códigos numéricos de región separados por comas: el mismo conjunto de valores y significados que regionCode, pero aplicado al lugar de remonte en lugar de al origen del tsunami. uno de: 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 | — | Filtrar por asociación con un tsunami | |
| year | integer | — | Año exacto del evento |