infos

L'entité <info> spécifie les détails de l'alerte. Vous devez spécifier au moins un bloc <info> pour une alerte. Si vous acceptez plusieurs langues, nous vous recommandons d'utiliser un bloc <info> pour chaque langue pour la même entité <alert>.

info élément d'entité

Le tableau suivant décrit les valeurs des sous-éléments pour l'entité <info>:

Nom de l'élément	Facultatif	Type	Remarques et conditions requises pour CAP et Google
<language>	FACULTATIF	language	Pour la valeur de code <language>, nous vous recommandons d'utiliser une norme RFC 3066 valide. Si l'élément <language> n'est pas présent, la valeur par défaut est en-US.
<category>	REQUIRED	InfoCategory	Le code <category> indique la catégorie de l'objet du message d'alerte. Pour identifier les catégories correspondant à vos événements, reportez-vous à la liste des conditions d'utilisation d'événements OASIS. Une catégorisation appropriée peut aider Google à présenter l'alerte plus précisément aux utilisateurs.
<event>	REQUIRED	string	L'élément <event> indique le type d'objet de l'alerte. Les exigences de Google pour l'élément <event> sont les suivantes: Il doit comporter moins de 35 caractères. Répertoriez un ensemble de types <event> prédéfinis dans un fichier CSV ou une feuille de calcul Google (consultez cet exemple Google Sheets). Important:Nous vous recommandons vivement d'utiliser la liste des conditions d'événement OASIS et d'insérer le code <event> dans la section <eventCode>.
<responseType>	FACULTATIF	responseType	Pour indiquer le type d'action recommandé pour l'audience appropriée, nous vous recommandons vivement d'ajouter un élément <responseType> en plus de la valeur <instruction> à laquelle il correspond.
<urgency>	REQUIRED	urgency	N'utilisez pas la valeur "Inconnu" pour l'élément <urgency>, car il est difficile d'indexer les alertes et les classements relatifs. Il est important que Google sache comment le champ <urgency> est défini et par qui. Toutefois, ces informations n'entrent pas dans le champ d'application du profil formel. De préférence, l'éditeur définit la valeur <urgency> au cas par cas et suit les consignes claires concernant le déclencheur. Toutefois, un élément <event> peut corriger la valeur <urgency> et ainsi réduire la flexibilité des auteurs d'alertes. Par exemple, aux États-Unis, la NOAA définit le caractère d'urgence de manière statique en fonction du type d'événement.
<severity>	REQUIRED	severity	N'utilisez pas la valeur "Inconnu" pour l'élément <severity>, car il est difficile d'indexer les alertes et les classements relatifs. Il est important que Google sache comment le champ <severity> est défini et par qui. Toutefois, ces informations n'entrent pas dans le champ d'application du profil formel. De préférence, l'éditeur définit la valeur <severity> au cas par cas et suit les consignes claires concernant le déclencheur. Toutefois, un élément <event> peut corriger la valeur <severity> et ainsi réduire la flexibilité des auteurs d'alertes. Par exemple, aux États-Unis, la NOAA définit le caractère d'urgence de manière statique en fonction du type d'événement.
<certainty>	REQUIRED	certainty	N'utilisez pas la valeur "Inconnu" pour l'élément <certainty>, car il est difficile d'indexer les alertes et les classements relatifs. Il est important que Google sache comment le champ <certainty> est défini et par qui. Toutefois, ces informations n'entrent pas dans le champ d'application du profil formel. De préférence, l'éditeur définit la valeur <certainty> au cas par cas et suit les consignes claires concernant le déclencheur. Toutefois, un élément <event> peut corriger la valeur <certainty> et ainsi réduire la flexibilité des auteurs d'alertes. Par exemple, aux États-Unis, la NOAA définit le caractère d'urgence de manière statique en fonction du type d'événement.
<audience>	FACULTATIF	string	La valeur de l'élément <audience> est un texte décrivant l'audience visée par le message d'alerte.
<eventCode>	FACULTATIF	string	L'élément <eventCode> contient un code spécifique au système qui identifie le type d'événement du message d'alerte au format suivant. <eventCode> <valueName>valueName</valueName> <value>value</value> </eventCode> où : valueName = chaîne attribuée par l'utilisateur qui désigne le domaine du code. Si ces chaînes sont des acronymes, utilisez-les en majuscules et sans points. Exemples : SAME, FIPS et ZIP. value = chaîne qui indique la valeur de l'élément <eventCode>. Plusieurs instances d'éléments <eventCode> peuvent se produire dans un bloc <info>. Nous vous recommandons vivement de récupérer les valeurs des éléments <eventCode> dans la liste des conditions d'événements OASIS. Si vous utilisez la liste des termes d'événement OASIS, utilisez OET:v1.0 comme nom de valeur, comme indiqué dans cet exemple: <eventCode> <valueName>OET:v1.0</valueName> <value>OET-003</value> </eventCode>
<effective>	FACULTATIF	dateTime	La valeur de l'élément <effective> correspond à l'heure effective des informations dans le message d'alerte. Vous devez inclure les champs de fuseau horaire dans toutes les valeurs dateTime. Si l'emplacement cité dans le bloc <area> se trouve dans un seul fuseau horaire, nous vous recommandons de spécifier l'heure dans l'élément <effective> dans cette zone. Le cas échéant, veuillez inclure l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, nous recommandons au producteur du message d'utiliser des heures UTC plutôt que des heures locales. Exemple : 2002-05-24T16:49:00-07:00 représente le 24 mai 2002 à 16h49 (PDT).
<onset>	FACULTATIF	dateTime	La valeur de l'élément <onset> correspond à l'heure prévue à laquelle l'événement du message d'alerte commence. Vous devez inclure les champs de fuseau horaire dans toutes les valeurs dateTime. Si l'emplacement cité dans le bloc <area> se trouve dans un seul fuseau horaire, nous vous recommandons de spécifier l'heure <effective> dans ce fuseau. Le cas échéant, veuillez inclure l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, nous recommandons au producteur du message d'utiliser des heures UTC plutôt que des heures locales. Exemple : 2002-05-24T16:49:00-07:00 représente le 24 mai 2002 à 16h49 (PDT).
<expires>	OBLIGATOIRE*	dateTime	La valeur de l'élément <expires> correspond à l'heure d'expiration de l'événement du message d'alerte. Un élément <expires> doit apparaître après un élément <effective> dans l'ordre chronologique. Si vous ne pouvez pas définir de délai d'expiration pour toutes vos alertes, indiquez-le par défaut pour toutes les alertes qui ne comportent pas d'élément <expires>. Par exemple, vous pouvez indiquer que toutes vos alertes expireront au bout de 48 heures s'il n'y a pas d'élément <expires>. Vous devez inclure les champs de fuseau horaire dans toutes les valeurs dateTime. Si l'emplacement cité dans le bloc <area> se trouve dans un seul fuseau horaire, nous vous recommandons de spécifier l'heure dans l'élément <effective> dans cette zone. Le cas échéant, veuillez inclure l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, nous recommandons au producteur du message d'utiliser des heures UTC plutôt que des heures locales. Exemple : 2002-05-24T16:49:00-07:00 représente le 24 mai 2002 à 16h49 (PDT).
<senderName>	FACULTATIF	string	L'élément <senderName> est facultatif, mais vivement recommandé. Lorsque l'expéditeur a un nom lisible, le lien <web> peut s'afficher de manière conviviale, en fonction des préférences de l'éditeur ou de l'expéditeur. De plus, l'élément <senderName> permet aux agrégateurs d'alertes de publier à partir de plusieurs autorités.
<headline>	FACULTATIF	string	La longueur des chaînes d'éléments <headline> doit être inférieure à 140 caractères. Une chaîne <headline> peut être un texte libre, mais nous vous recommandons de comporter moins de 140 caractères. (La version 1.2 suggère un nombre inférieur à 160 pour les SMS.) Commencez cette chaîne avec quelques mots descriptifs expliquant le cœur de l'alerte. Exemple : "Pontoon closure fermeture...". N'utilisez pas les mêmes valeurs pour les éléments <headline> et <description>. Fournissez plus de détails dans l'élément <description> que dans l'élément <headline>.
<description>	OBLIGATOIRE*	string	La valeur de l'élément <description> est un texte qui décrit l'objet de l'événement du message d'alerte. Nous vous recommandons de consulter un contenu lisible et informatif qui répond aux questions suivantes: Que va-t-il se passer ? Où ce changement se produit-il ? Est-ce mauvais ? Important:La valeur de l'élément <description> ne doit pas être identique à la valeur de l'élément <instruction>. Google utilise l'élément <description> pour renseigner la section Message de notre page et l'élément <instruction> pour remplir la section Actions recommandées. Les utilisateurs peuvent voir les deux champs. Vous pouvez utiliser les balises Markdown compatibles suivantes : <newline>, <b> et <a href>.
<instruction>	FACULTATIF	string	La valeur de l'élément <instruction> est un texte qui décrit les actions recommandées pour les destinataires du message d'alerte. Nous vous recommandons de choisir un contenu lisible et informatif. Listez les actions qui ne correspondent pas au niveau de gravité de l'alerte. Employez des phrases courtes et sensibles à la casse, et incluez des conseils de sécurité sur lesquels les lecteurs peuvent agir, en commençant par le plus important. L'élément <instruction> est facultatif, mais nous vous le recommandons vivement. Google Alertes publiques utilise le champ <instruction> pour renseigner la section Actions recommandées sur les pages d'informations des alertes. Modifiez les valeurs des champs <instruction> et <description> différemment, car elles ont des objectifs différents.
<web>	OBLIGATOIRE*	string	Associez l'élément <web> à une copie de l'alerte d'origine accessible sur votre serveur Web. Remarque:Google effectue une validation en fonction de l'élément <web>.
<contact>	FACULTATIF	string	Le champ <contact> est facultatif, mais nous vous recommandons vivement qu'il soit présent, car il permet aux utilisateurs de donner leur avis et de répondre à l'alerte. Par exemple, "En cas d'urgence, appelez le 911."
<parameter>	FACULTATIF	string	L'élément <parameter> contient des données spécifiques au système sous la forme suivante: <parameter> <valueName>valueName</valueName> <value>value</value> </parameter> où : valueName = chaîne attribuée par l'utilisateur qui désigne le domaine du code. value = valeur de chaîne. Plusieurs instances d'un élément <parameter> peuvent se produire dans un bloc <info>.
<resource>	FACULTATIF	resource	L'élément <resource> fournit des informations supplémentaires concernant l'élément parent <info>. Plusieurs instances d'un élément <resource> peuvent se produire dans un bloc <info>.
<area>	OBLIGATOIRE*	area	L'élément <area> contient des informations sur la zone d'alerte de l'événement, et non sur la zone de l'incident. Les blocs <area> doivent inclure au moins un élément <circle>, <polygon> ou <geocode>. Nous vous recommandons vivement d'utiliser un élément <polygon> ou <circle> plutôt qu'un élément <geocode>.

* Google requiert des éléments avec une option REQUIRED en gras et rouge, mais ces éléments sont facultatifs dans la norme CAP.

Exemple

<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>