info

L'entité <info> spécifie les détails de l'alerte. Au moins un bloc <info> est requis 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>.

Éléments d'entité info

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

Nom de l'élément	Facultatif	Type	Remarques et exigences concernant le CAP et Google
<language>	FACULTATIF	language	Pour la valeur du code <language>, nous vous recommandons d'utiliser un code 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'événement sujet du message d'alerte. Pour identifier les bonnes catégories pour vos événements, consultez la liste des termes d'événement OASIS. Une bonne catégorisation peut aider Google à diffuser l'alerte plus précisément auprès des utilisateurs.
<event>	REQUIRED	string	L'élément <event> indique le type d'événement de l'objet du message d'alerte. Les exigences de Google concernant l'élément <event> sont les suivantes: La longueur doit être inférieure à 35 caractères. Indiquez un ensemble de types <event> prédéfinis dans une feuille de calcul CSV ou Google (voir cet exemple Google Sheets). Important:Nous vous recommandons vivement d'utiliser la liste des termes d'événement OASIS et d'implémenter le code <event> dans la section <eventCode>.
<responseType>	FACULTATIF	responseType	Pour indiquer le type d'action recommandé pour l'audience appropriée, le cas échéant, nous vous recommandons vivement d'utiliser un élément <responseType>, ainsi que la valeur de l'élément <instruction> auquel il correspond.
<urgency>	REQUIRED	urgency	N'utilisez pas la valeur "Inconnu" pour l'élément <urgency>, car cette valeur rend difficile l'indexation des alertes et des 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 cadre du profil officiel. De préférence, l'éditeur définit la valeur <urgency> au cas par cas et suit des consignes claires sur les déclencheurs. Toutefois, un élément <event> peut fixer la valeur <urgency>, ce qui réduit la flexibilité des auteurs d'alertes. Par exemple, la NOAA aux États-Unis définit l'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 cette valeur rend difficile l'indexation des alertes et des 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 cadre du profil officiel. De préférence, l'éditeur définit la valeur <severity> au cas par cas et suit des consignes claires sur les déclencheurs. Toutefois, un élément <event> peut fixer la valeur <severity>, ce qui réduit la flexibilité des auteurs d'alertes. Par exemple, la NOAA aux États-Unis définit l'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 cette valeur rend difficile l'indexation des alertes et des classements relatifs. Il est important que Google sache comment le champ <certainty> est défini et par qui. Toutefois, ces informations ne font pas partie du profil officiel. De préférence, l'éditeur définit la valeur <certainty> au cas par cas et suit des consignes claires sur les déclencheurs. Toutefois, un élément <event> peut fixer la valeur <certainty>, ce qui réduit la flexibilité des auteurs d'alertes. Par exemple, la NOAA aux États-Unis définit l'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 qui décrit l'audience visée du 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 sous la forme suivante. <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, représentez-les en majuscules 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 d'obtenir les valeurs de l'élément <eventCode> dans la liste des termes d'événement OASIS. Si vous utilisez la liste de termes d'événements OASIS, utilisez OET:v1.2 comme nom de valeur, comme illustré dans cet exemple: <eventCode> <valueName>OET:v1.2</valueName> <value>OET-003</value> </eventCode>
<effective>	FACULTATIF	dateTime	La valeur de l'élément <effective> correspond à l'heure d'application des informations du message d'alerte. Vous devez inclure des champs de fuseau horaire dans toutes les valeurs dateTime. Si l'emplacement indiqué dans le bloc <area> se trouve dans un seul fuseau horaire, nous vous recommandons que l'élément <effective> spécifie l'heure dans ce fuseau. Le cas échéant, incluez une marge pour l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, nous recommandons au producteur de messages d'utiliser les heures UTC plutôt que les 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 du début de l'événement objet du message d'alerte. Vous devez inclure des champs de fuseau horaire dans toutes les valeurs dateTime. Si l'emplacement indiqué dans le bloc <area> se trouve dans un seul fuseau horaire, nous vous recommandons que l'élément <effective> spécifie l'heure dans ce fuseau. Le cas échéant, incluez une compensation pour l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, nous recommandons au producteur de messages d'utiliser les heures UTC plutôt que les 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 d'objet du message d'alerte. Un élément <expires> doit suivre 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 à Google un délai d'expiration par défaut pour toutes les alertes qui ne comportent pas d'élément <expires>. Par exemple, vous pouvez indiquer que par défaut, toutes vos alertes expirent au bout de 48 heures s'il n'y a pas d'élément <expires>. Vous devez inclure des champs de fuseau horaire dans toutes les valeurs dateTime. Si l'emplacement indiqué dans le bloc <area> se trouve dans un seul fuseau horaire, nous vous recommandons que l'élément <effective> spécifie l'heure dans ce fuseau. Le cas échéant, incluez une marge pour l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, nous recommandons au producteur de messages d'utiliser les heures UTC plutôt que les heures locales. Exemple : 2002-05-24T16:49:00-07:00 représente le 24 mai 2002 à 16h49 PDT.
<senderName>	FACULTATIF	string	Un élément <senderName> est facultatif, mais vivement recommandé. Lorsque l'expéditeur dispose d'un nom lisible, le lien <web> peut s'afficher de manière conviviale, selon les 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	Réduisez la longueur des chaînes d'éléments <headline> à moins de 140 caractères. Une chaîne <headline> peut être du texte ouvert, mais nous vous recommandons de ne pas dépasser 140 caractères. (La norme CAP 1.2 suggère moins de 160 caractères pour les messages texte.) Commencez cette chaîne par quelques mots descriptifs qui expliquent l'essentiel de l'alerte. Par exemple : "Ponton bridge closure...." 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 créer des contenus lisibles et informatifs qui répondent aux questions suivantes: Que se passe-t-il ou est-ce sur le point de se passer ? Où se trouve-t-il ? À quel point est-ce grave ? Important:La valeur de l'élément <description> ne doit pas être identique à celle 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 renseigner la section Actions recommandées. Les deux champs sont visibles par les utilisateurs. Vous pouvez utiliser les balises Markdown acceptées 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. Répertoriez les actions qui correspondent au niveau de sévérité de l'alerte et qui ne sont pas générales. Utilisez des phrases concises et sensibles à la casse, et incluez des conseils de sécurité que les lecteurs peuvent suivre, 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. Les valeurs des champs <instruction> et <description> doivent être différentes, car elles ont des objectifs différents.
<web>	FACULTATIF	string	Associez l'élément <web> à une URL fonctionnelle qui fournit plus d'informations sur votre alerte.
<contact>	FACULTATIF	string	Le champ <contact> est facultatif, mais nous vous recommandons vivement de le renseigner, car il permet aux utilisateurs d'envoyer des commentaires et de répondre à l'alerte. 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 toutes les informations supplémentaires liées à l'élément <info> parent. 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> au lieu d'un élément <geocode>.

* Google exige des éléments dont l'optionnalité est indiquée en rouge et en gras OBLIGATOIRE, 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>