يجب أن تتوافق بيانات التنبيهات مع مواصفات Common Alerting Protocol (بروتوكول التحذيرات الشائعة) الإصدار 1.2 من OASIS، بالإضافة إلى مواصفات الإصدار 1.0 من Google Public Alerts CAP والمتطلبات الإضافية المذكورة أدناه.
لمحة عن Google CAP
يحدِّد معيار CAP البنية الأساسية وعناصر البيانات الخاصة بالتنبيهات في CAP، ولكنه لا يزال يترك مجالًا كبيرًا للتناقضات في كيفية استخدام عناصر البيانات المختلفة ووقت استخدامها.
تهدف منصتنا إلى تبسيط عملية العثور على معلومات الطوارئ من خلال جمع بيانات ذات صلة وعالية الجودة داخل أدوات على الإنترنت يستخدمها الأشخاص بشكل يومي. تهدف المتطلبات الإضافية إلى maximizing the reach and effectiveness of your alerts on Google products.
تم تلخيص الاختلافات الخاصة بـ Google مع متطلبات XML في CAP 1.2 في مواصفات الإصدار 1.0 من CAP الخاص بتنبيهات Google العامة.
يتيح لك خيار "Google Public Alerts CAP" في أداة CAP Validator ذات المصدر المفتوح التحقّق من صحة بياناتك مقارنةً بمواصفات OASIS ومتطلبات Google الإضافية.
تنطبق الإرشادات أدناه على جميع أنواع التنبيهات والمخاطر. لقد جمعنا أيضًا بعض المتطلبات والاقتراحات الإضافية لأنواع التنبيهات هذه في قسم عيّنات:
إجراء اختبارات دورية
- تأكَّد من أنّ نظامك قادر على نشر التنبيهات باستخدام
<status>الاختبار</status>لإجراء اختبارات منتظمة للنظام من البداية إلى النهاية.
استهداف المناطق التي يتم فيها عرض التنبيهات
- إذا كانت هناك مناطق غير متّصلة ضمن مستوى التنبيه ونوعه نفسهما، أنشئ
رسائل
<alert>منفصلة بدلاً من<alert>واحد يحتوي على مناطق غير متّصلة. - إذا كان عنصر
<area>يحتوي على عناصر<polygon>، تأكَّد من أنّها تشكل خطوطًا أساسية تشكل تضاريسًا منتظمة بدون حواف متداخلة أو خطوط أساسية متداخلة، وحدِّد دقة تشكل 6 نقاط عشرية كحد أقصى. - إذا كان عنصر
<area>في تنبيهاتك يتضمّن رموزًا جغرافية، قدِّم البيانات الجغرافية بتنسيق shapefile وأرسِل إشعارًا إلى Google على العنوان google-public-alerts@google.com قبل 30 يومًا على الأقل من إجراء أي تغييرات على ملف Shapefile. - ارسم مضلّعات مستندة إلى تأثير الحدث ومخصّصة للظروف الحالية و طبيعة الحدث كلما أمكن ذلك، بدلاً من توجيه التنبيهات إلى مناطق جغرافية سياسية محدّدة مسبقًا (مثل المحافظات والمناطق).
- قدِّم لـ Google وصفًا موجزًا (أقل من 50 حرفًا)
للمنطقة المتأثرة في
<areaDesc>أو في<parameter>مخصّص منفصل لتنبيهات CAP. سيتم عرض هذا النص في عنوان التنبيه.
تضمين محتوى وافٍ
- يجب تضمين محتوى غني وقابل للتنفيذ ويمكن لشخص عادي قراءته في عنصرَي
<description>و<instruction>. - يُرجى وصف الحدث الحالي والتطوّرات المتوقّعة والتأثير المتوقّع وال الاقتراحات حسب الاقتضاء.
- استخدِم القواعد الصحيحة نحويًا وإملائيًا وعلامات الترقيم.
- استخدِم نصًا عاديًا لتحسين سهولة قراءة المحتوى بدلاً من علامات HTML.
- قدِّم رموز ألوان RGB أو الست عشرية لكل مستوى تنبيه (يمكن تقديمها إلى Google بلا إنترنت).
تحديث التنبيهات
عند تغيير تنبيه، عليك إصدار تنبيه جديد يشير إلى التنبيه السابق، بدلاً من تغيير التنبيه الحالي أو إزالته من خلاصتك. بعد مرور فترة زمنية مناسبة (تصل إلى أسبوعَين)، أزِل تنبيهات CAP القديمة من خلاصتك.
<msgType> يجب أن يتضمّن العنصر UPDATE أو CANCEL عنصر <references> واحدًا على الأقل.
وفقًا لما هو محدّد في معيار CAP، يجب أن تستخدم أي رسالة تنبيه تعدّل تنبيهًا سابقًا<msgType>Update</msgType> وأن تضبط<references>code</references>
على جميع الرسائل ذات الصلة السابقة التي لم تصل إلى تاريخ<expires>.
يجب أن ينطبق الإجراء UPDATE أو CANCEL على تنبيه لم تنته صلاحيته.
هناك ثلاث طرق لإلغاء الأحداث، حسب الترتيب المفضّل:
- حدِّد تاريخًا ووقتًا
<expires>لكل حدث، مع تحديد وصف الرسالة لتوقع انتهاء هذا التنبيه تلقائيًا. - إصدار
<alert>جديد مع<msgType>UPDATE<responseType>"All Clear"و<expires>بعد فترة قصيرة في المستقبل - إصدار
<alert>جديد مع<msgType>CANCEL
يُرجى الاطّلاع على عيّنات من التنبيهات بشأن التعديلات والإلغاءات للحصول على أمثلة.
إتاحة لغات متعدّدة
يُرجى إنشاء عنصر <alert> واحد يحتوي على عدة عناصر <info>
(عنصر <info> واحد لكل لغة).
لمزيد من التفاصيل ونماذج التنبيهات المتعدّدة اللغات، يُرجى الاطّلاع على اللغات المتعددة.