تنبيه

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

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

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

السمات

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

الجدول 1: سمة <alert> للعنصر

اسم العنصر	الخيار	النوع	الوصف
xmlns:cap	مطلوب	string	يجب أن تشير سمة xmlns إلى معرّف URN الخاص بتنسيق CAP باعتبارها مساحة الاسم. مثال: <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> لتحديد الوقت في تلك المنطقة. يُرجى تضمين مخصص للتوقيت الصيفي، إن أمكن. عندما ينطبق محتوى الرسالة على مناطق زمنية متعدّدة، استخدِم توقيتات التوقيت العالمي المنسق بدلاً من التوقيتات المحلية.
<status>	مطلوب	AlertStatus	لا تنشر Google سوى التنبيهات المتاحة للجميع والتي تتضمن قيمة Actual لعنصر <status>. ملاحظة: قد تعلّق Google حسابات الناشرين الذين يرسلون رسائل اختبارية على أنّهم <status> Actual.
<msgType>	مطلوب	AlertMsgType	يجب أن يتضمّن UPDATE أو CANCEL <msgType> عنصرًا واحدًا على الأقل <references>. يحدِّد معيار CAP ما يلي: أي رسالة تنبيه تعدّل تنبيهًا سابقًا تستخدم UPDATE وتضبط قيم عنصر <references> على جميع الرسائل السابقة التي لم تصل إلى <expires> تاريخها. يجب أن ينطبق عنصر UPDATE أو CANCEL <msgType> على تنبيه لم تنته صلاحيته. لذلك، يجب الإشارة إلى جميع الرسائل ذات الصلة والتنبيهات غير المنتهية الصلاحية عند إصدار UPDATE أو CANCEL <msgType>. لمزيد من المعلومات، يُرجى الاطّلاع على تغييرات الأحداث أو انتهاء صلاحيتها.
<source>	اختياري	string	يشير العنصر <source> إلى مصدر التنبيه المحدّد. على سبيل المثال، مشغّل أو جهاز معيّن.
<scope>	مطلوب	AlertScope	يشير العنصر <scope> إلى التوزيع المقصود لرسالة التنبيه. ملاحظة: لا تنشر Google إلا تنبيهات ذات قيمة Public <scope>.
<restriction>	CONDITIONAL	string	إذا كانت قيمة العنصر <scope> هي Restricted، يجب إدخال العنصر <restriction>. يوضّح هذا العنصر القاعدة التي تحدّ من توزيع رسالة التنبيه المحظورة.
<addresses>	CONDITIONAL	string	إذا كانت قيمة العنصر <scope> هي Private، يجب استخدام العنصر <addresses>. يسرد هذا العنصر المستلِم المقصود لرسالة التنبيه. يمكنك تضمين عدة عناوين مفصولة بمسافات، ولكن يجب وضع علامتَي اقتباس حول العناوين التي تتضمّن مسافات بيضاء.
<code>	اختياري	string	يشير العنصر <code> إلى معالجة خاصة لرسالة التنبيه. ملاحظة: لا تسمح Google عادةً باستخدام العنصر <code>.
<note>	CONDITIONAL	string	إذا كان التنبيه يحتوي على أيّ من قيم العناصر التالية، يجب استخدام العنصر <note>: <status>Exercise></status> <msgType>Error></msgType>
<references>	CONDITIONAL	string	إذا كانت قيمة العنصر <msgType> هي UPDATE أو CANCEL، يجب استخدام العنصر <references>. عندما يعيد نظامك نشر محتوى CAP من ناشر آخر، أدرِج تنبيه CAP الكامل. لربط المحتوى المعدَّل بالمصدر الأصلي، استخدِم العلامة <references>. إذا كنت تشير إلى رسائل متعددة، استخدِم المسافة البيضاء كمحدِّد.
<incidents>	اختياري	string	يجمع عنصر <incidents> رسائل متعددة تشير إلى جوانب مختلفة من الحادثة نفسها.
<info>	مطلوبة*	info	يجب أن يتوفّر عنصر <info> واحد على الأقل. يجب أن تتضمّن كل مجموعات <info> المتعددة قيمًا متطابقة لعنصرَي <category> و<event>.

* تتطلّب Google العناصر التي تحمل مطلوبة باللون الأحمر الغامق، ولكن هذه العناصر اختيارية في معيار CAP.

مثال

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>[e-mail]</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>