/api/hazard/earthquake/1 créditSéismes
Un proxy transparent vers le service d’événements sismiques FDSN de l’United States Geological Survey. Il s’agit d’un jeu de données sismologiques historiques et en quasi temps réel, et non d’un calcul astrologique ; il est fourni pour que l’astrologie mondiale et les travaux de corrélation d’événements puissent récupérer les événements et les données de thème via une seule API. Chaque paramètre de requête est transmis tel quel à l’USGS : tout le vocabulaire FDSN s’applique donc. `starttime` et `endtime` en ISO 8601 (par défaut, les trente derniers jours), un rectangle englobant via `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` ou un cercle via `latitude`/`longitude` avec `maxradius` ou `maxradiuskm`, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, `alertlevel` PAGER, `eventtype`, `reviewstatus`, `limit` jusqu’à 20000, `offset` et `orderby`. La réponse est la FeatureCollection GeoJSON de l’USGS, telle quelle : un objet `metadata` avec le nombre de résultats (`count`), et une liste `features` dont chaque entrée comporte une `geometry` donnant [longitude, latitude, profondeur en km] et un objet `properties` avec la magnitude, la description du lieu, le `time` en millisecondes depuis l’époque Unix, les témoignages de ressenti, les intensités Mercalli et Community, l’importance, un indicateur de tsunami et l’URL de la page de l’événement sur le site de l’USGS. Le paramètre `format` est ignoré et toujours forcé à geojson. Si l’USGS est injoignable, l’endpoint renvoie une erreur 503.
https://api.occultapi.com/api/hazard/earthquake/Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…Paramètres de requête (42)
Ils se passent dans l’URL. Tous sont facultatifs sauf mention contraire, et ils se combinent : filtrage, puis pagination, puis tri.
| Paramètre | Type | Exemple | Rôle | |
|---|---|---|---|---|
| alertlevel | string | green | Limiter aux événements ayant un niveau d’alerte PAGER donnéau choix : green, orange, red, yellow | |
| catalog | string | — | Limiter aux événements d’un catalogue donné | |
| contributor | string | — | Limiter aux événements fournis par un contributeur donné | |
| endtime | string | 2024-12-31 | Fin de la plage temporelle (ISO8601). Par défaut : l’heure actuelle Date ISO, ou date-heure. Incluse. | |
| eventid | string | — | Sélectionner un événement précis par son ID (implique includeallorigins et includeallmagnitudes) ID d’événement USGS LIBRE (p. ex. 'us7000abcd'. Sélectionner un événement implique includeallorigins et includeallmagnitudes. Transmis tel quel. | |
| eventtype | string | — | Limiter aux événements d’un type donné (p. ex. 'earthquake' exclut les événements qui ne sont pas des séismes) | |
| includeallmagnitudes | boolean | — | Inclure toutes les magnitudes de chaque événement (par défaut : false) | |
| includeallorigins | boolean | — | Inclure toutes les origines de chaque événement (par défaut : false) | |
| includearrivals | boolean | — | Inclure les arrivées de phases (par défaut : false, NON IMPLÉMENTÉ ACTUELLEMENT) | |
| includedeleted | string | — | Inclure les événements supprimés (par défaut : false). Utilisez 'only' pour ne renvoyer que les événements supprimés Selon la description du paramètre fournie par l’endpoint lui-même, c’est un booléen, plus la valeur 'only' ("Include deleted events (default: false). Use 'only' to return only deleted events". Aucune vérification n’est faite localement - la valeur est transmise à l’USGS, qui se charge de la valider. au choix : true, false, only | |
| includesuperseded | boolean | — | Inclure les produits remplacés (par défaut : false). Ne fonctionne qu’avec eventid | |
| latitude | number | 26.9124 | Latitude du centre pour une recherche circulaire [-90, 90]. Nécessite longitude et maxradius/maxradiuskm Centre d’une recherche circulaire, utilisé avec longitude et maxradiuskm. | |
| limit | integer | 20 | Nombre maximal d’événements à renvoyer [1, 20000] Nombre d’enregistrements à renvoyer par page. | |
| longitude | number | 75.7873 | Longitude du centre pour une recherche circulaire [-180, 180] | |
| maxalertlevel | string | green | Limiter aux événements dont le niveau d’alerte PAGER est ≤ cette valeurau choix : green, orange, red, yellow | |
| maxcdi | number | — | Intensité Community Determined (DYFI) maximale [0, 12] | |
| maxdepth | number | — | Profondeur maximale en km [-100, 1000] | |
| maxgap | number | — | Écart azimutal maximal en degrés [0, 360] | |
| maxlatitude | number | — | Limite nord du rectangle englobant [-90, 90] | |
| maxlongitude | number | — | Limite est du rectangle englobant [-360, 360] | |
| maxmagnitude | number | 9 | Magnitude maximale | |
| maxmmi | number | — | Intensité de Mercalli modifiée (ShakeMap) maximale [0, 12] | |
| maxradius | number | — | Rayon maximal en degrés autour du point central [0, 180]. Incompatible avec maxradiuskm | |
| maxradiuskm | number | 500 | Rayon maximal en km autour du point central [0, 20001.6]. Incompatible avec maxradius Rayon de recherche en kilomètres autour de latitude/longitude. | |
| maxsig | integer | — | Importance maximale | |
| minalertlevel | string | green | Limiter aux événements dont le niveau d’alerte PAGER est ≥ cette valeurau choix : green, orange, red, yellow | |
| mincdi | number | — | Intensité Community Determined (DYFI) minimale | |
| mindepth | number | — | Profondeur minimale en km [-100, 1000] | |
| minfelt | integer | — | Nombre minimal de réponses DYFI [1, ∞] | |
| mingap | number | — | Écart azimutal minimal en degrés [0, 360] | |
| minlatitude | number | — | Limite sud du rectangle englobant [-90, 90] | |
| minlongitude | number | — | Limite ouest du rectangle englobant [-360, 360]. Les rectangles peuvent franchir la ligne de changement de date en utilisant minlongitude < -180 ou maxlongitude > 180 | |
| minmagnitude | number | 6 | Magnitude minimale Magnitude de Richter minimale. À partir de 6, il s’agit d’un séisme majeur. | |
| minsig | integer | — | Importance minimale | |
| nodata | integer | 204 | Code de statut HTTP renvoyé lorsqu’aucune donnée n’est trouvée (204 ou 404)au choix : 204, 404 | |
| offset | integer | 0 | Renvoyer les résultats à partir de ce rang (à partir de 1) Nombre d’enregistrements à sauter, pour la pagination. | |
| orderby | string | magnitude | Trier les résultats par champau choix : magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | Renvoyer l’événement associé à ce code de produit Code de produit USGS LIBRE. Transmis tel quel. | |
| producttype | string | — | Limiter aux événements ayant ce type de produit (p. ex. moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | Limiter aux événements ayant un statut de révision donnéau choix : automatic, reviewed | |
| starttime | string | 2024-01-01 | Début de la plage temporelle (ISO8601, p. ex. 2022-01-01 ou 2022-01-01T00:00:00). Par défaut : MAINTENANT - 30 jours Date ISO, ou date-heure. Incluse. | |
| updatedafter | string | — | Limiter aux événements mis à jour après cette date (ISO8601) Contrainte de FORMAT. ISO 8601. Transmis tel quel à l’USGS. |
Exemple de requête
curl "https://api.occultapi.com/api/hazard/earthquake/" \
-H "X-API-Key: $OCCULT_API_KEY"Réponse
{
"_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."
}Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.