اطلاعات

موجودیت <info> جزئیات هشدار را مشخص می کند. حداقل یک بلوک <info> برای هشدار لازم است. اگر از چندین زبان پشتیبانی می‌کنید، توصیه می‌کنیم از یک بلوک <info> برای هر زبان برای یک موجودیت <alert> استفاده کنید.

عناصر موجودیت info

جدول زیر مقادیر عناصر فرعی را برای موجودیت <info> توصیف می کند:

نام عنصر اختیاری تایپ کنید یادداشت ها و الزامات CAP و Google
<language> اختیاری language

برای مقدار کد <language> ، توصیه می کنیم از یک RFC 3066 معتبر استفاده کنید.

اگر عنصر <language> وجود نداشته باشد، مقدار پیش‌فرض en-US است.

<category> ضروری InfoCategory کد <category> دسته رویداد موضوع پیام هشدار را نشان می دهد. برای شناسایی دسته‌های مناسب برای رویدادهای خود، به فهرست شرایط رویداد OASIS مراجعه کنید. دسته بندی مناسب می تواند به گوگل کمک کند تا هشدار را با دقت بیشتری در اختیار کاربران قرار دهد.
<event> ضروری string

عنصر <event> نوع رویداد موضوع پیام هشدار را نشان می دهد.

الزامات Google برای عنصر <event> به شرح زیر است:

  • طول را کمتر از 35 کاراکتر کنید.
  • مجموعه ای از انواع <event> از پیش تعریف شده را در یک CSV یا صفحه گسترده Google فهرست کنید (به این مثال Google Sheets مراجعه کنید).
<responseType> اختیاری responseType

برای مشخص کردن نوع عملکرد توصیه شده برای مخاطبان صحیح، در صورت لزوم، ما قویاً عنصر <responseType> را به همراه مقدار عنصر <instruction> که با آن مطابقت دارد توصیه می کنیم.

<urgency> ضروری urgency

از مقدار Unknown برای عنصر <urgency> استفاده نکنید زیرا این مقدار فهرست کردن هشدارها و رتبه های نسبی را دشوار می کند.

برای Google مهم است که بداند فیلد <urgency> چگونه و توسط چه کسی تنظیم شده است. با این حال، این اطلاعات خارج از محدوده مشخصات رسمی است.

ترجیحاً، ناشر مقدار <urgency> را به صورت موردی تعیین می‌کند و از دستورالعمل‌های راه‌اندازی واضح پیروی می‌کند. با این حال، یک عنصر <event> ممکن است مقدار <urgency> را اصلاح کند و در نتیجه انعطاف نویسندگان هشدار را کاهش دهد. به عنوان مثال، NOAA در ایالات متحده اضطرار را به صورت ایستا بر اساس نوع رویداد تنظیم می کند.

<severity> ضروری severity

از مقدار Unknown برای عنصر <severity> استفاده نکنید زیرا این مقدار فهرست کردن هشدارها و رتبه های نسبی را دشوار می کند.

برای Google مهم است که بداند فیلد <severity> چگونه و توسط چه کسی تنظیم شده است. با این حال، این اطلاعات خارج از محدوده مشخصات رسمی است.

ترجیحاً، ناشر مقدار <severity> را به صورت موردی تعیین می‌کند و از دستورالعمل‌های ماشه واضح پیروی می‌کند. با این حال، یک عنصر <event> ممکن است مقدار <severity> را اصلاح کند، و در نتیجه، انعطاف‌پذیری نویسندگان هشدار را کاهش دهد. به عنوان مثال، NOAA در ایالات متحده اضطرار را به صورت ایستا بر اساس نوع رویداد تنظیم می کند.

<certainty> ضروری certainty

از مقدار Unknown برای عنصر <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> را نشان می دهد.

چندین نمونه از عناصر <eventCode> می توانند در یک بلوک <info> رخ دهند.

ما قویاً توصیه می کنیم که مقادیر عنصر <eventCode> را از فهرست شرایط رویداد OASIS دریافت کنید. اگر از لیست اصطلاحات رویداد OASIS استفاده می کنید، از OET:v1.0 به عنوان نام مقدار استفاده کنید، همانطور که در این مثال نشان داده شده است:

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> اختیاری dateTime

مقدار عنصر <effective> زمان مؤثر اطلاعات در پیام هشدار است.

شما باید فیلدهای منطقه زمانی را در همه مقادیر dateTime قرار دهید. اگر مکان ذکر شده در بلوک <area> در یک منطقه زمانی قرار می‌گیرد، توصیه می‌کنیم که عنصر <effective> زمان را در آن منطقه مشخص کند. در صورت لزوم، یک کمک هزینه برای ساعات تابستانی اضافه کنید.

هنگامی که محتوای یک پیام در چندین منطقه زمانی اعمال می‌شود، توصیه می‌کنیم تولیدکننده پیام از زمان‌های UTC در اولویت نسبت به زمان‌های محلی استفاده کند.

مثال:

2002-05-24T16:49:00-07:00 نشان دهنده 24 مه 2002 در ساعت 16:49 PDT است.

<onset> اختیاری dateTime

