Данные оповещений должны соответствовать спецификации 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 в автономном режиме).
Обновление оповещений
Когда оповещение изменяется, создайте новое оповещение , которое ссылается на предыдущее оповещение, вместо того, чтобы изменять или удалять существующее оповещение из вашей ленты. По прошествии соответствующего времени (например, 24–48 часов) удалите отмененные, обновленные или просроченные оповещения из своей ленты.
<msgType> UPDATE или CANCEL должен включать хотя бы один элемент <references> . Как указано в стандарте CAP, любое предупреждающее сообщение, которое обновляет предыдущее предупреждение, должно использовать <msgType>Update</msgType> и устанавливать <references>code</references> для всех предыдущих связанных сообщений, которые не достигли своей даты <expires> . . ОБНОВЛЕНИЕ или ОТМЕНА должны применяться к предупреждениям с неистекшим сроком действия.
Есть три способа ОТМЕНИТЬ события, в порядке предпочтения:
- Установите дату и время
<expires>для каждого события с описанием сообщения, устанавливающим ожидание того, что это оповещение закончится само по себе. - Выпустите новое
<alert>с<msgType>UPDATE,<responseType>"All Clear"и<expires>через короткое время в будущем. - Создайте новый
<alert>с<msgType>CANCEL.
См. наши примеры предупреждений об обновлениях и отменах .
Поддержка нескольких языков
Создайте одно <alert> , содержащее несколько блоков <info> (по одному блоку <info> на каждый язык).
Дополнительные сведения и пример многоязычного оповещения см. в разделе Несколько языков .