जानकारी

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

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

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

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

<language> कोड वैल्यू के लिए, हमारा सुझाव है कि आप मान्य RFC 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> की वैल्यू को ठीक किया जा सकता है. इससे, चेतावनी देने वाले लेखकों का काम करने का तरीका कम हो जाता है. उदाहरण के तौर पर, अमेरिका में इस्तेमाल होने वाला एनओएए, इवेंट के टाइप के हिसाब से तुरंत कार्रवाई करने की सुविधा सेट करता है.
<severity> ज़रूरी है severity

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

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

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

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

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

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

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

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

कहां:

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

<info> एलिमेंट में कई <eventCode> एलिमेंट हो सकते हैं.

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

        <eventCode>
          <valueName>OET:v1.0</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 से कम वर्ण होने चाहिए. (CAP 1.2 टेक्स्ट मैसेज के लिए 160 से कम सुझाव देता है.) इस स्ट्रिंग से शुरुआत करें. इसमें कुछ ऐसे शब्द होने चाहिए जो चेतावनी की मुख्य वजह बताते हों. उदाहरण के लिए, "Pontoon Bridge बंद है...."

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

ज़रूरी है*

 string

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

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

  • क्या हो रहा है या होने वाला है?
  • यह कहां हो रहा है?
  • यह कितना बुरा है?

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

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

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

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

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

ज़रूरी है*

 string

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

<contact> फ़ील्ड ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इसे उपलब्ध कराएं, क्योंकि यह उपयोगकर्ताओं को सूचना देने और जवाब देने का एक तरीका उपलब्ध कराता है. उदाहरण के लिए, "आपातकालीन स्थिति के लिए, 112 पर कॉल करें."
<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>