info

La entidad <info> especifica los detalles de la alerta. Se requiere al menos un bloque de <info> para una alerta. Si admites varios idiomas, te recomendamos que uses un bloque <info> para cada idioma para la misma entidad <alert>.

info elementos de entidad

En la siguiente tabla, se describen los valores de los elementos secundarios para la entidad <info>:

Nombre del elemento Opcional Tipo Notas y requisitos del CAP y de Google
<language> OPCIONAL language

Para el valor de código <language>, te recomendamos que uses un RFC 3066 válido.

Si el elemento <language> no está presente, el valor predeterminado es en-US.
<category> REQUIRED InfoCategory El código <category> denota la categoría del evento del asunto del mensaje de alerta. A fin de identificar las categorías correctas para tus eventos, consulta la Lista de Condiciones de Eventos de OASIS. Una categorización correcta puede ayudar a que Google muestre la alerta de manera más precisa a los usuarios.
<event> REQUIRED string

El elemento <event> denota el tipo del evento del asunto del mensaje de alerta.

Los requisitos de Google para el elemento <event> son los siguientes:
<responseType> OPCIONAL responseType

A fin de indicar el tipo de acción recomendada para el público correcto, cuando corresponda, te recomendamos especialmente un elemento <responseType>, junto con el valor del elemento <instruction> al que corresponde.
<urgency> REQUIRED urgency

No uses el valor Desconocido para el elemento <urgency> porque ese valor dificulta la indexación de las alertas y clasificaciones relativas.

Es importante que Google sepa cómo se configuró el campo <urgency> y quién lo hizo. Sin embargo, esa información está fuera del alcance del perfil formal.

Preferentemente, el editor establece el valor de <urgency> caso por caso y sigue lineamientos claros del activador. Sin embargo, un elemento <event> podría corregir el valor <urgency> y, por lo tanto, reducir la flexibilidad de los autores de las alertas. Por ejemplo, la NOAA de EE.UU. establece la urgencia de manera estática en función del tipo de evento.
<severity> REQUIRED severity

No uses el valor Desconocido para el elemento <severity> porque ese valor dificulta la indexación de las alertas y clasificaciones relativas.

Es importante que Google sepa cómo se configuró el campo <severity> y quién lo hizo. Sin embargo, esa información está fuera del alcance del perfil formal.

Preferentemente, el editor establece el valor de <severity> caso por caso y sigue lineamientos claros del activador. Sin embargo, un elemento <event> podría corregir el valor <severity> y, por lo tanto, reducir la flexibilidad de los autores de las alertas. Por ejemplo, la NOAA de EE.UU. establece la urgencia de manera estática en función del tipo de evento.
<certainty> REQUIRED certainty

No uses el valor Desconocido para el elemento <certainty> porque ese valor dificulta la indexación de las alertas y clasificaciones relativas.

Es importante que Google sepa cómo se configuró el campo <certainty> y quién lo hizo. Sin embargo, esa información está fuera del alcance del perfil formal.

Preferentemente, el editor establece el valor de <certainty> caso por caso y sigue lineamientos claros del activador. Sin embargo, un elemento <event> podría corregir el valor <certainty> y, por lo tanto, reducir la flexibilidad de los autores de las alertas. Por ejemplo, la NOAA de EE.UU. establece la urgencia de manera estática en función del tipo de evento.
<audience> OPCIONAL string El valor del elemento <audience> es un texto que describe el público objetivo del mensaje de alerta.
<eventCode> OPCIONAL string

El elemento <eventCode> contiene código específico del sistema que identifica el tipo de evento del mensaje de alerta de la siguiente manera.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

Donde:

  • valueName: Una string asignada por el usuario que designa el dominio del código. Si esas strings son acrónimos, debes representarlas con mayúsculas, sin puntos. Algunos ejemplos son SAME, FIPS y ZIP.
  • value: Es una string que denota el valor del elemento <eventCode>.

Pueden producirse varias instancias de elementos <eventCode> dentro de un bloque <info>.

Te recomendamos que obtengas los valores del elemento <eventCode> de la lista de condiciones del evento de OASIS. Si usas la lista de términos del evento de OASIS, usa OET:v1.0 como el nombre del valor, como se muestra en este ejemplo:

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> OPCIONAL dateTime

El valor del elemento <effective> es la hora real de la información que aparece en el mensaje de alerta.

Debes incluir campos de zona horaria en todos los valores de dateTime. Si la ubicación citada en el bloque <area> se encuentra dentro de una sola zona horaria, recomendamos que el elemento <effective> especifique 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, recomendamos que el productor de mensajes utilice las horas UTC en lugar de las horas locales.

Example:

2002-05-24T16:49:00-07:00 representa el 24 de mayo de 2002 a las 16:49 (PDT).
<onset> OPCIONAL dateTime

El valor del elemento <onset> es el tiempo esperado cuando comienza el evento del asunto del mensaje de alerta. Debes incluir campos de zona horaria en todos los valores de dateTime.

