मौसम की चेतावनियां पाना

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 सूचना के सटीक होने का लेवल:
  • देखा गया: यह तय किया गया है कि उल्लंघन हुआ है या अब भी हो रहा है
  • बहुत ज़्यादा संभावना: ऐसा हो सकता है कि यह समस्या पहले भी हुई हो या अब भी हो रही हो
  • संभावित: ऐसा हो सकता है कि (p > ~50%) यह समस्या हुई हो या अब भी हो रही हो
  • संभव है: ऐसा हो सकता है, लेकिन इसके होने की संभावना कम है या यह जारी नहीं है (p <= ~50%)
  • संभावना नहीं है: इसके होने की संभावना नहीं है (p ~ 0)
  • जानकारी नहीं है: पक्का नहीं है
वैकल्पिक
urgency Enum सूचना कितनी ज़रूरी है:
  • तुरंत: जवाब देने वाली कार्रवाई तुरंत की जानी चाहिए
  • अनुमानित: जवाब देने वाली कार्रवाई जल्द (अगले एक घंटे के अंदर) की जानी चाहिए
  • आने वाले समय में: आने वाले समय में, जवाब देने से जुड़ी कार्रवाई की जानी चाहिए
  • पिछला स्टेटस: अब जवाब देने की ज़रूरत नहीं है
  • जानकारी नहीं है: प्राथमिकता के बारे में जानकारी नहीं है
वैकल्पिक
instruction स्ट्रिंग टारगेट ऑडियंस के लिए, रिस्पॉन्सिव ऐक्शन निर्देशों की जानकारी. वैकल्पिक
safetyRecommendations स्ट्रिंग सार्वजनिक संस्थाओं के कोड के आधार पर सुरक्षा से जुड़े सुझाव. इसमें टॉप-लेवल के निर्देश और ज़्यादा जानकारी वाला सबटेक्स्ट शामिल होता है. वैकल्पिक
timezoneOffset स्ट्रिंग इवेंट का टाइमज़ोन ऑफ़सेट, +/-HH:MM फ़ॉर्मैट में. ज़रूरी है
startTime DateTime सूचना में दी गई जानकारी के लिए, ईपॉक की तारीख और समय (यूटीसी समय). वैकल्पिक
expirationTime DateTime वह तारीख और समय (यूटीसी समय), जब सूचना खत्म होने की उम्मीद है. यह वैल्यू, लंबे समय तक चलने वाले इवेंट के लिए शून्य हो सकती है. ऐसे मामले में, हेडलाइन से पता चलेगा कि इवेंट "लागू है". वैकल्पिक
dataSource Enum अधिकार से जुड़ी जानकारी. जैसे, पब्लिशर, नाम, और यूआरएल. ज़रूरी है
regionCode Enum अनुरोध की गई जगह का क्षेत्र कोड. वैकल्पिक

डेटा सोर्स

मौसम की चेतावनियों वाला एंडपॉइंट, इस टेबल में दिए गए प्रोवाइडर का पब्लिश किया गया डेटा दिखाता है. अनुरोध में दिए गए अक्षांश और देशांतर के निर्देशांकों के आधार पर, जवाब के मुख्य हिस्से में स्थानीय सरकारी विभाग से मिला डेटा दिखता है.

फ़ीड में शामिल किए गए सेवा देने वाले लोग या कंपनियां, Google की सार्वजनिक चेतावनियों से जुड़े दिशा-निर्देशों का पालन करती हैं. Google, सेवा देने वाली कंपनियों की सूची को किसी भी समय अपडेट कर सकता है.

