जानकारी

<info> इकाई, सूचना की जानकारी देती है. सूचना के लिए, कम से कम एक <info> ब्लॉक होना ज़रूरी है. अगर आपने कई भाषाओं में प्रॉडक्ट दिखाने का विकल्प चुना है, तो हमारा सुझाव है कि आप एक ही <alert> इकाई के लिए, हर भाषा के लिए एक <info> ब्लॉक का इस्तेमाल करें.

info इकाई के एलिमेंट

नीचे दी गई टेबल में, <info> इकाई के लिए सब-एलिमेंट की वैल्यू के बारे में बताया गया है:

एलिमेंट का नाम ज़रूरी नहीं टाइप सीएपी और Google के नोट और ज़रूरी शर्तें
<language> वैकल्पिक language

हमारा सुझाव है कि <language> कोड वैल्यू के लिए, आप मान्य आरएफ़सी 3066 का इस्तेमाल करें.

अगर <language> एलिमेंट मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू के तौर पर en-US का इस्तेमाल किया जाता है.
<category> ज़रूरी है InfoCategory <category> कोड, सूचना मैसेज के विषय इवेंट की कैटगरी दिखाता है. अपने इवेंट के लिए सही कैटगरी की पहचान करने के लिए, OASIS इवेंट की शर्तों की सूची देखें. सही कैटगरी चुनने से, Google को उपयोगकर्ताओं को सूचना ज़्यादा सटीक तरीके से दिखाने में मदद मिल सकती है.
<event> ज़रूरी है string

<event> एलिमेंट, सूचना मैसेज के विषय के इवेंट के टाइप के बारे में बताता है.

<event> एलिमेंट के लिए Google की ज़रूरी शर्तें ये हैं:

  • यह 35 से कम वर्णों का होना चाहिए.
  • CSV या Google स्प्रेडशीट में, पहले से तय किए गए <event> टाइप का सेट बनाएं (Google Sheets का यह उदाहरण देखें).
<responseType> वैकल्पिक responseType

हमारा सुझाव है कि सही ऑडियंस के लिए सुझाई गई कार्रवाई के टाइप को बताने के लिए, <responseType> एलिमेंट के साथ-साथ उससे जुड़ी <instruction> एलिमेंट वैल्यू का इस्तेमाल करें. हालांकि, ऐसा तब ही करें, जब लागू हो.
<urgency> ज़रूरी है urgency

<urgency> एलिमेंट के लिए, 'जानकारी नहीं है' वैल्यू का इस्तेमाल न करें. इस वैल्यू की वजह से, सूचनाओं और रिलेटिव रैंक को इंडेक्स करना मुश्किल हो जाता है.

Google के लिए यह जानना ज़रूरी है कि <urgency> फ़ील्ड को कैसे और किसने सेट किया है. हालांकि, यह जानकारी प्रोफ़ाइल में शामिल नहीं की जाती.

आम तौर पर, पब्लिशर हर मामले के हिसाब से <urgency> वैल्यू सेट करता है और ट्रिगर के साफ़ दिशा-निर्देशों का पालन करता है. हालांकि, <event> एलिमेंट से <urgency> वैल्यू तय हो सकती है. इससे, सूचना बनाने वाले लोगों के लिए, वैल्यू में बदलाव करने की सुविधा कम हो जाती है. उदाहरण के लिए, अमेरिका में NOAA, इवेंट के टाइप के आधार पर, ज़रूरत के हिसाब से जानकारी देता है.
<severity> ज़रूरी है severity

<severity> एलिमेंट के लिए, 'जानकारी नहीं है' वैल्यू का इस्तेमाल न करें. इस वैल्यू की वजह से, सूचनाओं और रिलेटिव रैंक को इंडेक्स करना मुश्किल हो जाता है.

Google के लिए यह जानना ज़रूरी है कि <severity> फ़ील्ड को कैसे और किसने सेट किया है. हालांकि, यह जानकारी प्रोफ़ाइल में शामिल नहीं की जाती.

आम तौर पर, पब्लिशर हर मामले के हिसाब से <severity> वैल्यू सेट करता है और ट्रिगर के साफ़ दिशा-निर्देशों का पालन करता है. हालांकि, <event> एलिमेंट से <severity> वैल्यू तय हो सकती है. इससे, सूचना बनाने वाले लोगों के लिए, वैल्यू में बदलाव करने की सुविधा कम हो जाती है. उदाहरण के लिए, अमेरिका में NOAA, इवेंट के टाइप के आधार पर, ज़रूरत के हिसाब से जानकारी देता है.
<certainty> ज़रूरी है certainty

