هشدار

برای تعریف اطلاعات اولیه در مورد یک رویداد جاری، از موجودیت <alert> استفاده کنید.

اگر رویدادی به طور همزمان بیش از یک مکان در حال انجام را اشغال کند، بهتر است رویداد را به چندین شی alert تقسیم کنید. به عنوان مثال، اگر آتش سوزی جنگل چندین ایالت را در بر گیرد، می توانید هشدارها را به چندین هشدار تقسیم کنید، یکی برای هر ایالت. به این ترتیب، اطلاعات اضطراری خاصی را به هر ایالت ارائه می دهید و وضعیت آتش سوزی را با دقت بیشتری به روز می کنید.

اگر رویدادی به سرعت تغییر می‌کند، مانند طوفانی که از شرق به غرب حرکت می‌کند، توصیه می‌کنیم به‌روزرسانی‌های دوره‌ای هشدار را انجام دهید. هشدار موجود را از فید خود حذف نکنید. در عوض، یک هشدار جدید صادر کنید که به هشدار قبلی اشاره دارد.

ویژگی های

جدول 1 مقدار مشخصه را برای موجودیت <alert> توضیح می دهد:

جدول 1. <alert> ویژگی نهاد

نام عنصر اختیاری تایپ کنید شرح
xmlns:cap ضروری string

ویژگی xmlns باید به CAP URN به عنوان فضای نام اشاره کند.

مثال:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

عناصر

جدول 2 مقادیر عنصر فرعی را برای موجودیت <alert> توضیح می دهد:

جدول 2. عناصر موجودیت <alert>

نام عنصر اختیاری تایپ کنید یادداشت ها و الزامات CAP و Google
<identifier> ضروری string شناسه هشداری را که نشان دهنده رویداد است ارائه دهید. مقدار عنصر <identifier> باید در همه رویدادها منحصر به فرد باشد.
<sender> ضروری string عنصر <sender> مبدع هشدار را مشخص می کند. نمی تواند شامل فاصله، کاما یا نویسه های محدود باشد.
<sent> ضروری dateTime

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

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

<status> ضروری AlertStatus

Google فقط هشدارهای در دسترس عموم را منتشر می کند که دارای مقدار عنصر <status> Actual هستند.

<msgType> ضروری AlertMsgType

یک <msgType> UPDATE یا CANCEL باید حداقل یک عنصر <references> داشته باشد. استاندارد CAP موارد زیر را مشخص می کند:

  • هر پیام هشداری که هشدار قبلی را به روز می کند، استفاده می کند به روز رسانی و مقادیر عنصر <references> را برای همه پیام های قبلی که به تاریخ <expires> خود نرسیده اند تنظیم می کند.
  • عنصر <msgType> UPDATE یا CANCEL باید برای یک هشدار منقضی نشده اعمال شود. بنابراین، هنگام صدور UPDATE یا CANCEL <msgType> ، باید به همه پیام‌های مرتبط و هشدارهای منقضی نشده ارجاع داده شود.

برای اطلاعات بیشتر، تغییرات رویداد یا انقضا را ببینید.

<source> اختیاری string عنصر <source> منبع خاص هشدار را نشان می دهد. به عنوان مثال یک اپراتور یا یک دستگاه خاص است.
<scope> ضروری AlertScope

عنصر <scope> توزیع مورد نظر پیام هشدار را نشان می دهد.

<restriction> مشروط string اگر مقدار عنصر <scope> Restricted باشد، عنصر <restriction> مورد نیاز است. این عنصر قانون محدود کردن توزیع پیام هشدار محدود را توصیف می کند.
<addresses> مشروط string اگر مقدار عنصر <scope> Private باشد، عنصر <addresses> مورد نیاز است. این عنصر گیرنده مورد نظر پیام هشدار را فهرست می کند. می‌توانید آدرس‌های چندگانه با فاصله محدود را اضافه کنید، اما باید آدرس‌هایی را که دارای فضای خالی هستند را در گیومه‌های دوتایی قرار دهید.
<code> اختیاری string

عنصر <code> مدیریت ویژه پیام هشدار را نشان می دهد.

<note> مشروط string

اگر هشدار حاوی یکی از مقادیر عنصر زیر باشد، عنصر <note> مورد نیاز است:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> مشروط string

اگر مقدار عنصر <msgType> UPDATE یا CANCEL باشد، عنصر <references> مورد نیاز است.

هنگامی که سیستم شما محتوای CAP را از ناشر دیگری مجدداً منتشر می کند، هشدار کامل CAP را درج کنید. برای پیوند دادن محتوای ویرایش شده به منبع اصلی، از تگ <references> استفاده کنید.

اگر به چند پیام ارجاع می دهید، از فضای خالی به عنوان جداکننده استفاده کنید.

<incidents> اختیاری string عنصر <incidents> چندین پیام را جمع آوری می کند که به جنبه های مختلف یک حادثه اشاره دارد.
<info>

ضروری*

 info حداقل یک عنصر <info> باید وجود داشته باشد. چندین بلوک <info> همه باید دارای مقادیر عنصر <category> و <event> یکسان باشند.

* Google به عناصری نیاز دارد که دارای اختیاری پررنگ و قرمز REQUIRED باشند، اما این عناصر در استاندارد CAP اختیاری هستند.

مثال

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>