curl "https://api.occultapi.com/api/hazard/earthquake/" \
-H "X-API-Key: $OCCULT_API_KEY"United States Geological Survey की FDSN भूकंप सेवा के लिए पास-थ्रू प्रॉक्सी। यह पुराने और लगभग रीयल-टाइम भूकंपों का डेटा सेट है, कोई ज्योतिषीय गणना नहीं; यह यहाँ इसलिए है कि मेदिनी ज्योतिष और घटनाओं के मिलान का काम घटनाएँ और कुंडली डेटा, दोनों एक ही API से ले सके। हर क्वेरी पैरामीटर बिना बदले USGS को भेजा जाता है, इसलिए FDSN के सभी पैरामीटर काम करते हैं: ISO 8601 में `starttime` और `endtime` (डिफ़ॉल्ट: पिछले तीस दिन), `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` से आयताकार क्षेत्र, या `latitude`/`longitude` के साथ `maxradius` या `maxradiuskm` से वृत्ताकार क्षेत्र, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, PAGER `alertlevel`, `eventtype`, `reviewstatus`, अधिकतम 20000 तक `limit`, `offset` और `orderby`। उत्तर USGS का GeoJSON FeatureCollection है, ठीक वैसा जैसा USGS देता है: नतीजों के `count` वाला `metadata` ऑब्जेक्ट, और `features` सूची, जिसकी हर प्रविष्टि में `geometry` ([देशांतर, अक्षांश, km में गहराई]) और `properties` ऑब्जेक्ट होता है — तीव्रता, जगह का विवरण, epoch-मिलीसेकंड में `time`, महसूस होने की रिपोर्टें, Mercalli और Community तीव्रता, महत्व, सुनामी फ़्लैग और USGS पर घटना के पेज का URL। `format` पैरामीटर अनदेखा होता है और हमेशा geojson ही रहता है। USGS तक न पहुँच पाने पर एंडपॉइंट 503 लौटाता है।
| पैरामीटर | टाइप | उदाहरण | क्या करता है | |
|---|---|---|---|---|
| alertlevel | string | green | किसी विशेष PAGER चेतावनी स्तर वाली घटनाओं तक सीमित करेंइनमें से एक: green, orange, red, yellow | |
| catalog | string | — | किसी विशेष कैटलॉग की घटनाओं तक सीमित करें | |
| contributor | string | — | किसी विशेष योगदानकर्ता की दी गई घटनाओं तक सीमित करें | |
| endtime | string | 2024-12-31 | समय सीमा का अंत (ISO8601)। डिफ़ॉल्ट: वर्तमान समय ISO तारीख़, या तारीख़-समय। यह तारीख़ भी शामिल होती है। | |
| eventid | string | — | ID से कोई एक घटना चुनें (इससे includeallorigins और includeallmagnitudes अपने-आप लागू हो जाते हैं) फ़्री-फ़ॉर्म USGS घटना ID (जैसे 'us7000abcd'। इसे चुनने पर includeallorigins और includeallmagnitudes अपने-आप लागू हो जाते हैं। बिना बदले आगे भेजा जाता है। | |
| eventtype | string | — | किसी विशेष प्रकार की घटनाओं तक सीमित करें (जैसे 'earthquake' भूकंप के अलावा बाकी घटनाएँ हटा देता है) | |
| includeallmagnitudes | boolean | — | हर घटना की सभी तीव्रताएँ शामिल करें (डिफ़ॉल्ट: false) | |
| includeallorigins | boolean | — | हर घटना के सभी उद्गम शामिल करें (डिफ़ॉल्ट: false) | |
| includearrivals | boolean | — | फ़ेज़ आगमन शामिल करें (डिफ़ॉल्ट: false, अभी लागू नहीं) | |
| includedeleted | string | — | हटाई गई घटनाएँ शामिल करें (डिफ़ॉल्ट: false)। केवल हटाई गई घटनाएँ लौटाने के लिए 'only' इस्तेमाल करें एंडपॉइंट के अपने पैरामीटर विवरण में इसे बूलियन या 'only' बताया गया है (“हटाई गई घटनाएँ शामिल करें (डिफ़ॉल्ट: false)। केवल हटाई गई घटनाएँ लौटाने के लिए 'only' इस्तेमाल करें”। यहाँ कोई जाँच नहीं होती - वैल्यू सीधे USGS को जाती है, और जाँच वहीं होती है। इनमें से एक: true, false, only | |
| includesuperseded | boolean | — | पुराने, बदले जा चुके उत्पाद (superseded products) भी शामिल करें (डिफ़ॉल्ट: false)। केवल eventid के साथ काम करता है | |
| latitude | number | 26.9124 | वृत्ताकार खोज के केंद्र का अक्षांश [-90, 90]। साथ में देशांतर और maxradius/maxradiuskm भी ज़रूरी हैं वृत्ताकार खोज का केंद्र, देशांतर और maxradiuskm के साथ इस्तेमाल होता है। | |
| limit | integer | 20 | लौटाई जाने वाली घटनाओं की अधिकतम संख्या [1, 20000] प्रति पेज कितने रिकॉर्ड लौटाने हैं। | |
| longitude | number | 75.7873 | वृत्ताकार खोज के केंद्र का देशांतर [-180, 180] | |
| maxalertlevel | string | green | केवल वे घटनाएँ जिनका PAGER चेतावनी स्तर इस वैल्यू से कम या बराबर (≤) होइनमें से एक: green, orange, red, yellow | |
| maxcdi | number | — | अधिकतम Community Determined Intensity (DYFI) [0, 12] | |
| maxdepth | number | — | km में अधिकतम गहराई [-100, 1000] | |
| maxgap | number | — | अंशों में अधिकतम दिगंशीय अंतराल [0, 360] | |
| maxlatitude | number | — | आयताकार क्षेत्र की उत्तरी सीमा [-90, 90] | |
| maxlongitude | number | — | आयताकार क्षेत्र की पूर्वी सीमा [-360, 360] | |
| maxmagnitude | number | 9 | अधिकतम तीव्रता | |
| maxmmi | number | — | अधिकतम Modified Mercalli Intensity (ShakeMap) [0, 12] | |
| maxradius | number | — | केंद्र बिंदु से अंशों में अधिकतम त्रिज्या [0, 180]। इसे और maxradiuskm को एक साथ नहीं भेज सकते | |
| maxradiuskm | number | 500 | केंद्र बिंदु से km में अधिकतम त्रिज्या [0, 20001.6]। इसे और maxradius को एक साथ नहीं भेज सकते अक्षांश/देशांतर के आसपास किलोमीटर में खोज त्रिज्या। | |
| maxsig | integer | — | अधिकतम महत्व | |
| minalertlevel | string | green | केवल वे घटनाएँ जिनका PAGER चेतावनी स्तर इस वैल्यू से ज़्यादा या बराबर (≥) होइनमें से एक: green, orange, red, yellow | |
| mincdi | number | — | न्यूनतम Community Determined Intensity (DYFI) | |
| mindepth | number | — | km में न्यूनतम गहराई [-100, 1000] | |
| minfelt | integer | — | DYFI उत्तरों की न्यूनतम संख्या [1, ∞] | |
| mingap | number | — | अंशों में न्यूनतम दिगंशीय अंतराल [0, 360] | |
| minlatitude | number | — | आयताकार क्षेत्र की दक्षिणी सीमा [-90, 90] | |
| minlongitude | number | — | आयताकार क्षेत्र की पश्चिमी सीमा [-360, 360]। minlongitude < -180 या maxlongitude > 180 देकर आयत अंतरराष्ट्रीय तिथि रेखा (date line) के पार भी जा सकता है | |
| minmagnitude | number | 6 | न्यूनतम तीव्रता रिक्टर तीव्रता की निचली सीमा। 6 या उससे ज़्यादा तीव्रता वाला भूकंप बड़ा माना जाता है। | |
| minsig | integer | — | न्यूनतम महत्व | |
| nodata | integer | 204 | कोई डेटा न मिलने पर लौटाया जाने वाला HTTP स्टेटस कोड (204 या 404)इनमें से एक: 204, 404 | |
| offset | integer | 0 | इस क्रम संख्या से नतीजे लौटाएँ (गिनती 1 से, 1-based) पेजिंग के लिए कितने रिकॉर्ड छोड़ने हैं। | |
| orderby | string | magnitude | नतीजों को किस फ़ील्ड के हिसाब से क्रम में रखना हैइनमें से एक: magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | इस उत्पाद कोड से जुड़ी घटना लौटाएँ फ़्री-फ़ॉर्म USGS उत्पाद कोड। बिना बदले आगे भेजा जाता है। | |
| producttype | string | — | इस उत्पाद प्रकार वाली घटनाओं तक सीमित करें (जैसे moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | किसी विशेष समीक्षा स्थिति वाली घटनाओं तक सीमित करेंइनमें से एक: automatic, reviewed | |
| starttime | string | 2024-01-01 | समय सीमा का आरंभ (ISO8601, जैसे 2022-01-01 या 2022-01-01T00:00:00)। डिफ़ॉल्ट: अभी - 30 दिन ISO तारीख़, या तारीख़-समय। यह तारीख़ भी शामिल होती है। | |
| updatedafter | string | — | इस समय के बाद अपडेट हुई घटनाओं तक सीमित करें (ISO8601) फ़ॉर्मैट की शर्त। ISO 8601। बिना बदले USGS को आगे भेजा जाता है। |