Gerar alertas no formato CAP

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

Importante: verifique se o sistema pode publicar alertas com <status>Test</status> para realizar testes completos regulares do sistema.

Você tem 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 enviar automaticamente ao Google.
2. Criação manual: crie e envie manualmente o conteúdo do alerta conforme necessário usando um aplicativo baseado na Web.

Geração automatizada

Confira a biblioteca CAP do Google para começar a usar o idioma que preferir. A biblioteca oferece suporte à 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 [e-mail].

Criação manual

Observação: para garantir alta disponibilidade e proteção contra falhas de energia, Internet ou outros problemas, use um serviço de hospedagem em nuvem, como o Google Cloud Platform.

1. Trabalhe com sua equipe de TI para instalar o aplicativo da Web de código aberto CAPCreator™ 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. 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 acontece?
3. O que as pessoas devem fazer?
4. Para onde vão os alertas?

Confira a seguir um exemplo simples de alerta:

    <alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
        <identifier>AL20110412020900TornadoWarning</identifier>
        <sender>[e-mail]</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</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 Exemplos de alertas de CAP para conferir exemplos mais completos de alertas de funcionamento que podem ser semelhantes aos seus.

Evento

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

datas

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, o <effective> precisará especificar o horário nesse fuso, incluindo a permissão para o 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 deve usar horários UTC em vez de horários locais.

Instruções do

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 pode ser o mesmo que o <description>, que é mais adequado para resumir a natureza e a intensidade do alerta e a área afetada.

Área de notificação

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

Como especificar áreas como polígonos

As áreas de alerta são melhor fornecidas 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 que é afetada por condições atuais ou previstas, em vez de áreas geopolíticas predeterminadas, como distritos ou províncias. Isso ajuda a garantir que os usuários que recebem o alerta considerem relevante para a localização deles. Por exemplo, alertas de tempestade ou inundação podem afetar apenas uma pequena parte de uma jurisdição política, e alertas de nevasca provavelmente afetam apenas os usuários que estão localizados acima de uma determinada altitude. Em casos como esse, especificar um distrito ou uma província inteira como o <area> do alerta de 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 que os meteorologistas desenhem um polígono personalizado sobre a área que eles querem alertar.

Se você estiver usando polígonos, recomendamos incluir no máximo cinco ou seis casas decimais de precisão nas coordenadas de latitude/longitude. Isso produz uma resolução mais alta do que a maioria dos sistemas de alerta pode segmentar. Além disso, verifique se os polígonos são válidos. Por exemplo, eles não podem ter bordas que se cruzam.

Como especificar áreas como geocódigos

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

Suporte a vários idiomas

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

Para mais detalhes e um exemplo de alerta multilíngue, consulte o exemplo de vários idiomas.

Validar alertas de CAP

Recomendamos que você use a ferramenta de código aberto Validador de CAP do Google para validar seus alertas de CAP. Também é possível se inscrever para receber e-mails de notificação de erro usando essa ferramenta. O validador oferece várias opções e exemplos de validação de CAP:

Selecione Google Public Alerts CAP v1.0 para validar os requisitos específicos do Google para feeds CAP.

Para receber e-mails de notificação de erro, clique em Inscrever-se para receber resultados de validação de feed ou acesse http://cap-validator.appspot.com/subscribe. Você precisa informar o URL do feed e o endereço de e-mail, selecionar Google Public Alerts CAP v1.0 e clicar em Assinar. Você vai receber uma notificação quando encontrar problemas no seu feed de CAP.

Observação: o validador não verifica a conformidade com todos os requisitos do Google. A equipe do Google pode sugerir outros aprimoramentos.

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

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