alerta

Para definir informações básicas sobre um evento atual, use a entidade <alert>.

Se um evento ocupar mais de um local em andamento ao mesmo tempo, é melhor dividi-lo em vários objetos alert. Por exemplo, se um incêndio florestal abrange vários estados, você pode dividir os alertas em vários alertas, um para cada estado. Dessa forma, você fornece informações de emergência específicas para cada estado e atualiza a situação de incêndio com mais precisão.

Se um evento mudar rapidamente, como um furacão que se move do leste para o oeste, recomendamos que você faça atualizações periódicas no alerta. Não remova o alerta do feed. Em vez disso, emita um novo alerta referente ao alerta anterior.

Atributos

A tabela 1 descreve o valor do atributo para a entidade <alert>:

Tabela 1. Atributo de entidade <alert>

Nome do elemento Opcional Tipo Descrição
xmlns:cap REQUIRED string

O atributo xmlns precisa referenciar o CAP URN como o namespace.

Exemplos

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

Elementos

A Tabela 2 descreve os valores de subelementos da entidade <alert>:

Tabela 2. Elementos da entidade <alert>

Nome do elemento Opcional Tipo CAP e observações e requisitos do Google
<identifier> REQUIRED string Informe o código do alerta que representa o evento. O valor do elemento <identifier> precisa ser exclusivo em todos os eventos.
<sender> REQUIRED string O elemento <sender> identifica o originador do alerta. Ele não pode incluir espaços, vírgulas ou caracteres restritos.
<sent> REQUIRED dateTime

Se o local citado no bloco <area> estiver dentro de um único fuso horário, use o elemento <sent> para especificar o horário nessa zona. Quando aplicável, inclua uma cota para o horário de verão.

Quando o conteúdo de uma mensagem se aplica a vários fusos horários, use os horários UTC, em vez dos horários locais.
<status> REQUIRED AlertStatus

O Google publica apenas alertas disponíveis publicamente que têm um valor de elemento <status> de Actual.
<msgType> REQUIRED AlertMsgType

Um UPDATE ou CANCEL <msgType> precisa incluir pelo menos um elemento <references>. O padrão CAP especifica o seguinte:

  • Qualquer mensagem de alerta que atualiza um alerta anterior usa UPDATE e define valores de elemento <references> para todas as mensagens anteriores que não atingiram a data <expires>.
  • O elemento UPDATE ou CANCEL <msgType> precisa ser aplicado a um alerta não expirado. Portanto, todas as mensagens relacionadas e alertas não expirados precisam ser referenciados quando um UPDATE ou CANCEL <msgType> é emitido.

Para mais informações, consulte Expiração ou alterações de eventos.
<source> OPCIONAL string O elemento <source> indica a origem específica do alerta. Um exemplo é um operador ou dispositivo específico.
<scope> REQUIRED AlertScope

O elemento <scope> indica a distribuição pretendida da mensagem de alerta.
<restriction> CONDICIONAL string Se o valor do elemento <scope> for Restricted, o elemento <restriction> será obrigatório. Esse elemento descreve a regra para limitar a distribuição da mensagem de alerta restrita.
<addresses> CONDICIONAL string Se o valor do elemento <scope> for Private, o elemento <addresses> será obrigatório. Esse elemento lista o destinatário pretendido da mensagem de alerta. É possível incluir vários endereços delimitados por espaços, mas é necessário colocar endereços que incluam espaços em branco entre aspas duplas.
<code> OPCIONAL string

O elemento <code> indica um tratamento especial da mensagem de alerta.
<note> CONDICIONAL string

Se o alerta contiver um dos seguintes valores de elemento, o elemento <note> será obrigatório:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CONDICIONAL string

Se o valor do elemento <msgType> for UPDATE ou CANCEL, o elemento <references> será obrigatório.

Quando seu sistema republicar o conteúdo CAP de outro editor, inclua o alerta CAP completo. Para vincular o conteúdo editado à fonte original, use a tag <references>.

Se você referenciar várias mensagens, use espaços em branco como delimitador.
<incidents> OPCIONAL string O elemento <incidents> agrupa várias mensagens que se referem a diferentes aspectos do mesmo incidente.
<info>

OBRIGATÓRIO*

 info Pelo menos um elemento <info> precisa estar presente. Vários blocos <info> precisam ter os mesmos valores de elementos <category> e <event>.

* O Google exige elementos que tenham uma opção em negrito e vermelho REQUIRED, mas esses elementos são opcionais no padrão CAP.

Exemplo

<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>