info

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

Elementos de entidade info

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

Nome do elemento Opcionalidade Tipo CAP e notas 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> OBRIGATÓRIO InfoCategory O código <category> indica a categoria do evento de assunto da mensagem de alerta. Para identificar as categorias certas para seus eventos, consulte a lista de termos de eventos do OASIS. A categorização adequada pode ajudar o Google a mostrar o alerta com mais precisão aos usuários.
<event> OBRIGATÓRIO string

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

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

  • Reduza o comprimento para menos de 35 caracteres.
  • Liste um conjunto de tipos <event> predefinidos em uma planilha CSV ou Google (consulte este exemplo das Planilhas Google).
<responseType> OPCIONAL responseType

Para indicar o tipo de ação recomendada para o público-alvo correto, quando aplicável, recomendamos um elemento <responseType> junto com o valor do elemento <instruction> correspondente.
<urgency> OBRIGATÓRIO urgency

Não use o valor "Unknown" 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 <urgency> caso a caso e segue diretrizes claras de gatilho. No entanto, um elemento <event> pode corrigir o valor <urgency> e, assim, reduzir a flexibilidade dos autores de alertas. Por exemplo, a NOAA nos EUA define a urgência de forma estática com base no tipo de evento.
<severity> OBRIGATÓRIO severity

Não use o valor "Unknown" 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 <severity> caso a caso e segue diretrizes claras de gatilho. No entanto, um elemento <event> pode corrigir o valor <severity> e, assim, reduzir a flexibilidade dos autores de alertas. Por exemplo, a NOAA nos EUA define a urgência de forma estática com base no tipo de evento.
<certainty> OBRIGATÓRIO certainty

Não use o valor "Unknown" 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 <certainty> caso a caso e segue diretrizes claras de gatilho. No entanto, um elemento <event> pode corrigir o valor <certainty> e, assim, reduzir a flexibilidade dos autores de alertas. Por exemplo, a NOAA nos EUA define a urgência de forma estática com base no tipo de evento.
<audience> OPCIONAL string O valor do elemento <audience> é um texto que descreve o público-alvo pretendido 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>

em que:

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

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

Recomendamos que você extraia os valores do elemento <eventCode> da lista de termos de eventos do OASIS. Se você usar a lista de termos de eventos da OASIS, use OET:v1.2 como o nome do valor, conforme mostrado neste exemplo:

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

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

É necessário incluir campos de fuso horário em todos os valores de dateTime. Se o local citado no bloco <area> estiver em um único fuso horário, recomendamos que o elemento <effective> especifique o horário nesse fuso. Quando aplicável, inclua uma ressalva 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 (PDT).
<onset> OPCIONAL dateTime

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

Se o local citado no bloco <area> estiver em um único fuso horário, recomendamos que o elemento <effective> especifique o horário nesse fuso. Quando aplicável, inclua uma margem 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 (PDT).
<expires>

OBRIGATÓRIO*

 dateTime

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

Se não for possível definir um tempo de expiração para todos os alertas, informe ao Google um tempo de expiração padrão para os alertas que não tiverem um elemento <expires>. Por exemplo, você pode declarar que, por padrão, todos os alertas são definidos 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 de dateTime. Se o local citado no bloco <area> estiver em um único fuso horário, recomendamos que o elemento <effective> especifique o horário nesse fuso. Quando aplicável, inclua uma ressalva 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 (PDT).
<senderName> OPCIONAL string

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

Quando o remetente tem um nome legível para humanos, o link <web> pode ser mostrado de forma amigável, de acordo com as preferências do editor ou remetente. Além disso, o elemento <senderName> permite que os agregadores de alertas publiquem de várias autoridades.
<headline> OPCIONAL string

Reduza o comprimento das strings de elementos <headline> para 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 menos de 160 para mensagens de texto.) Comece a string com algumas palavras descritivas que expliquem o objetivo do alerta. Por exemplo, "Ponte fechada...."

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 por humanos que responda a estas perguntas:

  • O que está acontecendo ou está prestes a acontecer?
  • Onde isso está acontecendo?
  • Qual é a gravidade?

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

Você pode usar estas tags de 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 para humanos.

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

O elemento <instruction> é opcional, mas recomendamos o uso dele. 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. Faça com que os valores dos campos <instruction> e <description> sejam diferentes, porque eles têm finalidades diferentes.
<web>

OPCIONAL

 string

Vincule o elemento <web> a um URL que funcione e forneça mais informações sobre o alerta.
<contact> OPCIONAL string

O campo <contact> é opcional, mas recomendamos que ele esteja presente porque oferece uma maneira de os usuários enviarem feedback e responderem ao alerta. Por exemplo, "Em caso de emergência, ligue para 190".
<parameter> OPCIONAL string

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

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

em que:

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 em um bloco <info>.
<resource> OPCIONAL resource

O elemento <resource> fornece mais informações complementares relacionadas ao elemento <info> pai. Várias instâncias de um elemento <resource> podem ocorrer em 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 <geocode>.

* 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

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