información

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

Elementos de entidad info

En la siguiente tabla, se describen los valores de los subelementos de la entidad <info>:

Nombre del elemento	Opcionalidad	Tipo	Notas y requisitos de CAP y Google
<language>	OPCIONAL	language	Para el valor del código <language>, te recomendamos que uses un RFC 3066 válido. Si no está presente el elemento <language>, el valor predeterminado es en-US.
<category>	REQUIRED	InfoCategory	El código <category> indica la categoría del evento de asunto del mensaje de alerta. Para identificar las categorías correctas para tus eventos, consulta la Lista de términos de eventos de OASIS. La categorización adecuada puede ayudar a Google a mostrar la alerta a los usuarios con mayor precisión.
<event>	REQUIRED	string	El elemento <event> indica el tipo de evento de asunto del mensaje de alerta. Los requisitos de Google para el elemento <event> son los siguientes: Debe tener menos de 35 caracteres. Enumera un conjunto de tipos de <event> predefinidos en un archivo CSV o una hoja de cálculo de Google (consulta este ejemplo de Hojas de cálculo de Google). Importante: Te recomendamos que uses la Lista de términos de eventos de OASIS y que implementes el código <event> en la sección <eventCode>.
<responseType>	OPCIONAL	responseType	Para indicar el tipo de acción recomendada para el público correcto, cuando corresponda, te recomendamos que uses 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>, ya que dificulta la indexación de alertas y clasificaciones relativas. Es importante que Google sepa cómo se configura el campo <urgency> y quién lo hace. Sin embargo, esa información está fuera del alcance del perfil formal. De preferencia, el publicador establece el valor de <urgency> según cada caso y sigue lineamientos claros de activación. Sin embargo, un elemento <event> podría corregir el valor <urgency> y, de esta manera, reducir la flexibilidad de los autores de alertas. A modo de ejemplo, la NOAA de EE.UU. establece la urgencia de forma estática según el tipo de evento.
<severity>	REQUIRED	severity	No uses el valor Desconocido para el elemento <severity>, ya que dificulta la indexación de alertas y clasificaciones relativas. Es importante que Google sepa cómo se configura el campo <severity> y quién lo hace. Sin embargo, esa información está fuera del alcance del perfil formal. De preferencia, el publicador establece el valor de <severity> según cada caso y sigue lineamientos claros de activación. Sin embargo, un elemento <event> podría corregir el valor <severity> y, de esta manera, reducir la flexibilidad de los autores de alertas. A modo de ejemplo, la NOAA de EE.UU. establece la urgencia de forma estática según el tipo de evento.
<certainty>	REQUIRED	certainty	No uses el valor Desconocido para el elemento <certainty>, ya que dificulta la indexación de alertas y clasificaciones relativas. Es importante que Google sepa cómo se configura el campo <certainty> y quién lo hace. Sin embargo, esa información está fuera del alcance del perfil formal. De preferencia, el publicador establece el valor de <certainty> según cada caso y sigue lineamientos claros de activación. Sin embargo, un elemento <event> podría corregir el valor <certainty> y, de esta manera, reducir la flexibilidad de los autores de alertas. A modo de ejemplo, la NOAA de EE.UU. establece la urgencia de forma estática según el tipo de evento.
<audience>	OPCIONAL	string	El valor del elemento <audience> es 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 en el siguiente formato. <eventCode> <valueName>valueName</valueName> <value>value</value> </eventCode> Donde: valueName = Es una cadena asignada por el usuario que designa el dominio del código. Si esas cadenas son acrónimos, représéntalas en letras mayúsculas sin puntos. Algunos ejemplos son SAME, FIPS y ZIP. value = Es una cadena que denota el valor del elemento <eventCode>. Se pueden producir varias instancias de elementos <eventCode> dentro de un bloque <info>. Te recomendamos que obtengas los valores del elemento <eventCode> de la Lista de términos de eventos de OASIS. Si usas la lista de términos de eventos de OASIS, usa OET:v1.2 como el nombre del valor, como se muestra en este ejemplo: <eventCode> <valueName>OET:v1.2</valueName> <value>OET-003</value> </eventCode>
<effective>	OPCIONAL	dateTime	El valor del elemento <effective> es la hora de vigencia de la información 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, te recomendamos que el elemento <effective> especifique 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, te recomendamos que el productor del mensaje use las horas UTC en lugar de las locales. Ejemplo: 2002-05-24T16:49:00-07:00 representa el 24 de mayo de 2002 a las 4:49 p.m. (PDT).
<onset>	OPCIONAL	dateTime	El valor del elemento <onset> es la hora esperada cuando comienza el evento de 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 tolerancia para el horario de verano. Cuando el contenido de un mensaje se aplica a varias zonas horarias, te recomendamos que el productor del mensaje use las horas UTC en lugar de las locales. Ejemplo: 2002-05-24T16:49:00-07:00 representa el 24 de mayo de 2002 a las 4:49 p.m. (PDT).
<expires>	OBLIGATORIO*	dateTime	El valor del elemento <expires> es la hora de vencimiento del evento de asunto del mensaje de alerta. Un elemento <expires> debe ir después de un elemento <effective> en orden cronológico. Si no puedes establecer un tiempo de vencimiento para todas tus alertas, proporciona a Google un tiempo de vencimiento predeterminado para las alertas que no tengan un elemento <expires>. Por ejemplo, puedes indicar que, de forma predeterminada, todas tus alertas vencerán después de 48 horas si no hay un 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, te recomendamos que el elemento <effective> especifique 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, te recomendamos que el productor del mensaje use las horas UTC en lugar de las locales. Ejemplo: 2002-05-24T16:49:00-07:00 representa el 24 de mayo de 2002 a las 4:49 p.m. (PDT).
<senderName>	OPCIONAL	string	Un elemento <senderName> es opcional, pero se recomienda. Cuando el remitente tiene un nombre legible por humanos, el vínculo <web> puede mostrarse de una manera fácil de usar, según las preferencias del publicador o 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 cadenas de elementos <headline> sea inferior a 140 caracteres. Una cadena <headline> puede ser texto abierto, pero te recomendamos que tenga menos de 140 caracteres. (CAP 1.2 sugiere menos de 160 para los mensajes de texto). Comienza esta cadena con algunas palabras descriptivas que expliquen el núcleo de la alerta. Un ejemplo es “Cierre del puente flotante…”. 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 contenido informativo y legible por humanos que responda a estas preguntas: ¿Qué está sucediendo o está a punto de suceder? ¿Dónde ocurre? ¿Qué tan grave es? Importante: El valor del elemento <description> no debe ser el mismo que el valor del elemento <instruction>. Google usa el elemento <description> para completar la sección Mensaje de nuestra página y el elemento <instruction> para completar 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 un texto que describe las acciones recomendadas para los destinatarios del mensaje de alerta. Recomendamos que el contenido sea informativo y legible por humanos. Enumera las acciones que se ajustan al nivel de gravedad de la alerta y que no son generales. Usa oraciones concisas que distinguen mayúsculas de minúsculas y, además, incluye sugerencias de seguridad que los lectores puedan seguir, empezando por la más importante. El elemento <instruction> es opcional, pero se recomienda. Las Alertas públicas de Google usan el campo <instruction> para completar la sección Acciones recomendadas en las páginas de detalles de las alertas. Haz que los valores de los campos <instruction> y <description> sean diferentes, ya que cumplen diferentes propósitos.
<web>	OPCIONAL	string	Vincula el elemento <web> a una URL que funcione y que proporcione más información sobre tu alerta.
<contact>	OPCIONAL	string	El campo <contact> es opcional, pero te recomendamos que esté presente porque les brinda a los usuarios una forma de enviar comentarios y responder a la alerta. Por ejemplo, "En caso de emergencia, llama al 911".
<parameter>	OPCIONAL	string	El elemento <parameter> contiene datos específicos del sistema en el siguiente formato: <parameter> <valueName>valueName</valueName> <value>value</value> </parameter> Donde: valueName = Es una cadena asignada por el usuario que designa el dominio del código. value = Un valor de cadena. 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 <info> superior. 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 del á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 de ser opcionales con la palabra REQUIRED en negrita y en rojo, pero esos elementos son opcionales en el estándar 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>