<certainty> एलिमेंट के लिए, 'जानकारी नहीं है' वैल्यू का इस्तेमाल न करें. इस वैल्यू की वजह से, सूचनाओं और रिलेटिव रैंक को इंडेक्स करना मुश्किल हो जाता है.

Google के लिए यह जानना ज़रूरी है कि <certainty> फ़ील्ड को कैसे और किसने सेट किया है. हालांकि, यह जानकारी प्रोफ़ाइल में नहीं दिखती.

आम तौर पर, पब्लिशर हर मामले के हिसाब से <certainty> वैल्यू सेट करता है और ट्रिगर के साफ़ दिशा-निर्देशों का पालन करता है. हालांकि, <event> एलिमेंट से <certainty> वैल्यू तय हो सकती है. इससे, सूचना बनाने वाले लोगों के लिए, वैल्यू में बदलाव करने की सुविधा कम हो जाती है. उदाहरण के लिए, अमेरिका में NOAA, इवेंट के टाइप के आधार पर, ज़रूरत के हिसाब से जानकारी देता है.
<audience> वैकल्पिक string <audience> एलिमेंट की वैल्यू, टेक्स्ट होती है. इससे, सूचना वाले मैसेज के टारगेट ऑडियंस के बारे में पता चलता है.
<eventCode> वैकल्पिक string

<eventCode> एलिमेंट में सिस्टम के हिसाब से कोड होता है, जो सूचना मैसेज के इवेंट टाइप की पहचान करता है. यह कोड, नीचे दिए गए फ़ॉर्मैट में होता है.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

कहां:

  • valueName = उपयोगकर्ता की ओर से असाइन की गई स्ट्रिंग, जो कोड के डोमेन की जानकारी देती है. अगर ये स्ट्रिंग, संक्षिप्त रूप से इस्तेमाल हुए शब्द हैं, तो उन्हें बिंदु के बिना, सभी कैपिटल लेटर में लिखें. उदाहरण के लिए, SAME, FIPS, और ZIP.
  • value = एक स्ट्रिंग, जो <eventCode> एलिमेंट की वैल्यू दिखाती है.

<info> ब्लॉक में, <eventCode> एलिमेंट के कई इंस्टेंस हो सकते हैं.

हमारा सुझाव है कि आप <eventCode> एलिमेंट की वैल्यू, OASIS इवेंट की शर्तों की सूची से लें. अगर OASIS इवेंट की शब्द सूची का इस्तेमाल किया जाता है, तो वैल्यू के नाम के तौर पर OET:v1.2 का इस्तेमाल करें, जैसा कि इस उदाहरण में दिखाया गया है:

        <eventCode>
          <valueName>OET:v1.2</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> वैकल्पिक dateTime

<effective> एलिमेंट की वैल्यू, सूचना वाले मैसेज में दी गई जानकारी के लागू होने का समय होती है.

आपको सभी dateTime वैल्यू में टाइम ज़ोन फ़ील्ड शामिल करने होंगे. अगर <area> ब्लॉक में बताई गई जगह, एक ही टाइम ज़ोन में आती है, तो हमारा सुझाव है कि <effective> एलिमेंट में उस टाइम ज़ोन का समय बताएं. अगर लागू हो, तो डेलाइट सेविंग टाइम के लिए समय जोड़ें.

जब किसी मैसेज का कॉन्टेंट एक से ज़्यादा टाइम ज़ोन पर लागू होता है, तो हमारा सुझाव है कि मैसेज बनाने वाला व्यक्ति, स्थानीय समय के बजाय यूटीसी समय का इस्तेमाल करे.

उदाहरण:

2002-05-24T16:49:00-07:00 का मतलब है कि 24 मई, 2002 को 16:49 पीडीटी.
<onset> वैकल्पिक dateTime

<onset> एलिमेंट की वैल्यू, सूचना मैसेज के विषय से जुड़े इवेंट के शुरू होने का अनुमानित समय होती है. आपको सभी dateTime वैल्यू में, समय क्षेत्र के फ़ील्ड शामिल करने होंगे.

