alerte

Pour définir des informations de base sur un événement en cours, utilisez l'entité <alert>.

Si un événement occupe plusieurs emplacements en cours en même temps, il est préférable de le diviser en plusieurs objets alert. Par exemple, si un feu de forêt s'étend sur plusieurs États, vous pouvez diviser les alertes en plusieurs alertes, une pour chaque État. Vous fournissez ainsi des informations d'urgence spécifiques à chaque état et vous actualisez plus précisément la situation de l'incendie.

Si un événement évolue rapidement, comme un ouragan qui se déplace d'est en ouest, nous vous recommandons de mettre à jour régulièrement l'alerte. Ne supprimez pas l'alerte existante de votre flux. À la place, envoyez une nouvelle alerte qui fait référence à l'alerte précédente.

Attributs

Le tableau 1 décrit la valeur de l'attribut pour l'entité <alert>:

Tableau 1. Attribut d'entité <alert>

Nom de l'élément Facultatif Type Description
xmlns:cap REQUIRED string

L'attribut xmlns doit faire référence à l'URN CAP comme espace de noms.

Exemple :

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

Éléments

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

Tableau 2. Éléments d'entité <alert>

Nom de l'élément Facultatif Type Remarques et exigences concernant le CAP et Google
<identifier> REQUIRED string Indiquez l'ID de l'alerte qui représente l'événement. La valeur de l'élément <identifier> doit être unique pour tous les événements.
<sender> REQUIRED string L'élément <sender> identifie l'auteur de l'alerte. Il ne doit pas contenir d'espaces, de virgules ni de caractères soumis à des restrictions.
<sent> REQUIRED dateTime

Si l'emplacement indiqué dans le bloc <area> se trouve dans un seul fuseau horaire, utilisez l'élément <sent> pour spécifier l'heure dans ce fuseau. Le cas échéant, prévoyez une marge pour l'heure d'été.

Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, utilisez les heures UTC de préférence aux heures locales.
<status> REQUIRED AlertStatus

Google ne publie que les alertes accessibles au public dont la valeur de l'élément <status> est Actual.
<msgType> REQUIRED AlertMsgType

Un <msgType> UPDATE ou CANCEL doit inclure au moins un élément <references>. La norme CAP spécifie les éléments suivants:

  • Tout message d'alerte qui met à jour une alerte précédente utilise UPDATE et définit les valeurs des éléments <references> sur tous les messages précédents qui n'ont pas atteint leur date <expires>.
  • L'élément <msgType> UPDATE ou CANCEL doit s'appliquer à une alerte non expirée. Par conséquent, tous les messages associés et les alertes non expirées doivent être référencés lorsqu'un <msgType> UPDATE ou CANCEL est émis.

Pour en savoir plus, consultez la section Modifications ou expiration d'un événement.
<source> FACULTATIF string L'élément <source> indique la source spécifique de l'alerte. Il peut s'agir d'un opérateur ou d'un appareil spécifique.
<scope> REQUIRED AlertScope

L'élément <scope> indique la distribution prévue du message d'alerte.
<restriction> CONDITIONNEL string Si la valeur de l'élément <scope> est Restricted, l'élément <restriction> est obligatoire. Cet élément décrit la règle permettant de limiter la distribution du message d'alerte restreint.
<addresses> CONDITIONNEL string Si la valeur de l'élément <scope> est Private, l'élément <addresses> est obligatoire. Cet élément indique le destinataire prévu du message d'alerte. Vous pouvez inclure plusieurs adresses séparées par des espaces, mais vous devez placer les adresses contenant des espaces entre guillemets doubles.
<code> FACULTATIF string

L'élément <code> indique un traitement spécial du message d'alerte.
<note> CONDITIONNEL string

Si l'alerte contient l'une des valeurs d'élément suivantes, l'élément <note> est obligatoire:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CONDITIONNEL string

Si la valeur de l'élément <msgType> est UPDATE ou CANCEL, l'élément <references> est obligatoire.

Lorsque votre système publie à nouveau un contenu CAP d'un autre éditeur, incluez l'alerte CAP complète. Pour associer le contenu modifié à la source d'origine, utilisez la balise <references>.

Si vous faites référence à plusieurs messages, utilisez un espace comme délimiteur.
<incidents> FACULTATIF string L'élément <incidents> rassemble plusieurs messages qui font référence à différents aspects du même incident.
<info>

OBLIGATOIRE*

 info Au moins un élément <info> doit être présent. Plusieurs blocs <info> doivent tous avoir les mêmes valeurs d'éléments <category> et <event>.

* 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

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