تنبيه

لتحديد المعلومات الأساسية عن حدث حالي، استخدِم الكيان <alert>.

إذا كان الحدث يشغل أكثر من موقع جغرافي واحد في الوقت نفسه، من الأفضل تقسيم الحدث إلى عدّة عناصر alert. على سبيل المثال، إذا انتشرت حريق في غابة في عدة ولايات، يمكنك تقسيم التنبيهات إلى عدة تنبيهات، واحدة لكل ولاية. وبهذه الطريقة، تقدّم معلومات طارئة محدَّدة لكل ولاية وتحدِّث حالة الحريق بدقة أكبر.

إذا تغيّر حدث سريع، مثل إعصار ينتقل من الشرق إلى الغرب، ننصحك عندئذٍ بإجراء تعديلات دورية على التنبيه. يجب عدم إزالة التنبيه الحالي من خلاصتك. وبدلاً من ذلك، أصدر تنبيهًا جديدًا يشير إلى التنبيه السابق.

السمات

يوضّح الجدول 1 قيمة السمة للكيان <alert>:

الجدول 1: سمة الكيان <alert>

اسم العنصر الاختيارية Type الوصف
xmlns:cap مطلوبة string

يجب أن تشير السمة xmlns إلى رقم RN URN كمساحة الاسم.

مثال:

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

العناصر

يوضّح الجدول 2 قيم العناصر الفرعية للكيان <alert>:

الجدول 2: <alert> عنصر كيان

اسم العنصر الاختيارية Type متطلبات CAP وGoogle والملاحظات
<identifier> مطلوبة string أدخِل رقم تعريف التنبيه الذي يمثّل الحدث. ويجب أن تكون قيمة العنصر <identifier> فريدة في جميع الأحداث.
<sender> مطلوبة string يحدد العنصر <sender> منشأ التنبيه. لا يمكن أن يحتوي على مسافات أو فواصل أو أحرف محظورة.
<sent> مطلوبة dateTime

إذا كان الموقع الجغرافي المذكور في المجموعة <area> يقع ضمن منطقة زمنية واحدة، استخدِم العنصر <sent> لتحديد الوقت في تلك المنطقة. أضِف مخصّصًا التوقيت الصيفي، إن أمكن.

وعند تطبيق محتوى رسالة على عدة مناطق زمنية، استخدِم أوقات التوقيت العالمي المفضّل للأوقات المحلية.
<status> مطلوبة AlertStatus

لا تنشر Google سوى التنبيهات المتاحة للجميع التي تتضمن قيمة العنصر <status> Actual.
<msgType> مطلوبة AlertMsgType

يجب أن تتضمن السمة UPDATE أو CANCEL <msgType> عنصر <references> واحدًا على الأقل. يحدد معيار CAP ما يلي:

  • تستخدم أي رسالة تنبيه تحديث تنبيه سابق تحديث وتضبط قيم عنصر <references> على جميع الرسائل السابقة التي لم تصل إلى تاريخ <expires>.
  • يجب أن ينطبق العنصر UPDATE أو CANCEL <msgType> على تنبيه غير منتهي الصلاحية. لذلك، يجب الإشارة إلى كل الرسائل ذات الصلة والتنبيهات غير المنتهية الصلاحية عند إصدار 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 عناصر تحتوي على الخيار مطلوبة بالخط الغامق والأحمر، ولكنّ هذه العناصر اختيارية في معيار الحدّ الأقصى.

مثال

<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>