informações

A entidade <info> especifica os detalhes do alerta. É necessário pelo menos um bloco <info> para um alerta. Se você oferece suporte a vários idiomas, recomendamos usar um bloco <info> para cada idioma na mesma entidade <alert>.

Elementos da entidade info

A tabela a seguir descreve os valores de subelementos da entidade <info>:

Nome do elemento Opcional Tipo CAP e observações e requisitos do Google
<language> OPCIONAL language

Para o valor do código <language>, recomendamos que você use um RFC 3066 válido.

Se o elemento <language> não estiver presente, o valor padrão será en-US.
<category> REQUIRED InfoCategory O código <category> indica a categoria do evento em questão da mensagem de alerta. Para identificar as categorias certas dos seus eventos, consulte a lista de termos do evento OASIS. A categorização adequada ajuda o Google a mostrar o alerta com mais precisão aos usuários.
<event> REQUIRED string

O elemento <event> indica o tipo de evento de assunto da mensagem de alerta.

Os requisitos do Google para o elemento <event> são os seguintes:

  • Use menos de 35 caracteres.
  • Liste um conjunto de tipos predefinidos de <event> em uma planilha CSV ou do Google (veja este exemplo do Planilhas Google).
<responseType> OPCIONAL responseType

Para indicar o tipo de ação recomendada para o público correto, quando aplicável, recomendamos o uso de um elemento <responseType> com o valor de elemento <instruction> a que ele corresponde.
<urgency> REQUIRED urgency

Não use o valor desconhecido para o elemento <urgency> porque ele dificulta a indexação de alertas e classificações relativas.

É importante que o Google saiba como o campo <urgency> é definido e por quem. No entanto, essas informações estão fora do escopo do perfil formal.

De preferência, o editor define o valor de <urgency> para cada caso e segue diretrizes claras sobre os acionadores. No entanto, um elemento <event> pode corrigir o valor <urgency> e, assim, reduzir a flexibilidade dos autores de alerta. Por exemplo, a NOAA nos EUA define urgência de maneira estática com base no tipo de evento.
<severity> REQUIRED severity

Não use o valor desconhecido para o elemento <severity> porque ele dificulta a indexação de alertas e classificações relativas.

É importante que o Google saiba como o campo <severity> é definido e por quem. No entanto, essas informações estão fora do escopo do perfil formal.

De preferência, o editor define o valor de <severity> para cada caso e segue diretrizes claras sobre os acionadores. No entanto, um elemento <event> pode corrigir o valor <severity> e, assim, reduzir a flexibilidade dos autores de alerta. Por exemplo, a NOAA nos EUA define urgência de maneira estática com base no tipo de evento.
<certainty> REQUIRED certainty

Não use o valor desconhecido para o elemento <certainty> porque ele dificulta a indexação de alertas e classificações relativas.

É importante que o Google saiba como o campo <certainty> é definido e por quem. No entanto, essas informações estão fora do escopo do perfil formal.

De preferência, o editor define o valor de <certainty> para cada caso e segue diretrizes claras sobre os acionadores. No entanto, um elemento <event> pode corrigir o valor <certainty> e, assim, reduzir a flexibilidade dos autores de alerta. Por exemplo, a NOAA nos EUA define urgência de maneira estática com base no tipo de evento.
<audience> OPCIONAL string O valor do elemento <audience> é um texto que descreve o público-alvo da mensagem de alerta.
<eventCode> OPCIONAL string

O elemento <eventCode> contém um código específico do sistema que identifica o tipo de evento da mensagem de alerta no seguinte formato.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

onde:

  • valueName = uma string atribuída pelo usuário que designa o domínio do código. Se essas strings forem acrônimos, represente-as com letras maiúsculas sem pontos. Os exemplos são SAME, FIPS e ZIP.
  • value = uma string que indica o valor do elemento <eventCode>.

Várias instâncias de elementos <eventCode> podem ocorrer dentro de um bloco <info>.

É altamente recomendável receber os valores de elemento <eventCode> da lista de termos de eventos do OASIS. Se você usa a lista de termos de evento OASIS, use OET:v1.0 como o nome do valor, conforme mostrado neste exemplo:

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> OPCIONAL dateTime

O valor do elemento <effective> é o horário efetivo das informações na mensagem de alerta.

É necessário incluir campos de fuso horário em todos os valores dateTime. Se o local citado no bloco <area> estiver dentro de um único fuso horário, recomendamos que o elemento <effective> especifique 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, recomendamos que o produtor da mensagem use os horários UTC, em vez dos horários locais.

Exemplo:

2002-05-24T16:49:00-07:00 representa 24 de maio de 2002 às 16h49 (horário de Brasília).
<onset> OPCIONAL dateTime

O valor do elemento <onset> é o tempo esperado quando o evento de assunto da mensagem de alerta começa. É necessário incluir campos de fuso horário em todos os valores dateTime.