देश एजेंसी
ऑस्ट्रेलिया ACT Emergency Services Agency (ACT ESA)
न्यू साउथ वेल्स रूरल फ़ायर सर्विस (एनएसडब्ल्यू आरएफ़एस)
साउथ ऑस्ट्रेलियन कंट्री फ़ायर सर्विस (एसए सीएफ़एस)
Tasmania Fire Service (TFS)
क्वींसलैंड फ़ायर ऐंड इमरजेंसी सर्विसेज़ (QFES)
ऑस्ट्रिया GeoSphere Austria से MeteoAlarm के ज़रिए
बेल्जियम MeteoAlarm के ज़रिए रॉयल मीटियोरोलॉजिकल इंस्टिट्यूट ऑफ़ बेल्जियम
बोस्निया और हर्ज़ेगोविना फ़ेडरल हाइड्रो-मेटेओरोलॉजिकल इंस्टिट्यूट (एफ़एचएमज़ेड), MeteoAlarm के ज़रिए
बुल्गारिया नैशनल इंस्टिट्यूट ऑफ़ मेटियोरोलॉजी ऐंड हाइड्रोलॉजी से MeteoAlarm
ब्राज़ील Centro Nacional de Gerenciamento de Riscos e Desastres (CENAD)
Instituto Nacional de Meteorologia (INMET)
कोलंबिया Unidad Nacional para la Gestión del Riesgo de Desastres (UNGRD)
आइवरी कोस्ट Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique
क्रोएशिया MeteoAlarm के ज़रिए क्रोएशियन मीटियोरोलॉजिकल ऐंड हाइड्रोलॉजिकल सर्विस
साइप्रस डिपार्टमेंट ऑफ़ मीटीयरोलॉजी से MeteoAlarm
चेकिया चेक हाइड्रोमीटियोरोलॉजिकल इंस्टिट्यूट से MeteoAlarm के ज़रिए
डेनमार्क MeteoAlarm के ज़रिए Danish Meteorological Institute
इक्वाडोर Instituto Nacional de Meteorología e Hidrología
एस्टोनिया MeteoAlarm के ज़रिए Ministry of Climate
फ़िनलैंड MeteoAlarm के ज़रिए फ़िनिश मीटियोरोलॉजिकल इंस्टिट्यूट
फ़्रांस Météo-France से MeteoAlarm
जर्मनी DWD - The German Weather Service
ग्रीस MeteoAlarm के ज़रिए Hellenic National Meteorological Service
गिनी Agence Nationale de la Météorologie
हंगरी HungaroMet Nonprofit Zrt, MeteoAlarm के ज़रिए
आइसलैंड MeteoAlarm के ज़रिए आइसलैंडिक मीटियोरोलॉजिकल ऑफ़िस
आयरलैंड MeteoAlarm के ज़रिए Met Eireann
इटली MeteoAlarm के ज़रिए Italian Meteorological Service
जमैका Meteorological Service of Jamaica
जापान जापान मेटेओरोलॉजिकल एजेंसी (जेएमए)
लातविया MeteoAlarm के ज़रिए Latvian Environment, Geology and Meteorology Centre
लिथुआनिया Lithuanian Hydrometeorological Service से मिली जानकारी को MeteoAlarm के ज़रिए दिखाया जाता है
लक्ज़मबर्ग MeteoAlarm के ज़रिए MeteoLux
मेडागास्कर Météo Madagascar
मेक्सिको Centro de Instrumentación y Registro Sísmico A.C. (CIRES)
नीदरलैंड्स रॉयल नीदरलैंड्स मीटियोरोलॉजिकल इंस्टिट्यूट, MeteoAlarm के ज़रिए
उत्तरी मैसेडोनिया नैशनल हाइड्रोमीटियोरॉलजिकल सर्विस के ज़रिए MeteoAlarm
नॉर्वे MeteoAlarm के ज़रिए Norwegian Meteorological Institute
न्यूज़ीलैंड GNS Science (GeoNet)
MetService
फ़िलिपींस फ़िलिपीन एट्मॉस्फ़ियरिक, जियोफ़िज़िकल, ऐंड ऐस्ट्रोनॉमिकल सर्विसेज़ एडमिनिस्ट्रेशन (पागासा)
पोलैंड इंस्टिट्यूट ऑफ़ मीटियोरोलॉजी ऐंड वॉटर मैनेजमेंट, MeteoAlarm के ज़रिए
पुर्तगाल MeteoAlarm के ज़रिए Portuguese Institute for Sea and Atmosphere
रोमानिया नैशनल मेटेओरोलॉजिकल एडमिनिस्ट्रेशन से MeteoAlarm
सर्बिया MeteoAlarm के ज़रिए रिपब्लिक हाइड्रोमीटियोरोलॉजिकल इंस्टिट्यूट ऑफ़ सर्बिया
सिंगापुर मीटियोरोलॉजिकल सर्विस सिंगापुर
स्लोवाकिया MeteoAlarm के ज़रिए स्लोवाक हाइड्रोमीटियोरोलॉजिकल इंस्टिट्यूट
स्लोवेनिया MeteoAlarm के ज़रिए स्लोवेनिया का हाइड्रोमीटियोरोलॉजिकल इंस्टिट्यूट
सोलोमन द्वीप समूह Solomon Islands Meteorological Services
दक्षिण कोरिया Korea Meteorological Administration
स्पेन MeteoAlarm के ज़रिए स्टेट मेटेओरोलॉजिकल एजेंसी
स्वीडन MeteoAlarm के ज़रिए स्वीडिश मीटियोरोलॉजिकल ऐंड हाइड्रोलॉजिकल इंस्टिट्यूट
स्विट्ज़रलैंड MeteoAlarm के ज़रिए फ़ेडरल ऑफ़िस ऑफ़ मीटीयरोलॉजी ऐंड क्लाइमेटोलॉजी MeteoSwiss
ताइवान नैशनल साइंस ऐंड टेक्नोलॉजी सेंटर फ़ॉर डिज़ास्टर रिडक्शन (एनसीडीआर)
थाईलैंड थाई मीटियोरोलॉजिकल डिपार्टमेंट
यूनाइटेड किंगडम MeteoAlarm के ज़रिए Met Office
यूके एनवायरमेंट एजेंसी
अमेरिका नैशनल सुनामी वॉर्निंग सेंटर
US National Weather Service
वियतनाम नैशनल सेंटर फ़ॉर हाइड्रोमेटियोरोलॉजिकल फ़ोरकास्टिंग

