معلومات

يحدِّد الكيان <info> تفاصيل التنبيه. يجب توفير كتلة <info> واحدة على الأقل للتنبيه. إذا كنت تستخدم لغات متعددة، ننصحك باستخدام مجموعة <info> واحدة لكل لغة للكيان <alert> نفسه.

info عنصر كيان

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

اسم العنصر الاختيارية Type متطلبات CAP وGoogle والملاحظات
<language> اختياري language

بالنسبة إلى قيمة الرمز <language>، ننصحك باستخدام معيار RFC 3066 صالح.

وإذا لم يكن العنصر <language> متوفّرًا، تكون القيمة التلقائية هي en-US.
<category> مطلوبة InfoCategory يشير الرمز <category> إلى فئة موضوع الرسالة في التنبيه. لتحديد الفئات المناسبة لفعالياتك، يمكنك الرجوع إلى قائمة بنود فعاليات OASIS. ويمكن أن يساعد التصنيف الصحيح Google في عرض التنبيه بدقة أكبر للمستخدمين.
<event> مطلوبة string

يشير العنصر <event> إلى نوع الحدث في رسالة التنبيه.

في ما يلي متطلبات Google للعنصر <event>:
<responseType> اختياري responseType

للإشارة إلى نوع الإجراء المقترَح للجمهور المناسب، عندما يكون ذلك منطبقًا، ننصح بشدة باستخدام العنصر <responseType>، بالإضافة إلى قيمة العنصر <instruction> التي تتوافق معها.
<urgency> مطلوبة urgency

لا تستخدم القيمة غير معروفة للعنصر <urgency> لأنّ هذه القيمة تجعل من الصعب فهرسة التنبيهات والترتيب النسبي.

من المهم أن يتعرّف محرّك البحث Google على كيفية ضبط الحقل <urgency> ومَن الأشخاص. هذه المعلومات خارج نطاق الملف التجاري الرسمي.

ويفضّل الناشر ضبط القيمة <urgency> على أساس كل حالة على حدة، كما أنّه يتّبع إرشادات واضحة حول عامل التشغيل. ومع ذلك، قد يؤدي العنصر <event> إلى إصلاح القيمة <urgency>، ما يقلل من مرونة مؤلفي التنبيهات. على سبيل المثال، تحدّد الإدارة الوطنية للمحيطات والغلاف الجوي (NOAA) في الولايات المتحدة حالة عاجلة بشكل ثابت استنادًا إلى نوع الفعالية.
<severity> مطلوبة severity

لا تستخدم القيمة غير معروفة للعنصر <severity> لأنّ هذه القيمة تجعل من الصعب فهرسة التنبيهات والترتيب النسبي.

من المهم أن يتعرّف محرّك البحث Google على كيفية ضبط الحقل <severity> ومَن الأشخاص. هذه المعلومات خارج نطاق الملف التجاري الرسمي.

ويفضّل الناشر ضبط القيمة <severity> على أساس كل حالة على حدة، كما أنّه يتّبع إرشادات واضحة حول عامل التشغيل. ومع ذلك، قد يؤدي العنصر <event> إلى إصلاح القيمة <severity>، ما يقلل من مرونة مؤلفي التنبيهات. على سبيل المثال، تحدّد الإدارة الوطنية للمحيطات والغلاف الجوي (NOAA) في الولايات المتحدة حالة عاجلة بشكل ثابت استنادًا إلى نوع الفعالية.
<certainty> مطلوبة certainty

لا تستخدم القيمة غير معروفة للعنصر <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 بتوقيت المحيط الهادئ.
<onset> اختياري dateTime

قيمة العنصر <onset> هي الوقت المتوقّع عند بدء حدث موضوع رسالة التنبيه. عليك إدراج حقول المنطقة الزمنية في جميع قيم dateTime.

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

عندما ينطبق محتوى رسالة على عدة مناطق زمنية، نقترح أن يستخدم منتج الرسالة أوقات التوقيت العالمي المفضّل (UTC) على التوقيت المحلي.

مثال:

