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 dividirlo en varios objetos alert. Por ejemplo, si un incendio forestal abarca varios estados, puedes dividir las alertas en varias, una para cada estado. De esta manera, proporcionas información de emergencia específica a cada estado y actualizas la situación de incendio con mayor precisión.

Si un evento cambia rápidamente, como un huracán que se mueve de este a oeste, te recomendamos que actualices la alerta de forma periódica. No quites la alerta existente de tu feed. En su lugar, emite una alerta nueva que haga referencia a la alerta anterior.

Atributos

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

Tabla 1: Atributo de entidad <alert>

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

El atributo xmlns debe hacer referencia a la URN de 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 los subelementos de la entidad <alert>:

Tabla 2: Elementos de entidad <alert>

Nombre del elemento Opcionalidad Tipo Notas y requisitos de CAP y 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 al 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 tolerancia para el horario de verano.

Cuando el contenido de un mensaje se aplica a 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 de elemento <status> de Actual.
<msgType> REQUIRED AlertMsgType

Un UPDATE o CANCEL <msgType> 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 hayan alcanzado su fecha <expires>.
  • El elemento <msgType> UPDATE o CANCEL debe aplicarse a una alerta que no haya vencido. Por lo tanto, se debe hacer referencia a todos los mensajes relacionados y las alertas sin vencer cuando se emite un <msgType> UPDATE o CANCEL.

Para obtener más información, consulta Cambios o vencimientos de 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> indica la distribución prevista del mensaje de alerta.
<restriction> CONDICIONAL string Si el valor del elemento <scope> es Restricted, se requiere el elemento <restriction>. Este elemento describe la regla para limitar la distribución del mensaje de alerta restringida.
<addresses> CONDICIONAL string Si el valor del elemento <scope> es Private, se requiere el elemento <addresses>. En este elemento, se enumera el destinatario del mensaje de alerta. Puedes incluir varias direcciones delimitadas por espacios, pero debes encerrar las direcciones que incluyen espacios en blanco entre comillas dobles.
<code> OPCIONAL string

El elemento <code> indica 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 de otro publicador, incluye la alerta de CAP completa. Para vincular el 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> presente. Los bloques <info> múltiples deben tener los mismos valores de los elementos <category> y <event>.

* Google requiere elementos que tengan la opción de ser opcionales con la palabra REQUIRED en negrita y en rojo, pero esos elementos son opcionales en el estándar 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>