Tus datos de alerta deben cumplir con la especificación del Protocolo de alertas comunes v1.2 de OASIS, además de la especificación del CAP v1.0 de Alertas públicas de Google y los requisitos adicionales que se mencionan a continuación.
Acerca del CAP de Google
El estándar CAP establece la estructura básica y los elementos de datos para una alerta de CAP, pero deja bastante espacio para las inconsistencias en cómo y cuándo se emplean los diversos elementos de datos.
El objetivo de nuestra plataforma es simplificar el proceso de encontrar información de emergencia mediante la recopilación de datos relevantes y de alta calidad dentro de herramientas en línea que las personas ya usan a diario. Los requisitos adicionales están destinados a maximizar el alcance y la efectividad de tus alertas en los productos de Google.
Las diferencias específicas de Google con los requisitos del XML del CAP 1.2 se resumen en la especificación del CAP v1.0 de Alertas públicas de Google.
La opción "CAP de Google Alertas Públicas" del Validador CAP de código abierto te permite validar tus datos en función de las especificaciones de OASIS y los requisitos adicionales de Google.
Los siguientes lineamientos se aplican a todos los tipos de alertas y peligros. También reunimos algunos requisitos y recomendaciones adicionales para estos tipos de alertas específicos en nuestra sección Ejemplos:
Realizar pruebas periódicas
- Asegúrate de que tu sistema sea capaz de publicar alertas con
<status>Test</status>para realizar pruebas periódicas del sistema de extremo a extremo.
Orientar anuncios a áreas de alerta
- Si hay áreas no contiguas con el mismo nivel y tipo de alerta, crea mensajes de
<alert>separados en lugar de un solo<alert>con áreas desarticuladas. - Si el elemento
<area>contiene elementos<polygon>, asegúrate de que sean polígonos válidos sin bordes que se crucen y especifica un máximo de 6 puntos decimales de precisión. - Si el elemento
<area>de tus alertas contiene geocódigos, proporciona los datos geográficos en formato shapefile y notifica a Google a la dirección google-public-alerts@google.com al menos 30 días antes de que se modifique cualquier archivo shapefile. - Dibuja polígonos basados en impactos que estén personalizados para las condiciones actuales y la naturaleza del evento siempre que sea posible, en vez de orientar alertas a áreas geopolíticas políticas (p.ej., provincias o distritos).
- Proporciona a Google una descripción breve (menos de 50 caracteres) del área afectada en el
<areaDesc>o en un<parameter>dedicado separado de tus alertas de CAP. Este texto se mostrará en el título de la alerta.
Incluir contenido enriquecido
- Incluye contenido enriquecido, accionable y legible en los elementos
<description>y<instruction>. - Describe el evento actual, los desarrollos previstos, el impacto esperado y las recomendaciones, según corresponda.
- Usa correctamente la ortografía, gramática y puntuación.
- Usa texto sin formato o markdown para mejorar la legibilidad del contenido, en lugar de las etiquetas HTML.
- Proporciona los códigos de color RGB o hexadecimales correspondientes a cada nivel de alerta (se pueden proporcionar a Google sin conexión).
Actualizar alertas
Cuando cambie una alerta, envíe una nueva que haga referencia a la alerta anterior, en lugar de cambiar o quitar la alerta existente de su feed. Después de un período adecuado (p.ej., de 24 a 48 horas), quita las alertas canceladas, actualizadas o vencidas de tu feed.
<msgType> UPDATE o CANCEL deben incluir al menos un elemento <references>.
Como se especifica en el estándar del CAP, cualquier mensaje de alerta que actualice una alerta anterior debe usar <msgType>Update</msgType> y establecer <references>code</references> en todos los mensajes relacionados anteriores que no hayan llegado a su fecha <expires>. La ACTUALIZACIÓN o la CANCELACIÓN deben aplicarse a una alerta sin vencimiento.
Hay 3 maneras de CANCELAR eventos, en orden de preferencia:
- Establece una fecha y hora
<expires>para cada evento. Para ello, configura la descripción del mensaje con la expectativa de que esta alerta finalice. - Genera una
<alert>nueva con<msgType>UPDATE,<responseType>"All Clear"y<expires>poco tiempo después. - Emite un nuevo
<alert>con<msgType>CANCEL.
Consulta nuestras Ejemplos de alertas para ver actualizaciones y cancelaciones como ejemplos.
Compatibilidad con varios idiomas
Crea un <alert> que contenga varios bloques <info> (un bloque <info> por idioma).
Para obtener más detalles y una alerta multilingüe de muestra, consulta Varios idiomas.