тревога

Чтобы определить основную информацию о текущем событии, используйте сущность <alert> .

Если событие одновременно занимает более одного текущего местоположения, лучше разделить событие на несколько объектов alert . Например, если лесной пожар охватывает несколько штатов, вы можете разбить оповещения на несколько оповещений, по одному для каждого штата. Таким образом, вы предоставляете конкретную информацию о чрезвычайной ситуации для каждого штата и более точно обновляете информацию о пожарной ситуации.

Если событие быстро меняется, например ураган, движущийся с востока на запад, мы рекомендуем периодически обновлять оповещение. Не удаляйте существующее оповещение из своей ленты. Вместо этого выдайте новое предупреждение, которое ссылается на предыдущее предупреждение.

Атрибуты

В таблице 1 описано значение атрибута объекта <alert> :

Таблица 1. Атрибут объекта <alert>

Имя элемента Опциональность Тип Описание
xmlns:cap НЕОБХОДИМЫЙ string

Атрибут xmlns должен ссылаться на CAP URN в качестве пространства имен.

Пример:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

Элементы

В таблице 2 описаны значения подэлементов объекта <alert> :

Таблица 2. Элементы сущности <alert>

Имя элемента Опциональность Тип Примечания и требования CAP и Google
<identifier> НЕОБХОДИМЫЙ string Укажите идентификатор оповещения, представляющего событие. Значение элемента <identifier> должно быть уникальным для всех событий.
<sender> НЕОБХОДИМЫЙ string Элемент <sender> идентифицирует отправителя оповещения. Он не может содержать пробелы, запятые или запрещенные символы.
<sent> НЕОБХОДИМЫЙ dateTime

Если местоположение, указанное в блоке <area> , попадает в один часовой пояс, используйте элемент <sent> , чтобы указать время в этом поясе. Если применимо, включите допуск на летнее время.

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

<status> НЕОБХОДИМЫЙ AlertStatus

Google публикует только общедоступные оповещения, у которых значение элемента <status> равно Actual .

<msgType> НЕОБХОДИМЫЙ AlertMsgType

UPDATE или CANCEL <msgType> должен включать хотя бы один элемент <references> . Стандарт CAP определяет следующее:

  • Любое предупреждающее сообщение, обновляющее предыдущее предупреждение, использует ОБНОВЛЯТЬ и устанавливает значения элемента <references> для всех предыдущих сообщений, которые не достигли даты <expires> .
  • Элемент UPDATE или CANCEL <msgType> должен применяться к оповещению с неистекшим сроком действия. Таким образом, при выдаче UPDATE или CANCEL <msgType> необходимо ссылаться на все связанные сообщения и оповещения с истекшим сроком действия.

Дополнительную информацию см. в разделе Изменения или истечение срока действия событий .

<source> НЕОБЯЗАТЕЛЬНЫЙ string Элемент <source> обозначает конкретный источник оповещения. Примером может служить оператор или конкретное устройство.
<scope> НЕОБХОДИМЫЙ AlertScope

Элемент <scope> обозначает предполагаемое распространение предупреждающего сообщения.

<restriction> УСЛОВНЫЙ string Если значение элемента <scope> — Restricted , то элемент <restriction> является обязательным. Этот элемент описывает правило, ограничивающее распространение ограниченного предупреждающего сообщения.
<addresses> УСЛОВНЫЙ string Если значение элемента <scope> — Private , то элемент <addresses> является обязательным. В этом элементе указан предполагаемый получатель предупреждающего сообщения. Вы можете включить несколько адресов, разделенных пробелами, но адреса, содержащие пробелы, необходимо заключать в двойные кавычки.
<code> НЕОБЯЗАТЕЛЬНЫЙ string

Элемент <code> обозначает специальную обработку предупреждающего сообщения.

<note> УСЛОВНЫЙ string

Если предупреждение содержит одно из следующих значений элемента, то элемент <note> является обязательным:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> УСЛОВНЫЙ string

Если значение элемента <msgType> — UPDATE или CANCEL , то элемент <references> является обязательным.

Когда ваша система повторно публикует контент CAP от другого издателя, включите полное оповещение CAP. Чтобы связать отредактированный контент с первоисточником, используйте тег <references> .

Если вы ссылаетесь на несколько сообщений, используйте пробелы в качестве разделителя.

<incidents> НЕОБЯЗАТЕЛЬНЫЙ string Элемент <incidents> объединяет несколько сообщений, относящихся к различным аспектам одного и того же инцидента.
<info>

НЕОБХОДИМЫЙ*

 info Должен присутствовать хотя бы один элемент <info> . Несколько блоков <info> должны иметь одинаковые значения элементов <category> и <event> .

* Google требуются элементы, отмеченные жирным и красным цветом ОБЯЗАТЕЛЬНАЯ необязательность, но эти элементы являются необязательными в стандарте CAP.

Пример

<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 Warning</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>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't 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>