Si la ubicación citada en el bloque <area> se encuentra dentro de una sola zona horaria, te recomendamos que el elemento <effective> especifique 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, recomendamos que el productor de mensajes utilice las horas UTC en lugar de las horas locales.

Example:

2002-05-24T16:49:00-07:00 representa el 24 de mayo de 2002 a las 16:49 (PDT).
<expires>

OBLIGATORIO*

 dateTime

El valor del elemento <expires> es la hora de vencimiento del evento del asunto del mensaje de alerta. Un elemento <expires> debe ir después de un elemento <effective> en orden temporal.

Si no puedes establecer una hora de vencimiento para todas tus alertas, proporciona a Google un tiempo de vencimiento predeterminado para cualquier alerta que no tenga un elemento <expires>. Por ejemplo, puedes indicar que, de forma predeterminada, todas tus alertas vencen después de 48 horas si no hay ningún elemento <expires>.

Debes incluir campos de zona horaria en todos los valores de dateTime. Si la ubicación citada en el bloque <area> se encuentra dentro de una sola zona horaria, recomendamos que el elemento <effective> especifique 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, recomendamos que el productor de mensajes utilice las horas UTC en lugar de las horas locales.

Example:

2002-05-24T16:49:00-07:00 representa el 24 de mayo de 2002 a las 16:49 (PDT).
<senderName> OPCIONAL string

Un elemento <senderName> es opcional, pero muy recomendable.

Cuando el remitente tiene un nombre legible, el vínculo <web> puede mostrarse de una manera fácil de usar, según las preferencias del publicador o el remitente. Además, el elemento <senderName> permite que los agregadores de alertas publiquen desde varias autoridades.
<headline> OPCIONAL string

Haz que la longitud de las strings de elementos <headline> sea inferior a 140 caracteres.

Una string <headline> puede ser de texto abierto, pero recomendamos que tenga menos de 140 caracteres. (CAP 1.2 sugiere menos de 160 para los mensajes de texto). Comienza esta string con algunas palabras descriptivas que expliquen el núcleo de la alerta. Un ejemplo es "Cierre del puente de Dibujos animados...".

No uses los mismos valores para los elementos <headline> y <description>. Proporciona más detalles en el elemento <description> que en el elemento <headline>.
<description>

OBLIGATORIO*

 string

El valor del elemento <description> es texto que describe el asunto del evento del mensaje de alerta.

Recomendamos un contenido informativo y legible que responda a estas preguntas:

  • ¿Qué está pasando o qué está por suceder?
  • ¿Dónde sucede?
  • ¿Qué tan malo es?

Google usa el elemento <description> para propagar la sección Mensaje de nuestra página y el elemento <instruction> para propagar la sección Acciones recomendadas. Los usuarios pueden ver ambos campos.

Puedes usar estas etiquetas de Markdown compatibles: <newline>, <b> y <a href>.
<instruction> OPCIONAL string

El valor del elemento <instruction> es texto que describe las acciones recomendadas para los destinatarios del mensaje de alerta. Recomendamos que incluya contenido informativo y legible.

Enumera las acciones que se ajustan al nivel de gravedad de la alerta y que no son generales. Usa oraciones breves y que distingan mayúsculas de minúsculas, e incluye sugerencias de seguridad en las que los lectores puedan actuar, con la sugerencia más importante primero.

El elemento <instruction> es opcional, pero te recomendamos que lo hagas. Alertas públicas de Google usa el campo <instruction> para propagar la sección Acciones recomendadas en las páginas de detalles de alertas. Haz que los valores de campo <instruction> y <description> sean diferentes porque tienen propósitos distintos.
<web>

OBLIGATORIO*

 string

Vincula el elemento <web> con una copia de la alerta original a la que se puede acceder en tu servidor web.
<contact> OPCIONAL string

El campo <contact> es opcional, pero recomendamos que esté presente porque proporciona una forma de que los usuarios proporcionen comentarios y respondan a la alerta. Por ejemplo, "Para emergencias, llama al 911".
<parameter> OPCIONAL string

El elemento <parameter> contiene datos específicos del sistema con el siguiente formato:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

Donde:

valueName: Una string asignada por el usuario que designa el dominio del código.

value = Un valor de string.

Pueden ocurrir varias instancias de un elemento <parameter> dentro de un bloque <info>.
<resource> OPCIONAL resource

El elemento <resource> proporciona información complementaria adicional relacionada con el elemento superior <info>. Pueden ocurrir varias instancias de un elemento <resource> dentro de un bloque <info>.
<area>

OBLIGATORIO*

 area

El elemento <area> contiene información sobre el área de alerta del evento, no sobre el área del incidente. Los bloques <area> deben incluir al menos un elemento <circle>, <polygon> o <geocode>.

Te recomendamos que uses un elemento <polygon> o <circle> en lugar de un elemento <geocode>.

* 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

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>