Gerar alertas no formato CAP

Além do CAP Standard, siga os requisitos específicos do Google para arquivos CAP para garantir que os alertas sejam processados corretamente.

Há duas opções para gerar alertas:

  1. Geração automatizada: configure seu sistema para formatar dinamicamente as informações do banco de dados em um feed de CAP e enviá-lo automaticamente para o Google.
  2. Criação manual: crie e envie conteúdo de alerta manualmente, conforme necessário, por meio de um aplicativo baseado na Web.

Geração automatizada

Confira a biblioteca do Google CAP para começar a usar a linguagem de sua preferência. A biblioteca é compatível com a criação, análise e validação de feeds CAP.

A equipe do Google pode oferecer suporte durante a implementação. Entre em contato com sua equipe do Google ou envie um e-mail para google-public-alerts@google.com.

Criação manual

  1. Trabalhe com sua equipe de TI para instalar o aplicativo da Web de código aberto CAPCreatorTM em um servidor da Web. Como alternativa, você pode criar seu próprio aplicativo da Web.
  2. À medida que os eventos ocorrem, acesse o URL do aplicativo e use a interface para criar alertas no formato CAP.
  3. O aplicativo publica um feed em um local da Web. Em seguida, o Google extrai essas informações do feed publicado.

Elementos de alerta

A anatomia de um alerta

Um alerta precisa responder a estas perguntas importantes:

  1. O que está acontecendo?
  2. Quando isso vai acontecer?
  3. O que as pessoas devem fazer?
  4. Para onde vão os alertas?

Veja a seguir um exemplo simples de um alerta:

    <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>
            <instruction>
                Do not 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>

Confira nossos Alertas de limite de amostra para ver exemplos mais detalhados de alertas de trabalho que podem ser semelhantes aos seus.

Evento

A string <event> do CAP (ou às vezes o <headline>) aparece no título dos nossos alertas. Eles precisam ser curtos (menos de 35 caracteres) e descritivos o suficiente para que o público entenda. Para ver requisitos mais detalhados, consulte Elementos e subelementos <info> no guia de referência.

data

Os campos de fuso horário precisam ser incluídos em todos os valores de data/hora (como <effective>, <expires> e <onset>). Se o local citado no bloco <area> estiver em um único fuso horário, <effective> precisará especificar o horário nessa zona, incluindo a permissão de horário de verão, quando aplicável. Quando o conteúdo de uma mensagem se aplica a vários fusos horários, o produtor da mensagem precisa usar o fuso horário UTC em vez dos horários locais.

Instruções para

O campo <instruction> do alerta CAP aparece nas páginas de detalhes do alerta como a "ação recomendada". O conteúdo desse elemento não deve ser igual ao elemento <description>, que é mais adequado para resumir a natureza e a intensidade do alerta e a área afetada.

Área de notificação de

O elemento <area> do alerta CAP precisa descrever a área geográfica a ser notificada, o que pode incluir locais fora da área do incidente. Por exemplo, considere um alerta de incêndio: como os incêndios podem se espalhar rapidamente em áreas que não estão queimadas no momento, o <area> precisa cobrir toda a zona de perigo em potencial, não apenas o ponto de origem do incêndio ou a área de queima atual.

Especificar áreas como polígonos

As áreas de alerta são melhor definidas como polígonos porque tendem a ser mais precisas. O ideal é que o valor do elemento <area> seja definido como a área geográfica específica afetada pelas condições atuais ou previstas, e não por áreas geopolíticas predeterminadas, como distritos ou províncias. Isso garante que os usuários vejam o alerta relevante para a localização deles. Por exemplo, alertas de tempestade ou trovoadas podem afetar apenas uma pequena parte de uma jurisdição política, e avisos de neve provavelmente afetam apenas usuários localizados acima de uma determinada altitude. Em casos como esse, especificar um distrito ou província inteira como o <area> do alerta CAP superestima a área afetada e torna o alerta menos útil.

Na nossa experiência, o ideal é usar softwares ou ferramentas de alerta que permitam aos previsões fazer um polígono personalizado na área que eles querem alertar.

Se você usar polígonos, recomendamos incluir no máximo de 5 a 6 casas decimais de precisão nas coordenadas de latitude/longitude. Isso produz uma resolução maior do que a maioria dos sistemas de alerta poderia segmentar. Além disso, verifique se os polígonos são válidos. Por exemplo, eles não devem ter bordas que se cruzam.

Especificar áreas como geocódigos

Se você precisar especificar <area> como um geocódigo ou conjunto de vários geocódigos, use ele no nível mais granular possível e inclua os nomes das cidades específicas, as cidades etc. que provavelmente serão afetadas no elemento <description>. Você precisará compartilhar os shapefiles no formato de um shapefile.

Compatibilidade com vários idiomas

Crie um <alert> contendo vários blocos <info> (um bloco <info> por idioma).

Para mais detalhes e um exemplo de alerta multilíngue, consulte a Amostra de vários idiomas (link em inglês).

Validar alertas de CAP

Recomendamos que você use a ferramenta de CAP Validator de código aberto do Google para validar seus alertas de CAP. Você também pode se inscrever para receber e-mails de notificação de erros por meio dessa ferramenta. O validador oferece vários exemplos e opções de validação de CAP:

captura de tela do validador

Selecione Avisos Públicos do Google CAP v1.0 para validar a conformidade com os requisitos específicos do Google para feeds CAP.

Para se inscrever para receber e-mails de notificação de erros, clique em Inscrever-se nos resultados de validação do feed ou acesse http://cap-validador.appspot.com/subscribe. É necessário informar o URL do feed e o endereço de e-mail, selecionar CAP (alertas públicos do Google) v1.0 e clicar em Inscrever-se. Você vai receber uma notificação quando problemas forem encontrados no seu feed CAP.

Os editores de alertas também podem fazer o download da versão mais recente do esquema do Google CAP na biblioteca CAP e validá-lo off-line.

Próxima etapa: enviar ao Google o feed de alertas