alerta

Para definir información básica sobre un evento actual, usa la entidad <alert>.

Si un evento ocupa más de una ubicación en curso al mismo tiempo, es mejor dividir el evento en varios objetos alert. Por ejemplo, si un incendio forestal abarca varios estados, puedes dividir las alertas en varias alertas, una para cada estado. De esa manera, proporcionas información específica de emergencia a cada estado y actualizas la situación de incendio con mayor precisión.

Si un evento cambia con rapidez, como un huracán que se mueve de este a oeste, te recomendamos que realices actualizaciones periódicas en la alerta. No quites la alerta existente de tu feed. En cambio, emite una alerta nueva que haga referencia a la alerta anterior.

Atributos

En la tabla 1, se describe el valor del atributo de la entidad <alert>:

Tabla 1: Atributo de entidad <alert>

Nombre del elemento Opcional Tipo Descripción
xmlns:cap REQUIRED string

El atributo xmlns debe hacer referencia al URN de la CAP como el espacio de nombres.

Ejemplo:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

Elementos

En la tabla 2, se describen los valores de subelementos para la entidad <alert>:

Tabla 2: <alert> elementos de entidad

Nombre del elemento Opcional Tipo Notas y requisitos del CAP y de Google
<identifier> REQUIRED string Proporciona el ID de la alerta que representa el evento. El valor del elemento <identifier> debe ser único en todos los eventos.
<sender> REQUIRED string El elemento <sender> identifica el creador de la alerta. No puede incluir espacios, comas ni caracteres restringidos.
<sent> REQUIRED dateTime

Si la ubicación citada en el bloque <area> se encuentra dentro de una sola zona horaria, usa el elemento <sent> para especificar la hora en esa zona. Cuando corresponda, incluye una asignación para el horario de verano.

Cuando el contenido de un mensaje se aplique en varias zonas horarias, usa las horas UTC en lugar de las horas locales.
<status> REQUIRED AlertStatus

Google solo publica alertas disponibles públicamente que tienen un valor <status> del elemento Actual.
<msgType> REQUIRED AlertMsgType

Un <msgType> CANCEL o UPDATE debe incluir al menos un elemento <references>. El estándar CAP especifica lo siguiente:

  • Cualquier mensaje de alerta que actualice una alerta anterior usa UPDATE y establece los valores del elemento <references> en todos los mensajes anteriores que no alcanzaron su fecha <expires>.
  • Los elementos UPDATE o CANCEL <msgType> deben aplicarse a una alerta sin vencer. Por lo tanto, se debe hacer referencia a todos los mensajes relacionados y las alertas no vencidas cuando se emite un UPDATE o una <msgType> de CANCEL.

Para obtener más información, consulta Cambios o vencimiento de los eventos.
<source> OPCIONAL string El elemento <source> denota la fuente particular de la alerta. Un ejemplo es un operador o un dispositivo específico.
<scope> REQUIRED AlertScope

El elemento <scope> denota la distribución prevista del mensaje de alerta.
<restriction> CONDIcional string Si el valor del elemento <scope> es Restricted, el elemento <restriction> es obligatorio. Este elemento describe la regla para limitar la distribución del mensaje de alerta restringido.
<addresses> CONDIcional string Si el valor del elemento <scope> es Private, el elemento <addresses> es obligatorio. Este elemento enumera el destinatario del mensaje de alerta. Puedes incluir varias direcciones delimitadas por espacios, pero debes encerrar direcciones que incluyan espacios en blanco entre comillas dobles.
<code> OPCIONAL string

El elemento <code> denota un manejo especial del mensaje de alerta.
<note> CONDIcional string

Si la alerta contiene cualquiera de los siguientes valores de elementos, se requiere el elemento <note>:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CONDIcional string

Si el valor del elemento <msgType> es UPDATE o CANCEL, se requiere el elemento <references>.

Cuando tu sistema vuelva a publicar contenido de CAP desde otro publicador, incluye la alerta de CAP completa. Para vincular contenido editado a la fuente original, usa la etiqueta <references>.

Si haces referencia a varios mensajes, usa espacios en blanco como delimitador.
<incidents> OPCIONAL string El elemento <incidents> recopila varios mensajes que hacen referencia a diferentes aspectos del mismo incidente.
<info>

OBLIGATORIO*

 info Debe haber al menos un elemento <info>. Varios bloques <info> deben tener los mismos valores de elementos <category> y <event>.

* Google requiere elementos que tengan la opción REQUIRED en negrita y color rojo, pero esos elementos son opcionales en el estándar de CAP.

Ejemplo

<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>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't 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>