Carregando o Playground
curl "https://api.occultapi.com/api/hazard/earthquake/" \
-H "X-API-Key: $OCCULT_API_KEY"Um proxy de repasse para o serviço de eventos sísmicos FDSN do United States Geological Survey. Este é um conjunto de dados sismológicos históricos e quase em tempo real, não um cálculo astrológico; ele existe para que trabalhos de astrologia mundana e de correlação de eventos obtenham os eventos e os dados de mapas pela mesma API. Todo parâmetro de consulta é repassado ao USGS sem alterações, então o vocabulário FDSN completo se aplica: `starttime` e `endtime` em ISO 8601 (por padrão, os últimos trinta dias), uma caixa delimitadora via `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` ou um círculo via `latitude`/`longitude` com `maxradius` ou `maxradiuskm`, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, `alertlevel` do PAGER, `eventtype`, `reviewstatus`, `limit` até 20000, `offset` e `orderby`. A resposta é a FeatureCollection GeoJSON do USGS tal como retornada: um objeto `metadata` com o `count` de resultados e uma lista `features` em que cada entrada tem uma `geometry` que fornece [longitude, latitude, profundidade em km] e um objeto `properties` com magnitude, descrição do local, `time` em milissegundos desde a época Unix, relatos de quem sentiu o tremor, intensidade de Mercalli e intensidade determinada pela comunidade, significância, uma flag de tsunami e a URL da página do evento no USGS. O parâmetro `format` é ignorado e sempre forçado para geojson. Se o USGS não puder ser acessado, o endpoint retorna 503.
| Parâmetro | Tipo | Exemplo | Para que serve | |
|---|---|---|---|---|
| alertlevel | string | green | Limitar a eventos com um nível de alerta PAGER específicoum destes: green, orange, red, yellow | |
| catalog | string | — | Limitar a eventos de um catálogo específico | |
| contributor | string | — | Limitar a eventos fornecidos por um contribuidor específico | |
| endtime | string | 2024-12-31 | Fim da janela de tempo (ISO8601). Padrão: o momento atual Data ISO ou uma data e hora. Inclusivo. | |
| eventid | string | — | Selecionar um evento específico por ID (implica includeallorigins e includeallmagnitudes) ID de evento do USGS em FORMATO LIVRE (por exemplo 'us7000abcd'. Selecionar um implica includeallorigins e includeallmagnitudes. Repassado sem alterações. | |
| eventtype | string | — | Limitar a eventos de um tipo específico (por exemplo 'earthquake' filtra os eventos que não são terremotos) | |
| includeallmagnitudes | boolean | — | Incluir todas as magnitudes de cada evento (padrão: false) | |
| includeallorigins | boolean | — | Incluir todas as origens de cada evento (padrão: false) | |
| includearrivals | boolean | — | Incluir chegadas de fase (padrão: false, NÃO IMPLEMENTADO NO MOMENTO) | |
| includedeleted | string | — | Incluir eventos excluídos (padrão: false). Use 'only' para retornar apenas eventos excluídos A descrição do parâmetro no próprio endpoint o documenta como booleano mais 'only' ("Incluir eventos excluídos (padrão: false). Use 'only' para retornar apenas eventos excluídos". Não há verificação local - o valor é repassado ao USGS, que é responsável pela validação. um destes: true, false, only | |
| includesuperseded | boolean | — | Incluir produtos substituídos (padrão: false). Só funciona com eventid | |
| latitude | number | 26.9124 | Latitude do centro para busca circular [-90, 90]. Requer longitude e maxradius/maxradiuskm Centro de uma busca circular, usado com longitude e maxradiuskm. | |
| limit | integer | 20 | Número máximo de eventos a retornar [1, 20000] Quantos registros retornar por página. | |
| longitude | number | 75.7873 | Longitude do centro para busca circular [-180, 180] | |
| maxalertlevel | string | green | Limitar a eventos com nível de alerta PAGER ≤ este valorum destes: green, orange, red, yellow | |
| maxcdi | number | — | Intensidade máxima determinada pela comunidade (DYFI) [0, 12] | |
| maxdepth | number | — | Profundidade máxima em km [-100, 1000] | |
| maxgap | number | — | Gap azimutal máximo em graus [0, 360] | |
| maxlatitude | number | — | Limite norte da caixa delimitadora [-90, 90] | |
| maxlongitude | number | — | Limite leste da caixa delimitadora [-360, 360] | |
| maxmagnitude | number | 9 | Magnitude máxima | |
| maxmmi | number | — | Intensidade máxima na escala de Mercalli Modificada (ShakeMap) [0, 12] | |
| maxradius | number | — | Raio máximo em graus a partir do ponto central [0, 180]. Mutuamente exclusivo com maxradiuskm | |
| maxradiuskm | number | 500 | Raio máximo em km a partir do ponto central [0, 20001.6]. Mutuamente exclusivo com maxradius Raio de busca em quilômetros em torno de latitude/longitude. | |
| maxsig | integer | — | Significância máxima | |
| minalertlevel | string | green | Limitar a eventos com nível de alerta PAGER ≥ este valorum destes: green, orange, red, yellow | |
| mincdi | number | — | Intensidade mínima determinada pela comunidade (DYFI) | |
| mindepth | number | — | Profundidade mínima em km [-100, 1000] | |
| minfelt | integer | — | Número mínimo de respostas DYFI [1, ∞] | |
| mingap | number | — | Gap azimutal mínimo em graus [0, 360] | |
| minlatitude | number | — | Limite sul da caixa delimitadora [-90, 90] | |
| minlongitude | number | — | Limite oeste da caixa delimitadora [-360, 360]. Retângulos podem cruzar a linha internacional de data usando minlongitude < -180 ou maxlongitude > 180 | |
| minmagnitude | number | 6 | Magnitude mínima Magnitude Richter mínima. A partir de 6, é um grande terremoto. | |
| minsig | integer | — | Significância mínima | |
| nodata | integer | 204 | Código de status HTTP retornado quando nenhum dado é encontrado (204 ou 404)um destes: 204, 404 | |
| offset | integer | 0 | Retornar resultados a partir desta posição (baseada em 1) Quantos registros pular, para paginação. | |
| orderby | string | magnitude | Ordenar resultados por campoum destes: magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | Retornar o evento associado a este código de produto Código de produto do USGS em FORMATO LIVRE. Repassado sem alterações. | |
| producttype | string | — | Limitar a eventos com este tipo de produto (por exemplo moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | Limitar a eventos com um status de revisão específicoum destes: automatic, reviewed | |
| starttime | string | 2024-01-01 | Início da janela de tempo (ISO8601, por exemplo 2022-01-01 ou 2022-01-01T00:00:00). Padrão: AGORA - 30 dias Data ISO ou uma data e hora. Inclusivo. | |
| updatedafter | string | — | Limitar a eventos atualizados após este momento (ISO8601) Restrição de FORMATO. ISO 8601. Repassado sem alterações ao USGS. |