publicAlerts एंडपॉइंट, मौसम से जुड़ी किसी खास घटना के बारे में सूचनाएं देता है. ये सूचनाएं, राष्ट्रीय और अंतरराष्ट्रीय स्तर की भरोसेमंद एजेंसियां जारी करती हैं. इन सूचनाओं में अहम जानकारी होती है, जो लोगों की जान बचा सकती है.
यह एंडपॉइंट, किसी अक्षांश और देशांतर के लिए रीयल टाइम में मौसम से जुड़ी चेतावनियां दिखाता है. मौसम से जुड़े इन इवेंट के बारे में जानकारी दी जा सकती है:
- बारिश: बारिश, बर्फ़बारी, ओले, सूखा वगैरह
- तापमान में अचानक होने वाले बदलाव: सर्दी, गर्मी, जमना, पाला, ठंड, और नमी
- हवा और तूफ़ान से जुड़ी घटनाएं: बर्फ़ानी तूफ़ान, चक्रवात, बवंडर, उष्णकटिबंधीय तूफ़ान, बिजली के साथ होने वाली बारिश वगैरह
- विज़िबिलिटी से जुड़ी समस्याएं: कोहरा, धूल भरी आंधी, और बर्फ़ीली आंधी
- पानी से जुड़ी आपदाएं: बाढ़, सुनामी, तूफ़ान के दौरान समुद्र का पानी तेज़ी से बढ़ना, तटीय इलाकों में खतरा वगैरह
- जियोफ़िज़िकल और जियोलॉजिकल इवेंट: भूकंप, भूस्खलन, और ज्वालामुखी से जुड़ी गतिविधि
- आग लगने की घटनाएं: जंगल में आग लगना, आग लगने के लिए मौसम की स्थिति, और अन्य जानकारी
मौसम से जुड़े इवेंट की पूरी सूची देखने के लिए, मौसम से जुड़े इवेंट के टाइप देखें.
चेतावनी में स्थानीय भाषा में ब्यौरे शामिल हो सकते हैं या नहीं भी हो सकते हैं. यह इस बात पर निर्भर करता है कि डेटा सोर्स से क्या उपलब्ध है. डेटा सोर्स से जुड़ी पाबंदियों की वजह से, जानकारी को बिना किसी बदलाव के (रॉ कॉन्टेंट) दिखाया जाता है. मौसम की चेतावनी देने वाले सोर्स के बारे में ज़्यादा जानकारी के लिए, डेटा सोर्स देखें.
एपीआई, मौसम से जुड़ी किसी सूचना के लिए यह जानकारी दिखाता है:
- चेतावनी से जुड़ा मौसम का इवेंट टाइप
- उन इलाकों की सूची जिन पर असर पड़ा है. साथ ही, उन इलाकों की भौगोलिक सीमाओं को तय करने वाले निर्देशांक
- मौसम की घटना के बारे में एक वाक्य में खास जानकारी
- गंभीरता, पुष्टि, और प्राथमिकता के लेवल
- टारगेट ऑडियंस के लिए, कार्रवाई करने का सुझाव देने वाले निर्देशों के बारे में जानकारी
- सुरक्षा से जुड़े सुझाव
- सूचना के शुरू और खत्म होने का समय
- पब्लिश करने वाली संस्था का नाम और वेबसाइट
APIs Explorer की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
मौसम से जुड़ी सूचना पाने के अनुरोधों के बारे में जानकारी
मौसम की चेतावनी से जुड़ी जानकारी का अनुरोध करने के लिए, इस यूआरएल पर एचटीटीपी GET अनुरोध भेजें:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
अनुरोध के यूआरएल पैरामीटर में, जगह के अक्षांश और देशांतर के निर्देशांक शामिल करें.
मौसम से जुड़ी चेतावनियों के जवाबों के बारे में जानकारी
Weather API, रिस्पॉन्स बॉडी में ये फ़ील्ड दिखाता है:
| फ़ील्ड | टाइप | ब्यौरा | ज़रूरी है या ज़रूरी नहीं है |
|---|---|---|---|
alertId |
स्ट्रिंग | अलर्ट आईडी. यह जानकारी, डेटा उपलब्ध कराने वाली कंपनी की वेबसाइट पर भी मिल सकती है. | ज़रूरी है |
alertTitle |
स्ट्रिंग | सूचना का टाइटल, जिसमें मौसम की जानकारी दी गई हो. ध्यान दें: यह ऐसी स्ट्रिंग है जिसका अनुवाद तब किया जाता है, जब अनुरोध में भाषा कोड पैरामीटर शामिल किया जाता है. |
ज़रूरी है |
eventType |
Enum | यह सूचना से जुड़ा मौसम का इवेंट टाइप है. मौसम के इवेंट टाइप की पूरी सूची देखने के लिए, मौसम के इवेंट टाइप देखें. |
ज़रूरी है |
areaName |
स्ट्रिंग | उस भौगोलिक इलाके का नाम जिस पर सूचना का असर पड़ा है. इसमें अनुरोध की गई जगह शामिल है. | ज़रूरी है |
polygon |
स्ट्रिंग | ये निर्देशांक, सूचना के डाइमेंशनल एरिया को दिखाते हैं. | वैकल्पिक |
description |
स्ट्रिंग | कम शब्दों वाला ऐसा वाक्यांश जो इवेंट के ब्यौरे के बारे में खास जानकारी देता है. यह जानकारी, चुनी गई भाषा में होती है. उदाहरण के लिए, "तूफ़ान की चेतावनी". | वैकल्पिक |
severity |
Enum | सूचना की गंभीरता का लेवल:
|
वैकल्पिक |
certainty |
Enum | सूचना के सटीक होने का लेवल:
|
वैकल्पिक |
urgency |
Enum | सूचना की गंभीरता का लेवल:
|
वैकल्पिक |
instruction |
स्ट्रिंग | टारगेट ऑडियंस के लिए, रिस्पॉन्सिव ऐक्शन निर्देशों की जानकारी. | वैकल्पिक |
safetyRecommendations |
स्ट्रिंग | सार्वजनिक स्वास्थ्य विभाग के कोड के आधार पर सुरक्षा से जुड़े सुझाव. इसमें टॉप-लेवल के निर्देश और ज़्यादा जानकारी वाला सबटेक्स्ट शामिल होता है. | वैकल्पिक |
timezoneOffset |
स्ट्रिंग | इवेंट का टाइमज़ोन ऑफ़सेट, +/-HH:MM फ़ॉर्मैट में. | ज़रूरी है |
startTime |
DateTime | सूचना में दी गई जानकारी के लिए, Epoch की तारीख और समय (यूटीसी समय). | वैकल्पिक |
expirationTime |
DateTime | वह तारीख और समय (यूटीसी समय), जब सूचना खत्म होने की उम्मीद है. यह वैल्यू, लंबे समय तक चलने वाले इवेंट के लिए शून्य हो सकती है. ऐसे मामले में, हेडलाइन से पता चलेगा कि इवेंट "लागू है". | वैकल्पिक |
dataSource |
Enum | अधिकार से जुड़ी जानकारी, जिसमें पब्लिशर, नाम, और यूआरएल शामिल है. | ज़रूरी है |
regionCode |
Enum | अनुरोध की गई जगह का क्षेत्र कोड. | वैकल्पिक |
डेटा सोर्स
मौसम की चेतावनियों वाला एंडपॉइंट, यहां दी गई टेबल में शामिल कंपनियों का पब्लिश किया गया डेटा दिखाता है. अनुरोध में दिए गए अक्षांश और देशांतर के निर्देशांकों के आधार पर, जवाब के मुख्य हिस्से में स्थानीय सरकारी विभाग से मिला डेटा दिखता है.
फ़ीड में शामिल किए गए सेवा देने वाले लोग या कंपनियां, Google की Public Alerts से जुड़े दिशा-निर्देशों का पालन करती हैं. Google, सेवा देने वाली कंपनियों की सूची को किसी भी समय अपडेट कर सकता है.
एट्रिब्यूशन
डेटा दिखाने वाले सभी डिसप्ले पर, ग्राहक के ऐप्लिकेशन में dataSource फ़ील्ड का इस्तेमाल करके, ओरिजनल सोर्स का एट्रिब्यूशन शामिल करना ज़रूरी है:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
एट्रिब्यूशन में, डेटा सोर्स का पूरा नाम शामिल होना चाहिए. यह नाम, name फ़ील्ड में दिया गया है. साथ ही, इसमें authorityUri फ़ील्ड में दिए गए यूआरएल का इस्तेमाल करके, डेटा सोर्स का हाइपरलिंक भी शामिल होना चाहिए. उदाहरण के लिए, "National Weather Service".
मौसम से जुड़े इवेंट के टाइप
मौसम से जुड़ी इन घटनाओं के बारे में जानकारी दी जा सकती है:
| मौसम से जुड़े इवेंट के टाइप | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
जवाब के अनुवाद का तरीका
Google, सिर्फ़ alertTitle फ़ील्ड के लिए अनुवाद उपलब्ध कराता है. eventType, areaName, instruction, और safetyRecommendations जैसे अन्य फ़ील्ड का भी अनुवाद किया जा सकता है. हालांकि, यह इस बात पर निर्भर करता है कि डेटा के मूल सोर्स में कौनसी भाषाएं इस्तेमाल की जा सकती हैं. Google इन फ़ील्ड के लिए अलग से अनुवाद नहीं कर सकता.
अनुरोध में शामिल languageCode पैरामीटर के आधार पर, alertTitle फ़ील्ड के लिए ये व्यवहार होने चाहिए:
- इस्तेमाल की जा सकती है
languageCode: अगर अनुरोध की गईlanguageCode, दोनों ही उपलब्ध हैं और इस्तेमाल की जा सकती हैं, तो जवाब उसी भाषा में दिया जाता है जिसमें अनुरोध किया गया है. - काम नहीं करता
languageCode: अगर अनुरोध की गईlanguageCodeकाम नहीं करती है और कोई मिलता-जुलता विकल्प नहीं मिलता है, तो एंडपॉइंट डिफ़ॉल्ट रूप से अंग्रेज़ी में जवाब देता है. languageCodeनहीं दिया गया है: एंडपॉइंट, डिफ़ॉल्ट रूप से अंग्रेज़ी में जवाब देता है.
मौसम के बारे में सूचना पाने के अनुरोध का उदाहरण
यहां दिए गए उदाहरण में, नॉर्थ कैरोलिना के किसी शहर के लिए मौसम की चेतावनी से जुड़ी जानकारी का अनुरोध किया गया है:
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
जवाब का मुख्य हिस्सा यहां दिया गया है:
{ "weatherAlerts": [ { "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1", "alertTitle": { "text": "Flash Flood Warning", "languageCode": "en" }, "eventType": "FLASH_FLOOD", "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC", "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],[-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000], [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000], [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000], [-78.350000,35.940000],[-78.450000,35.820000]]]}", "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for... \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina... \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina... \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen. \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding. Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas, highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include... \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.", "severity": "SEVERE", "certainty": "LIKELY", "urgency": "IMMEDIATE", "instruction": [ "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles." ], "safetyRecommendations": [ { "directive": "Build an emergency kit and make a family communications plan.", "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan." }, { "directive": "Be aware that flash flooding can occur. ", "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move." }, ... ], "timezoneOffset": "-14400s", "startTime": "2025-08-06T18:24:00Z", "expirationTime": "2025-08-06T21:30:00Z", "dataSource": { "publisher": "NOAA", "name": "National Weather Service", "authorityUri": "https://www.weather.gov/" } } ], "regionCode": "US" }
इसे आज़माएं!
APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.
अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.