Seus dados de alerta devem seguir as especificações do protocolo de alertas comuns v1.2 (em inglês) da OASIS, além da especificação Google Public Alerts CAP v1.0 e outros requisitos descritos abaixo.
Sobre o Google CAP
O padrão CAP estabelece a estrutura básica e os elementos de dados para um alerta CAP, mas ainda deixa espaço considerável para inconsistências em como e quando os vários elementos de dados são empregados.
O objetivo da nossa plataforma é simplificar o processo de localização de informações de emergência reunindo dados relevantes e de alta qualidade dentro de ferramentas on-line que as pessoas já usam todos os dias. Os requisitos adicionais são para maximizar o alcance e a eficácia dos seus alertas nos produtos do Google.
As diferenças específicas do Google com os requisitos de XML do CAP 1.2 estão resumidas na especificação CAP (alertas públicos) do Google v1.0.
A opção "quo" dos avisos públicos do Google no CAP" no CAP Validator de código aberto permite que você valide seus dados em comparação com a especificação OASIS e os requisitos adicionais do Google.
As diretrizes abaixo se aplicam a todos os tipos de alertas e perigos. Também adicionamos alguns requisitos e recomendações adicionais para esses tipos específicos de alerta na nossa seção Amostras:
Executar testes periódicos
- Verifique se o sistema publica alertas com o
<status>Teste</status>para realizar testes de sistema completos e completos.
Segmentar áreas de alerta
- Se houver áreas não contíguas com o mesmo nível e tipo de alerta, crie
mensagens
<alert>separadas em vez de uma única<alert>com áreas desvinculadas. - Se o elemento
<area>contiver elementos<polygon>, verifique se eles são polígonos válidos sem cruzar bordas e especifique um máximo de seis casas decimais de precisão. - Se o elemento
<area>de seus alertas contiver geocódigos, forneça os dados geográficos no formato shapefile e notifique o Google em google-public-alerts@google.com pelo menos 30 dias antes de qualquer arquivo de forma ser alterado. - Desenhe polígonos com base em impacto que sejam personalizados para as condições atuais e a natureza do evento sempre que possível, em vez de segmentar alertas para áreas geopolíticas predefinidas (por exemplo, províncias, distritos).
- Forneça ao Google uma breve descrição (de menos de 50 caracteres) da área afetada no
<areaDesc>ou em um<parameter>separado dedicado aos alertas do CAP. Esse texto será exibido no título do alerta.
Incluir conteúdo avançado
- Inclua conteúdo avançado, acionável e legível nos elementos
<description>e<instruction>. - Descreva o evento atual, os desenvolvimentos previstos, o impacto esperado e as recomendações conforme aplicável.
- Use ortografia, gramática e pontuação corretas.
- Use texto simples ou marcação para melhorar a legibilidade do conteúdo, em vez de tags HTML.
- Forneça códigos de cor hexadecimais ou RGB correspondentes a cada nível de alerta (pode ser fornecido off-line ao Google).
Atualização de alertas
Quando um alerta mudar, emita um novo alerta referente ao anterior, em vez de mudar ou remover o atual do feed. Após um período apropriado (por exemplo, de 24 a 48 horas), remova os alertas cancelados, atualizados ou expirados do seu feed.
<msgType>Atualizar ou cancelar precisa incluir pelo menos um elemento <references>.
Conforme especificado no padrão CAP, qualquer mensagem de alerta que atualize um alerta anterior deve usar <msgType>Update</msgType> e definir <references>code</references> para todas as mensagens relacionadas anteriores que não atingiram a data <expires>. UPDATE ou CANCEL precisam ser aplicadas a um alerta não vencido.
Há três maneiras de CANCELAR eventos, em ordem de preferência:
- Defina uma data e hora
<expires>para cada evento, com a descrição da mensagem definindo a expectativa de que esse alerta terminará por conta própria. - Emita um novo
<alert>com<msgType>UPDATE,<responseType>"All Clear"e<expires>por um curto período no futuro. - Emita um novo
<alert>com<msgType>CANCEL.
Veja exemplos em Alertas de atualizações e cancelamentos.
Compatibilidade com vários idiomas
Crie um <alert> contendo vários blocos <info> (um bloco <info> por idioma).
Para ver mais detalhes e ver um exemplo de alerta multilíngue, consulte Vários idiomas.