Генерировать оповещения в формате CAP

Помимо стандарта CAP , следуйте специальным требованиям Google к файлам CAP, чтобы обеспечить правильную обработку оповещений.

У вас есть 2 варианта создания оповещений:

  1. Автоматическое создание : настройте свою систему на динамическое форматирование информации из базы данных в канал CAP и автоматическую отправку ее в Google.
  2. Создание вручную : вручную создавайте и отправляйте содержимое оповещений по мере необходимости через веб-приложение.

Автоматизированная генерация

Ознакомьтесь с библиотекой Google CAP, чтобы начать работу на выбранном вами языке. Библиотека поддерживает создание, анализ и проверку каналов CAP.

Команда Google может оказать поддержку во время внедрения. Свяжитесь со своей командой Google или по адресу google-public-alerts@google.com .

Ручное создание

  1. Вместе со своей ИТ-командой установите веб-приложение с открытым исходным кодом CAPCreator™ на веб-сервер. Альтернативно вы можете создать собственное веб-приложение.
  2. При возникновении событий посещайте URL-адрес приложения и используйте интерфейс для создания оповещений в формате CAP.
  3. Ваше приложение публикует канал в веб-сайте; Затем Google извлекает эту информацию из вашего опубликованного фида.

Элементы оповещения

Анатомия оповещения

Предупреждение должно отвечать на следующие ключевые вопросы:

  1. Что происходит?
  2. Когда это происходит?
  3. Что делать людям?
  4. Куда идут оповещения?

Ниже приведен простой пример оповещения:

    <alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
        <identifier>AL20110412020900TornadoWarning</identifier>
        <sender>w-nws.webmaster@noaa.gov</sender>
        <sent>2011-04-11T21:18:07-05:00</sent>
        <status>Actual</status>
        <msgType>Alert</msgType>
        <scope>Public</scope>
        <info>
            <language>en-US</language>
            <category>Met</category>
            <event>Tornado</event>
            <urgency>Immediate</urgency>
            <severity>Extreme</severity>
            <certainty>Observed</certainty>
            <effective>2011-04-11T21:09:00-05:00</effective>
            <expires>2011-04-11T21:30:00-05:00</expires>
            <headline>Tornado Warning issued April 11 at
            9:30PM CDT by NWS Birmingham</headline>
            <instruction>
                Do not wait to see or hear the tornado.
            For your protection, move to an interior room on the
            lowest floor of your home or business.</instruction>
            <area>
                <areaDesc>Cleburne</areaDesc>
                <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
                33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
                33.61,-85.58</polygon>
            </area>
        </info>
    </alert>

Обязательно ознакомьтесь с нашими примерами оповещений CAP, где вы найдете более подробные примеры рабочих оповещений, которые могут быть похожи на ваши.

событие

Строка CAP <event> (или иногда <headline> ) появляется в заголовке наших оповещений. Они должны быть короткими (менее 35 символов) и достаточно информативными, чтобы их могла понять публика. Более подробные требования см. в элементах и ​​подэлементах <info> в справочном руководстве.

свидания

Поля часового пояса должны быть включены во все значения даты и времени (например, <effective> , <expires> и <onset> ). Если местоположение, указанное в блоке <area> попадает в один часовой пояс, <effective> должно указывать время в этом поясе, включая допуск на летнее время, когда это применимо. Когда содержимое сообщения распространяется на несколько часовых поясов, производитель сообщения должен использовать время UTC, а не местное время.

инструкции

Поле <instruction> предупреждения CAP отображается на страницах сведений о предупреждении как «рекомендуемое действие». Обратите внимание, что содержимое этого элемента не должно совпадать с <description> , который больше подходит для краткого описания характера и интенсивности предупреждения, а также затронутой области.

область уведомлений

Элемент <area> оповещения CAP должен описывать географическую область, о которой необходимо уведомить, которая может включать места за пределами зоны происшествия. Например, рассмотрим предупреждение о лесном пожаре: поскольку лесные пожары могут быстро распространиться на территории, которые в настоящее время не горят, <area> должна охватывать всю потенциально опасную зону, а не просто точку возникновения пожара или текущую зону горения.

Указание областей в виде многоугольников

Области оповещения лучше всего представлять в виде многоугольников, поскольку они имеют тенденцию быть более точными. В идеале значение элемента <area> определяется как конкретная географическая область, на которую влияют текущие или прогнозируемые условия, а не заранее определенные геополитические области, такие как районы или провинции. Это помогает гарантировать, что пользователи, которые увидят оповещение, сочтут его актуальным для своего местоположения. Например, предупреждения о грозе или наводнении могут затронуть лишь небольшую часть политической юрисдикции, а предупреждения о снегопаде, скорее всего, затронут только пользователей, находящихся выше определенной высоты. В подобных случаях указание всего района или провинции в качестве <area> области> предупреждения CAP приводит к переоценке затронутой территории и делает предупреждение менее полезным.

По нашему опыту, программное обеспечение или инструменты оповещения, которые позволяют синоптикам нарисовать собственный полигон над областью, которую они хотят предупредить, являются идеальными.

Если вы используете многоугольники, мы рекомендуем включать не более 5–6 десятичных знаков точности в координатах широты и долготы. (Это обеспечивает более высокое разрешение, чем может обеспечить большинство систем оповещения.) Кроме того, убедитесь, что полигоны действительны; например, у них не должно быть пересекающихся краев.

Указание областей как геокодов

Если вместо этого вам необходимо указать <area> в качестве геокода или набора нескольких геокодов, используйте геокоды на максимально детальном уровне и включите в элемент <description> названия конкретных городов, поселков и т. д., которые могут быть затронуты. Вам нужно будет поделиться базовыми шейп-файлами в формате шейп-файла .

Поддержка нескольких языков

Создайте один <alert> , содержащий несколько блоков <info> (по одному блоку <info> для каждого языка).

Дополнительные сведения и пример многоязычного оповещения см. в примере «Несколько языков» .

Проверка оповещений CAP

Мы рекомендуем вам использовать инструмент CAP Validator с открытым исходным кодом Google для проверки оповещений CAP. С помощью этого инструмента вы также можете подписаться на электронные письма с уведомлениями об ошибках. Валидатор предлагает несколько вариантов и примеров проверки CAP:

скриншот валидатора

Выберите Google Public Alerts CAP v1.0, чтобы проверить соответствие специальным требованиям Google к фидам CAP.

Чтобы подписаться на электронные письма с уведомлениями об ошибках, нажмите «Подписаться на получение результатов проверки » или перейдите по адресу http://cap-validator.appspot.com/subscribe . Вам необходимо указать URL-адрес своего канала и адрес электронной почты, выбрать Google Public Alerts CAP v1.0 и нажать «Подписаться» . Вы получите уведомление, когда в вашем канале CAP будут обнаружены проблемы.

Издатели Alert также могут загрузить последнюю версию схемы Google CAP из библиотеки CAP и проверить ее в автономном режиме.

Следующий шаг: отправьте в Google свой канал оповещений