अगर <area> ब्लॉक में बताई गई जगह, एक ही टाइम ज़ोन में आती है, तो हमारा सुझाव है कि <effective> एलिमेंट में उस टाइम ज़ोन का समय बताएं. अगर लागू हो, तो डेलाइट सेविंग टाइम के लिए समय जोड़ें.

जब किसी मैसेज का कॉन्टेंट एक से ज़्यादा टाइम ज़ोन पर लागू होता है, तो हमारा सुझाव है कि मैसेज बनाने वाला व्यक्ति, स्थानीय समय के बजाय यूटीसी समय का इस्तेमाल करे.

उदाहरण:

2002-05-24T16:49:00-07:00 का मतलब है कि 24 मई, 2002 को 16:49 पीडीटी.
<expires>

ज़रूरी है*

 dateTime

<expires> एलिमेंट की वैल्यू, सूचना मैसेज के विषय इवेंट की समयसीमा का समय होता है. समय के क्रम में, <expires> एलिमेंट, <effective> एलिमेंट के बाद आना चाहिए.

अगर आपके पास अपनी सभी सूचनाओं के लिए, खत्म होने का समय सेट करने का विकल्प नहीं है, तो उन सूचनाओं के लिए Google को डिफ़ॉल्ट तौर पर खत्म होने का समय दें जिनमें <expires> एलिमेंट नहीं है. उदाहरण के लिए, आपके पास यह बताने का विकल्प है कि अगर कोई <expires> एलिमेंट नहीं है, तो डिफ़ॉल्ट रूप से आपकी सभी चेतावनियां 48 घंटे बाद दिखना बंद हो जाएंगी.

आपको सभी dateTime वैल्यू में टाइम ज़ोन फ़ील्ड शामिल करने होंगे. अगर <area> ब्लॉक में बताई गई जगह, एक ही टाइम ज़ोन में आती है, तो हमारा सुझाव है कि <effective> एलिमेंट में उस टाइम ज़ोन का समय बताएं. अगर लागू हो, तो डेलाइट सेविंग टाइम के लिए समय जोड़ें.

जब किसी मैसेज का कॉन्टेंट एक से ज़्यादा टाइम ज़ोन पर लागू होता है, तो हमारा सुझाव है कि मैसेज बनाने वाला व्यक्ति, स्थानीय समय के बजाय यूटीसी समय का इस्तेमाल करे.

उदाहरण:

2002-05-24T16:49:00-07:00 का मतलब है कि 24 मई, 2002 को 16:49 पीडीटी.
<senderName> वैकल्पिक string

<senderName> एलिमेंट का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, इसका इस्तेमाल करने का सुझाव दिया जाता है.

अगर ईमेल भेजने वाले का नाम आसानी से पढ़ा जा सकता है, तो पब्लिशर या ईमेल भेजने वाले की प्राथमिकताओं के हिसाब से, <web> लिंक को उपयोगकर्ता के हिसाब से दिखाया जा सकता है. इसके अलावा, <senderName> एलिमेंट की मदद से, अलर्ट एग्रीगेटर एक से ज़्यादा संस्थाओं से पब्लिश कर सकते हैं.
<headline> वैकल्पिक string

<headline> एलिमेंट की स्ट्रिंग की लंबाई 140 वर्णों से कम होनी चाहिए.

<headline> स्ट्रिंग, ओपन टेक्स्ट हो सकती है. हालांकि, हमारा सुझाव है कि इसमें 140 से कम वर्ण हों. (सीएपी 1.2 के मुताबिक, टेक्स्ट मैसेज में 160 से कम वर्ण होने चाहिए.) इस स्ट्रिंग को कुछ ऐसे शब्दों से शुरू करें जिनसे सूचना के बारे में जानकारी मिलती हो. उदाहरण के लिए, "Pontoon bridge closure...."

<headline> और <description> एलिमेंट के लिए एक ही वैल्यू का इस्तेमाल न करें. <headline> एलिमेंट के मुकाबले, <description> एलिमेंट में ज़्यादा जानकारी दें.
<description>

ज़रूरी है*

 string

<description> एलिमेंट की वैल्यू टेक्स्ट होती है, जिसमें सूचना वाले मैसेज के इवेंट के विषय के बारे में जानकारी होती है.