Se o local citado no bloco <area> estiver dentro de um único fuso horário, recomendamos que o elemento <effective> especifique 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, recomendamos que o produtor da mensagem use os horários UTC, em vez dos horários locais.

Exemplo:

2002-05-24T16:49:00-07:00 representa 24 de maio de 2002 às 16h49 (horário de Brasília).
<expires>

OBRIGATÓRIO*

 dateTime

O valor do elemento <expires> é o tempo de expiração do evento do assunto da mensagem de alerta. Um elemento <expires> precisa vir depois de um elemento <effective> na ordem de tempo.

Se não for possível definir um prazo de validade para todos os alertas, informe ao Google um prazo de validade padrão para os alertas que não tiverem um elemento <expires>. Por exemplo, é possível indicar que, por padrão, todos os alertas serão configurados para expirar após 48 horas, se não houver um elemento <expires>.

É necessário incluir campos de fuso horário em todos os valores dateTime. Se o local citado no bloco <area> estiver dentro de um único fuso horário, recomendamos que o elemento <effective> especifique 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, recomendamos que o produtor da mensagem use os horários UTC, em vez dos horários locais.

Exemplo:

2002-05-24T16:49:00-07:00 representa 24 de maio de 2002 às 16h49 (horário de Brasília).
<senderName> OPCIONAL string

Um elemento <senderName> é opcional, mas altamente recomendado.

Quando o remetente tem um nome legível, o link <web> pode ser exibido de maneira amigável, de acordo com as preferências do editor ou do remetente. Além disso, o elemento <senderName> permite que agregadores de alerta sejam publicados por várias autoridades.
<headline> OPCIONAL string

O comprimento das strings de elemento <headline> deve ter menos de 140 caracteres.

Uma string <headline> pode ser um texto aberto, mas recomendamos que ela tenha menos de 140 caracteres. O CAP 1.2 sugere mensagens inferiores a 160 para mensagens de texto. Comece essa string com algumas palavras descritivas que expliquem a essência do alerta. Um exemplo é "Fechamento de ponte do Ponteon..."

Não use os mesmos valores para os elementos <headline> e <description>. Forneça mais detalhes no elemento <description> do que no elemento <headline>.
<description>

OBRIGATÓRIO*

 string

O valor do elemento <description> é um texto que descreve o assunto do evento da mensagem de alerta.

Recomendamos conteúdo informativo e legível que responda a estas perguntas:

  • O que está acontecendo ou prestes a acontecer?
  • Onde isso está acontecendo?
  • O quanto é ruim?

O Google usa o elemento <description> para preencher a seção Mensagem da página e usa o elemento <instruction> para preencher a seção Ações recomendadas. Os dois campos são visíveis para os usuários.

É possível usar estas tags Markdown compatíveis: <newline>, <b> e <a href>.
<instruction> OPCIONAL string

O valor do elemento <instruction> é um texto que descreve as ações recomendadas para os destinatários da mensagem de alerta. Recomendamos conteúdo informativo e legível.

Liste as ações que se enquadram no nível de gravidade do alerta e que não são gerais. Use frases sucintas e que diferenciem maiúsculas de minúsculas e inclua dicas de segurança em que os leitores possam agir, com a dica mais importante primeiro.

O elemento <instruction> é opcional, mas altamente recomendado. Os Avisos Públicos do Google usam o campo <instruction> para preencher a seção Ações recomendadas nas páginas de detalhes do alerta. Os valores dos campos <instruction> e <description> precisam ser diferentes, porque têm finalidades diferentes.
<web>

OBRIGATÓRIO*

 string

Vincule o elemento <web> a uma cópia do alerta original, acessível no servidor da Web.
<contact> OPCIONAL string

O campo <contact> é opcional, mas recomendamos que ele esteja presente, já que fornece uma maneira de os usuários darem feedback e responderem ao alerta. Por exemplo, "Para emergências, ligue para 911".
<parameter> OPCIONAL string

O elemento <parameter> contém dados específicos do sistema no seguinte formato:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

onde:

valueName = uma string atribuída pelo usuário que designa o domínio do código.

value = um valor de string.

Várias instâncias de um elemento <parameter> podem ocorrer dentro de um bloco <info>.
<resource> OPCIONAL resource

O elemento <resource> fornece outras informações complementares relacionadas ao elemento pai <info>. Várias instâncias de um elemento <resource> podem ocorrer dentro de um bloco <info>.
<area>

OBRIGATÓRIO*

 area

O elemento <area> contém informações sobre a área de alerta do evento, não a área do incidente. Os blocos <area> precisam incluir pelo menos um elemento <circle>, <polygon> ou <geocode>.

Recomendamos o uso de um elemento <polygon> ou <circle> em vez de um elemento <geocode>.

* 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

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>