مقدار عنصر <onset> زمان مورد انتظاری است که رویداد موضوع پیام هشدار آغاز می شود. شما باید فیلدهای منطقه زمانی را در همه مقادیر dateTime قرار دهید.

اگر مکان ذکر شده در بلوک <area> در یک منطقه زمانی قرار می‌گیرد، توصیه می‌کنیم که عنصر <effective> زمان را در آن منطقه مشخص کند. در صورت لزوم، یک کمک هزینه برای ساعات تابستانی اضافه کنید.

هنگامی که محتوای یک پیام در چندین منطقه زمانی اعمال می‌شود، توصیه می‌کنیم تولیدکننده پیام از زمان‌های UTC در اولویت نسبت به زمان‌های محلی استفاده کند.

مثال:

2002-05-24T16:49:00-07:00 نشان دهنده 24 مه 2002 در ساعت 16:49 PDT است.

<expires>

ضروری*

 dateTime

مقدار عنصر <expires> زمان انقضای رویداد موضوع پیام هشدار است. یک عنصر <expires> باید به ترتیب زمانی بعد از عنصر <effective> بیاید.

اگر نمی‌توانید برای همه هشدارهای خود زمان انقضا تعیین کنید، برای هر هشداری که عنصر <expires> ندارد، یک زمان انقضای پیش‌فرض در اختیار Google قرار دهید. برای مثال، می‌توانید بیان کنید که اگر عنصر <expires> وجود نداشته باشد، به‌طور پیش‌فرض، تمام هشدارهای شما پس از 48 ساعت منقضی می‌شوند.

شما باید فیلدهای منطقه زمانی را در همه مقادیر dateTime قرار دهید. اگر مکان ذکر شده در بلوک <area> در یک منطقه زمانی قرار می‌گیرد، توصیه می‌کنیم که عنصر <effective> زمان را در آن منطقه مشخص کند. در صورت لزوم، یک کمک هزینه برای ساعات تابستانی اضافه کنید.

هنگامی که محتوای یک پیام در چندین منطقه زمانی اعمال می‌شود، توصیه می‌کنیم تولیدکننده پیام از زمان‌های UTC در اولویت نسبت به زمان‌های محلی استفاده کند.

مثال:

2002-05-24T16:49:00-07:00 نشان دهنده 24 مه 2002 در ساعت 16:49 PDT است.

<senderName> اختیاری string

عنصر <senderName> اختیاری است اما به شدت توصیه می شود.

وقتی فرستنده یک نام قابل خواندن برای انسان داشته باشد، پیوند <web> می تواند به روشی کاربرپسند، با توجه به ترجیحات ناشر یا فرستنده نشان داده شود. علاوه بر این، عنصر <senderName> به جمع‌آورنده‌های هشدار اجازه می‌دهد تا از مقامات متعدد منتشر کنند.

<headline> اختیاری string

طول رشته های عنصر <headline> را کمتر از 140 کاراکتر کنید.

یک رشته <headline> می تواند متن باز باشد، اما توصیه می کنیم که از کمتر از 140 کاراکتر تشکیل شده باشد. (CAP 1.2 کمتر از 160 را برای پیام های متنی پیشنهاد می کند.) این رشته را با چند کلمه توصیفی شروع کنید که هسته هشدار را توضیح می دهد. به عنوان مثال "بستن پل پونتون ...."

از مقادیر یکسان برای عناصر <headline> و <description> استفاده نکنید. جزئیات بیشتری را در عنصر <description> نسبت به عنصر <headline> ارائه دهید.

<description>

ضروری*

 string

مقدار عنصر <description> متنی است که موضوع رویداد پیام هشدار را توصیف می کند.

ما محتوای قابل خواندن و آموزنده برای انسان را توصیه می کنیم که به این سؤالات پاسخ می دهد:

  • چه اتفاقی در حال وقوع است یا در شرف وقوع است؟
  • کجا اتفاق می افتد؟
  • چقدر بد است؟

Google از عنصر <description> برای پر کردن بخش Message صفحه ما و از عنصر <instruction> برای پر کردن بخش Recommended Actions استفاده می کند. هر دو فیلد برای کاربران قابل مشاهده است.

می‌توانید از این برچسب‌های Markdown پشتیبانی‌شده استفاده کنید: <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 = یک مقدار رشته ای.

چندین نمونه از یک عنصر <parameter> می تواند در یک بلوک <info> رخ دهد.

<resource> اختیاری resource

عنصر <resource> هر گونه اطلاعات تکمیلی اضافی مربوط به عنصر والد <info> را ارائه می دهد. چندین نمونه از یک عنصر <resource> می تواند در یک بلوک <info> رخ دهد.

<area>

ضروری*

 area

عنصر <area> حاوی اطلاعات مربوط به منطقه هشدار رویداد است، نه منطقه حادثه. بلوک‌های <area> باید حداقل شامل یک عنصر <circle> ، <polygon> یا <geocode> باشند.

ما قویاً استفاده از عنصر <polygon> یا <circle> را به جای عنصر <geocode> توصیه می کنیم.

* Google به عناصری نیاز دارد که دارای اختیاری پررنگ و قرمز REQUIRED باشند، اما این عناصر در استاندارد 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>