Ваши данные оповещений должны соответствовать спецификации OASIS Common Alerting Protocol v1.2 , а также спецификации Google Public Alerts CAP v1.0 и дополнительным требованиям, указанным ниже.
О Google CAP
Стандарт CAP устанавливает базовую структуру и элементы данных для оповещения CAP, но по-прежнему оставляет значительные возможности для несоответствий в том, как и когда используются различные элементы данных.
Наша платформа призвана упростить процесс поиска информации о чрезвычайных ситуациях, объединяя высококачественные и актуальные данные в онлайн-инструментах, которые люди уже используют каждый день. Дополнительные требования призваны обеспечить максимальный охват и эффективность ваших оповещений о продуктах Google.
Отличия Google от требований XML CAP 1.2 обобщены в спецификации Google Public Alerts CAP v1.0 .
Опция «Google Public Alerts CAP» в средстве проверки CAP с открытым исходным кодом позволяет вам проверять ваши данные на соответствие как спецификации OASIS, так и дополнительным требованиям Google.
Приведенные ниже рекомендации применимы ко всем типам предупреждений и опасностей. Мы также собрали несколько дополнительных требований и рекомендаций для этих конкретных типов оповещений в разделе «Примеры» :
Выполнять периодическое тестирование
- Убедитесь, что ваша система способна публиковать оповещения с помощью
<status>Test</status>, чтобы выполнять регулярные сквозные тесты системы.
Целевые зоны оповещения
- Если существуют несмежные области с одинаковым уровнем и типом оповещения, создайте отдельные сообщения
<alert>, а не одно<alert>с несвязанными областями. - Если элемент
<area>содержит элементы<polygon>, убедитесь, что это допустимые многоугольники без самопересекающихся краев или перекрывающихся многоугольников, и укажите точность до 6 десятичных знаков. - Если элемент
<area>ваших оповещений содержит геокоды, предоставьте геоданные в формате шейп-файла и уведомите Google по адресу google-public-alerts@google.com не менее чем за 30 дней до внесения изменений в шейп-файл. - Рисуйте полигоны с учетом воздействий, адаптированные к текущим условиям и характеру события, где это возможно, вместо того, чтобы нацеливать оповещения на заранее определенные геополитические области (например, провинции, районы).
- Предоставьте 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> для каждого языка).
Дополнительные сведения и пример многоязычного оповещения см. в разделе Несколько языков .