एट्रिब्यूशन

डेटा दिखाने वाले सभी डिसप्ले पर, ग्राहक के ऐप्लिकेशन में dataSource फ़ील्ड का इस्तेमाल करके, ओरिजनल सोर्स का एट्रिब्यूशन शामिल करना ज़रूरी है:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

एट्रिब्यूशन में, डेटा सोर्स का पूरा नाम शामिल होना चाहिए. यह नाम, name फ़ील्ड में दिया गया होता है. साथ ही, इसमें name फ़ील्ड में दिए गए यूआरएल का इस्तेमाल करके, डेटा सोर्स का हाइपरलिंक भी शामिल होना चाहिए. उदाहरण के लिए, "National Weather Service".authorityUri

मौसम से जुड़े इवेंट के टाइप

मौसम से जुड़ी इन घटनाओं के बारे में जानकारी दी जा सकती है:

मौसम से जुड़े इवेंट के टाइप
ACID_RAIN
AVALANCHE
BLIZZARD
BLOWING_SNOW
COASTAL_FLOOD
COASTAL_HAZARD
COLD
CYCLONE
DROUGHT
EXTRATROPICAL_CYCLONE
FIRE_WEATHER
FLASH_FLOOD
FLOOD
FOG
FREEZING
FREEZING_AIR_TEMPERATURE
FREEZING_DRIZZLE
FREEZING_RAIN
FROST
GALE
GLAZE
HAIL
HAZARDOUS_SEAS
HEAT
HUMIDITY
HURRICANE
ICE_STORM
LAKE_EFFECT_SNOW
MONSOON
MUDDY_FLOOD
OUTFLOW
RAIN
RIVER_FLOODING
SEVERE_THUNDERSTORM_WARNING
SNOW
SNOWSQUALL
STORM
STORM_SURGE
THUNDER
THUNDERSTORM
TORNADO
TORNADO_WARNING
TROPICAL_CYCLONE
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES
TROPICAL_DISTURBANCE
TROPICAL_STORM
TYPHOON
WIND
WIND_CHILL
WIND_WAVE
WINTER_STORM
WILDFIRE
BUSHFIRE
FIRE
LANDSLIDE
EARTHQUAKE
DUST_STORM
AFTERSHOCK
TSUNAMI
VOLCANIC_ASH
VOLCANIC_ERUPTION
RADIATION

जवाब के अनुवाद का तरीका

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 की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

  1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.

  2. अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.

  3. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिससे आपको अनुरोध करना है.

  4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.