हमारा सुझाव है कि आप ऐसा कॉन्टेंट उपलब्ध कराएं जिसे आसानी से पढ़ा जा सके और जिसमें इन सवालों के जवाब हों:

  • क्या हो रहा है या क्या होने वाला है?
  • यह कहां हो रहा है?
  • यह कितना गंभीर है?

Google, हमारे पेज के मैसेज सेक्शन को भरने के लिए <description> एलिमेंट का इस्तेमाल करता है. साथ ही, सुझाई गई कार्रवाइयों सेक्शन को भरने के लिए <instruction> एलिमेंट का इस्तेमाल करता है. दोनों फ़ील्ड, उपयोगकर्ताओं को दिखते हैं.

इन मार्कडाउन टैग का इस्तेमाल किया जा सकता है: <newline>, <b>, और <a href>.
<instruction> वैकल्पिक string

<instruction> एलिमेंट की वैल्यू, एक टेक्स्ट होता है. इसमें, सूचना पाने वालों के लिए सुझाई गई कार्रवाइयों के बारे में बताया जाता है. हमारा सुझाव है कि आप ऐसा कॉन्टेंट दें जिसे आसानी से पढ़ा जा सके और जिसमें उपयोगकर्ताओं के लिए ज़रूरी जानकारी हो.

चेतावनी की गंभीरता के लेवल के हिसाब से कार्रवाइयों की सूची बनाएं. ये कार्रवाइयां सामान्य नहीं होनी चाहिए. कम शब्दों में और केस-सेंसिटिव वाक्यों का इस्तेमाल करें. साथ ही, सुरक्षा से जुड़ी ऐसी सलाह शामिल करें जिन पर पाठक कार्रवाई कर सकें. सबसे ज़रूरी सलाह को पहले रखें.

<instruction> एलिमेंट का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इसका इस्तेमाल करें. Google Public Alerts, <instruction> फ़ील्ड का इस्तेमाल करके, चेतावनी की जानकारी वाले पेजों में सुझाई गई कार्रवाइयां सेक्शन को पॉप्युलेट करता है. <instruction> और <description> फ़ील्ड की वैल्यू अलग-अलग रखें, क्योंकि इनका इस्तेमाल अलग-अलग कामों के लिए किया जाता है.
<web>

वैकल्पिक

 string

<web> एलिमेंट को ऐसे काम करने वाले यूआरएल से लिंक करें जो आपकी सूचना के बारे में ज़्यादा जानकारी देता हो.
<contact> वैकल्पिक string

<contact> फ़ील्ड का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इसे शामिल करें, क्योंकि इससे उपयोगकर्ताओं को सुझाव/राय देने और सूचना का जवाब देने का मौका मिलता है. उदाहरण के लिए, "आपातकालीन स्थिति में, 911 पर कॉल करें."
<parameter> वैकल्पिक string

<parameter> एलिमेंट में, सिस्टम के हिसाब से डेटा होता है. यह डेटा इस फ़ॉर्मैट में होता है:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

कहां:

valueName = उपयोगकर्ता की ओर से असाइन की गई स्ट्रिंग, जो कोड के डोमेन को दिखाती है.

value = स्ट्रिंग वैल्यू.

<info> ब्लॉक में, <parameter> एलिमेंट के कई इंस्टेंस हो सकते हैं.
<resource> वैकल्पिक resource

<resource> एलिमेंट, पैरंट <info> एलिमेंट से जुड़ी ज़्यादा जानकारी देता है. <info> ब्लॉक में, <resource> एलिमेंट के कई इंस्टेंस हो सकते हैं.
<area>

ज़रूरी है*

 area

<area> एलिमेंट में, इवेंट के उस इलाके के बारे में जानकारी होती है जहां सूचना भेजी जानी है, न कि घटना वाले इलाके के बारे में. <area> ब्लॉक में कम से कम एक <circle>, <polygon> या <geocode> एलिमेंट शामिल होना चाहिए.

हमारा सुझाव है कि आप <geocode> एलिमेंट के बजाय, <polygon> या <circle> एलिमेंट का इस्तेमाल करें.

* Google को उन एलिमेंट की ज़रूरत होती है जिनके लिए बोल्ड और लाल रंग में ज़रूरी है लिखा होता है. हालांकि, CAP स्टैंडर्ड में उन एलिमेंट का होना ज़रूरी नहीं है.

उदाहरण

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>