داده‌های هشدار شما باید از مشخصات OASIS Common Alerting Protocol v1.2 ، به علاوه مشخصات Google Public Alerts CAP v1.0 و الزامات اضافی که در زیر ذکر شده است، پیروی کنند.
درباره Google CAP
استاندارد CAP ساختار اساسی و عناصر داده را برای هشدار CAP ایجاد می کند، اما هنوز هم فضای قابل توجهی برای تناقضات در نحوه و زمان استفاده از عناصر مختلف داده باقی می گذارد.
هدف پلتفرم ما ساده‌سازی فرآیند یافتن اطلاعات اضطراری با گردآوری داده‌های با کیفیت بالا و مرتبط در ابزارهای آنلاین است که مردم در حال حاضر هر روز از آنها استفاده می‌کنند. الزامات اضافی برای به حداکثر رساندن دسترسی و اثربخشی هشدارهای شما در محصولات Google است.
تفاوت های خاص Google با الزامات CAP 1.2 XML در مشخصات Google Public Alerts CAP v1.0 خلاصه شده است.
گزینه "Google Public Alerts CAP" در CAP Validator منبع باز به شما این امکان را می دهد که داده های خود را بر اساس مشخصات OASIS و الزامات اضافی Google تأیید کنید.
دستورالعمل های زیر برای همه انواع هشدارها و خطرات اعمال می شود. ما همچنین چند مورد الزامات و توصیه های اضافی را برای این انواع هشدارهای خاص در بخش نمونه های خود جمع آوری کرده ایم:
آزمایش دوره ای انجام دهید
- مطمئن شوید که سیستم شما قادر به انتشار هشدارها با
<status>Test</status>برای انجام آزمایش‌های منظم سیستمی سرتاسر است.
مناطق هشدار را هدف قرار دهید
- اگر نواحی غیرهمجوار در زیر یک سطح و نوع هشدار وجود دارد، پیام‌های
<alert>جداگانه به جای یک<alert>منفرد با نواحی از هم گسسته ایجاد کنید. - اگر عنصر
<area>حاوی عناصر<polygon>باشد، اطمینان حاصل کنید که آنها چند ضلعی معتبر و بدون لبه های متقاطع هستند و حداکثر 6 نقطه اعشاری را با دقت مشخص کنید. - اگر عنصر
<area>هشدارهای شما حاوی ژئوکد است، داده‌های جغرافیایی را در قالب shapefile ارائه کنید و حداقل 30 روز قبل از تغییر شکل فایل به Google در google-public-alerts@google.com اطلاع دهید. - به جای هدف قرار دادن هشدارها به مناطق ژئوپلیتیکی از پیش تعریف شده (مثلاً استان ها، نواحی) چند ضلعی های مبتنی بر تأثیر را ترسیم کنید که برای شرایط فعلی و ماهیت رویداد هر جا ممکن است، سفارشی شده اند.
- در
<areaDesc>یا در یک<parameter>اختصاصی جداگانه از هشدارهای CAP خود، توضیح کوتاهی (کمتر از 50 کاراکتر) از منطقه آسیب دیده را به Google ارائه دهید. این متن در عنوان هشدار نمایش داده می شود.
شامل محتوای غنی
- محتوای غنی، کاربردی و قابل خواندن برای انسان را در عناصر
<description>و<instruction>قرار دهید. - رویداد جاری، پیشرفت‌های پیش‌بینی‌شده، تأثیرات مورد انتظار و توصیه‌ها را به صورت قابل اجرا توصیف کنید.
- از املا، دستور زبان و علائم نگارشی صحیح استفاده کنید.
- برای بهبود خوانایی محتوای خود به جای تگ های HTML از متن ساده یا علامت گذاری استفاده کنید.
- کدهای رنگی RGB یا هگز متناظر با هر سطح هشدار را ارائه کنید (می توان به صورت آفلاین به Google ارائه کرد).
به روز رسانی هشدارها
هنگامی که یک هشدار تغییر می کند، به جای تغییر یا حذف هشدار موجود از فید، یک هشدار جدید صادر کنید که به هشدار قبلی اشاره دارد. پس از مدت زمان مناسب (مثلاً 24-48 ساعت)، هشدارهای لغو شده، به روز شده یا منقضی شده را از فید خود حذف کنید.
<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> در هر زبان) ایجاد کنید.
برای جزئیات بیشتر و یک نمونه هشدار چند زبانه، به چند زبان مراجعه کنید.