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, será melhor dividir o evento em vários objetos alert. Por exemplo, se um incêndio florestal abranger vários estados, você poderá dividir os alertas em vários, um para cada estado. Dessa forma, você fornece informações de emergência específicas para cada estado e atualiza a situação do incêndio com mais precisão.

Se um evento mudar rapidamente, como um furacão que se move de leste para oeste, recomendamos que você faça atualizações periódicas do alerta. Não remova o alerta do seu feed. Em vez disso, emita um novo alerta que se refira 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 Opcionalidade Tipo Descrição
xmlns:cap OBRIGATÓRIO string

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

Exemplo:

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

Elementos

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

Tabela 2. Elementos de entidade <alert>

Nome do elemento Opcionalidade Tipo CAP e notas e requisitos do Google
<identifier> OBRIGATÓRIO string Informe o ID do alerta que representa o evento. O valor do elemento <identifier> precisa ser exclusivo em todos os eventos.
<sender> OBRIGATÓRIO string O elemento <sender> identifica o originador do alerta. Não pode incluir espaços, vírgulas ou caracteres restritos.
<sent> OBRIGATÓRIO dateTime

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

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

O Google só publica alertas disponíveis publicamente que tenham um valor de elemento <status> de Actual.
<msgType> OBRIGATÓRIO AlertMsgType

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

  • Qualquer mensagem de alerta que atualize um alerta anterior usa UPDATE e define os valores do 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 os alertas não expirados precisam ser referenciados quando um UPDATE ou CANCEL <msgType> for emitido.

Para mais informações, consulte Alterações ou expiração de eventos.
<source> OPCIONAL string O elemento <source> denota a origem específica do alerta. Um exemplo é um operador ou um dispositivo específico.
<scope> OBRIGATÓRIO AlertScope

O elemento <scope> denota 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 da mensagem de alerta. É possível incluir vários endereços separados por espaços, mas é necessário colocar os endereços que incluem 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 o sistema republicar o conteúdo de outro editor, inclua o alerta completo do CAP. Para vincular o conteúdo editado à fonte original, use a tag <references>.

Se você fizer referência a várias mensagens, use espaços em branco como delimitador.
<incidents> OPCIONAL string O elemento <incidents> reúne 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 elemento <category> e <event>.

* O Google exige elementos que tenham uma formatação em negrito e vermelho OBRIGATÓRIO, 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>