2002-05-24T16:49:00-07:00 يمثّل 24 أيار (مايو) 2002 في الساعة 16:49 بتوقيت المحيط الهادئ.
<expires>

مطلوبة*

 dateTime

قيمة العنصر <expires> هي وقت انتهاء صلاحية حدث موضوع رسالة التنبيه. يجب أن يأتي عنصر <expires> بعد عنصر <effective> بالترتيب الزمني.

إذا لم تتمكّن من ضبط وقت انتهاء الصلاحية لجميع التنبيهات، يجب تزويد Google بوقت انتهاء صلاحية تلقائي لأي تنبيهات لا تتضمن عنصر <expires>. على سبيل المثال، يمكنك الإشارة إلى أنّه يتم ضبط جميع التنبيهات تلقائيًا على أن تنتهي صلاحيتها بعد 48 ساعة في حال عدم توفّر عنصر <expires>.

يجب تضمين حقول المنطقة الزمنية في جميع قيم dateTime. إذا كان الموقع الجغرافي المذكور في المجموعة <area> يقع ضمن منطقة زمنية واحدة، نقترح أن يحدّد العنصر <effective> الوقت في تلك المنطقة. يُرجى تضمين مخصّص التوقيت الصيفي، إن أمكن.

عندما ينطبق محتوى رسالة على عدة مناطق زمنية، نقترح أن يستخدم منتج الرسالة أوقات التوقيت العالمي المفضّل (UTC) على التوقيت المحلي.

مثال:

2002-05-24T16:49:00-07:00 يمثّل 24 أيار (مايو) 2002 في الساعة 16:49 بتوقيت المحيط الهادئ.
<senderName> اختياري string

يُعدّ العنصر <senderName> اختياريًا ولكن ننصح به بشدة.

عندما يكون للمُرسِل اسم قابل للقراءة، يمكن أن يظهر الرابط <web> بطريقة سهلة للمستخدم، وفقًا للإعدادات المفضّلة للناشر أو المُرسِل. بالإضافة إلى ذلك، يسمح العنصر <senderName> لعارضي التنبيهات بنشر المحتوى من عدة هيئات.
<headline> اختياري string

يجب ألا يزيد طول سلاسل عناصر <headline> عن 140 حرفًا.

يمكن أن تكون سلسلة <headline> نصًا مفتوحًا، ولكننا ننصح باستخدامها أقل من 140 حرفًا. (يشير العنوان CAP1 2.2 إلى أقل من 160 للرسائل النصية). ابدأ هذه السلسلة ببعض الكلمات الوصفية التي توضّح جوهر التنبيه. ومن الأمثلة على ذلك "إغلاق جسر عائم"..."

لا تستخدم القيم نفسها للعناصر <headline> و<description>. يجب توفير المزيد من التفاصيل في العنصر <description> بدلاً من العنصر <headline>.
<description>

مطلوبة*

 string

قيمة العنصر <description> هي نص يصف موضوع حدث رسالة التنبيه.

ننصح بنشر محتوى غني بالمعلومات ومفيد للمستخدمين يجيب عن الأسئلة التالية:

  • ما الذي يحدث أو على وشك حدوثه؟
  • أين سيحدث ذلك؟
  • ما مدى سوء ذلك؟

يستخدم محرّك البحث Google العنصر <description> لتعبئة قسم الرسالة في صفنا، كما يستخدم العنصر <instruction> لتعبئة القسم الإجراءات المقترَحة. ويكون كلا الحقلين مرئيين للمستخدمين.

يمكنك استخدام علامات Markdown المتوافقة هذه: <newline> و<b> و<a href>.
<instruction> اختياري string

قيمة العنصر <instruction> هي نص يصف الإجراءات المقترَحة لمستلمي رسالة التنبيه. ننصحك بنشر محتوى غني بالمعلومات ومفيد للمستخدمين.

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

العنصر <instruction> اختياري، ولكننا ننصح بشدة باستخدامه. تستخدم "تنبيهات Google العامة" الحقل <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 عناصر تحتوي على الخيار مطلوبة بالخط الغامق والأحمر، ولكنّ هذه العناصر اختيارية في معيار الحدّ الأقصى.

مثال

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