/api/hazard/earthquake/1 CreditErdbebenereignisse
Ein durchreichender Proxy für den FDSN-Dienst des United States Geological Survey für Erdbebenereignisse. Dies ist ein historischer und nahezu in Echtzeit aktualisierter seismologischer Datensatz, keine astrologische Berechnung. Er ist hier, damit Mundanastrologie und Ereigniskorrelation die Ereignisse und die Horoskopdaten über eine einzige API beziehen können. Jeder Query-Parameter wird unverändert an USGS weitergereicht, daher gilt das gesamte FDSN-Vokabular: `starttime` und `endtime` in ISO 8601 (standardmäßig die letzten dreißig Tage), ein Begrenzungsrahmen über `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` oder ein Kreis über `latitude`/`longitude` mit `maxradius` oder `maxradiuskm`, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, PAGER-`alertlevel`, `eventtype`, `reviewstatus`, `limit` bis 20000, `offset` und `orderby`. Die Antwort ist die GeoJSON-FeatureCollection von USGS in unveränderter Form: ein Objekt `metadata` mit der Ergebnisanzahl `count` und eine Liste `features`. Jeder Eintrag darin hat eine `geometry` mit [Längengrad, Breitengrad, Tiefe in km] und ein Objekt `properties` mit Magnitude, Ortsbeschreibung, `time` in Epoch-Millisekunden, Wahrnehmungsberichten, Mercalli- und Community-Intensität, Bedeutsamkeit, einem Tsunami-Flag und der URL der USGS-Ereignisseite. Der Parameter `format` wird ignoriert und immer auf geojson gesetzt. Ist USGS nicht erreichbar, liefert der Endpoint 503.
https://api.occultapi.com/api/hazard/earthquake/Authentifizierung
Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.
X-API-Key: yt_live_a1b2c3d4_…Query-Parameter (42)
Sie stehen in der URL. Alle sind optional, sofern nicht anders markiert, und lassen sich kombinieren: erst filtern, dann blättern, dann sortieren.
| Parameter | Typ | Beispiel | Bedeutung | |
|---|---|---|---|---|
| alertlevel | string | green | Auf Ereignisse mit einer bestimmten PAGER-Alarmstufe beschränkenerlaubt: green, orange, red, yellow | |
| catalog | string | — | Auf Ereignisse aus einem bestimmten Katalog beschränken | |
| contributor | string | — | Auf Ereignisse eines bestimmten Datenlieferanten beschränken | |
| endtime | string | 2024-12-31 | Ende des Zeitfensters (ISO8601). Standard: aktueller Zeitpunkt ISO-Datum oder Datum mit Uhrzeit. Einschließlich. | |
| eventid | string | — | Ein bestimmtes Ereignis per ID auswählen (impliziert includeallorigins und includeallmagnitudes) FREITEXT-Ereignis-ID von USGS (z. B. 'us7000abcd'). Die Auswahl einer ID impliziert includeallorigins und includeallmagnitudes. Wird unverändert weitergereicht. | |
| eventtype | string | — | Auf Ereignisse eines bestimmten Typs beschränken (z. B. schließt 'earthquake' alle Ereignisse aus, die keine Erdbeben sind) | |
| includeallmagnitudes | boolean | — | Alle Magnituden für jedes Ereignis einbeziehen (Standard: false) | |
| includeallorigins | boolean | — | Alle Ursprünge für jedes Ereignis einbeziehen (Standard: false) | |
| includearrivals | boolean | — | Phaseneinsätze einbeziehen (Standard: false, DERZEIT NICHT IMPLEMENTIERT) | |
| includedeleted | string | — | Gelöschte Ereignisse einbeziehen (Standard: false). Mit 'only' werden nur gelöschte Ereignisse geliefert Die eigene Parameterbeschreibung des Endpoints dokumentiert ihn als boolesch plus 'only' ("Include deleted events (default: false). Use 'only' to return only deleted events"). Eine lokale Prüfung gibt es nicht – der Wert wird an USGS weitergereicht, und USGS übernimmt die Validierung. erlaubt: true, false, only | |
| includesuperseded | boolean | — | Ersetzte Produkte einbeziehen (Standard: false). Funktioniert nur mit eventid | |
| latitude | number | 26.9124 | Breitengrad des Mittelpunkts für die Kreissuche [-90, 90]. Erfordert longitude und maxradius/maxradiuskm Mittelpunkt einer Kreissuche, verwendet mit longitude und maxradiuskm. | |
| limit | integer | 20 | Max. Anzahl der gelieferten Ereignisse [1, 20000] Anzahl der Einträge pro Seite. | |
| longitude | number | 75.7873 | Längengrad des Mittelpunkts für die Kreissuche [-180, 180] | |
| maxalertlevel | string | green | Auf Ereignisse mit PAGER-Alarmstufe ≤ diesem Wert beschränkenerlaubt: green, orange, red, yellow | |
| maxcdi | number | — | Maximale Community Determined Intensity (DYFI) [0, 12] | |
| maxdepth | number | — | Max. Tiefe in km [-100, 1000] | |
| maxgap | number | — | Max. azimutale Lücke in Grad [0, 360] | |
| maxlatitude | number | — | Nördliche Grenze des Begrenzungsrahmens [-90, 90] | |
| maxlongitude | number | — | Östliche Grenze des Begrenzungsrahmens [-360, 360] | |
| maxmagnitude | number | 9 | Max. Magnitude | |
| maxmmi | number | — | Maximale Modified Mercalli Intensity (ShakeMap) [0, 12] | |
| maxradius | number | — | Max. Radius in Grad um den Mittelpunkt [0, 180]. Nicht zusammen mit maxradiuskm verwendbar | |
| maxradiuskm | number | 500 | Max. Radius in km um den Mittelpunkt [0, 20001.6]. Nicht zusammen mit maxradius verwendbar Suchradius in Kilometern um latitude/longitude. | |
| maxsig | integer | — | Max. Bedeutsamkeit | |
| minalertlevel | string | green | Auf Ereignisse mit PAGER-Alarmstufe ≥ diesem Wert beschränkenerlaubt: green, orange, red, yellow | |
| mincdi | number | — | Minimale Community Determined Intensity (DYFI) | |
| mindepth | number | — | Min. Tiefe in km [-100, 1000] | |
| minfelt | integer | — | Mindestanzahl an DYFI-Rückmeldungen [1, ∞] | |
| mingap | number | — | Min. azimutale Lücke in Grad [0, 360] | |
| minlatitude | number | — | Südliche Grenze des Begrenzungsrahmens [-90, 90] | |
| minlongitude | number | — | Westliche Grenze des Begrenzungsrahmens [-360, 360]. Rechtecke können die Datumsgrenze überqueren, wenn minlongitude < -180 oder maxlongitude > 180 verwendet wird | |
| minmagnitude | number | 6 | Min. Magnitude Mindestmagnitude auf der Richterskala. Ab 6 gilt ein Erdbeben als stark. | |
| minsig | integer | — | Min. Bedeutsamkeit | |
| nodata | integer | 204 | HTTP-Statuscode, der geliefert wird, wenn keine Daten gefunden werden (204 oder 404)erlaubt: 204, 404 | |
| offset | integer | 0 | Ergebnisse ab dieser Position liefern (1-basiert) Anzahl der zu überspringenden Einträge, für die Paginierung. | |
| orderby | string | magnitude | Ergebnisse nach Feld sortierenerlaubt: magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | Das Ereignis liefern, das zu diesem Produktcode gehört FREITEXT-Produktcode von USGS. Wird unverändert weitergereicht. | |
| producttype | string | — | Auf Ereignisse mit diesem Produkttyp beschränken (z. B. moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | Auf Ereignisse mit einem bestimmten Prüfstatus beschränkenerlaubt: automatic, reviewed | |
| starttime | string | 2024-01-01 | Beginn des Zeitfensters (ISO8601, z. B. 2022-01-01 oder 2022-01-01T00:00:00). Standard: JETZT minus 30 Tage ISO-Datum oder Datum mit Uhrzeit. Einschließlich. | |
| updatedafter | string | — | Auf Ereignisse beschränken, die nach diesem Zeitpunkt aktualisiert wurden (ISO8601) FORMATVORGABE. ISO 8601. Wird unverändert an USGS weitergereicht. |
Beispielanfrage
curl "https://api.occultapi.com/api/hazard/earthquake/" \
-H "X-API-Key: $OCCULT_API_KEY"Antwort
{
"_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."
}Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.
Fehler
Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.