alerte

Pour définir des informations de base sur un événement actuel, 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 incendie de forêt couvre plusieurs états, vous pouvez les diviser en plusieurs alertes, une pour chaque état. Ainsi, vous fournissez des informations d'urgence spécifiques à chaque état, et vous mettez à jour la situation incendie plus précisément.

Si un événement change rapidement, comme un ouragan qui se déplace d'est en ouest, nous vous recommandons d'actualiser régulièrement l'alerte. Ne supprimez pas l'alerte existante de votre flux. Émettez plutôt 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. <alert> attribut d'entité

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

L'attribut xmlns doit faire référence à CAP URN en tant qu'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 pour l'entité <alert>:

Tableau 2. <alert> élément d'entité

Nom de l'élément Facultatif Type Remarques et conditions requises pour 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 parmi tous les événements.
<sender> REQUIRED string L'élément <sender> identifie le créateur de l'alerte. Il ne peut pas contenir d'espaces, de virgules ni de caractères restreints.
<sent> REQUIRED dateTime

Si l'emplacement cité dans le bloc <area> se trouve dans un seul fuseau horaire, utilisez l'élément <sent> pour spécifier l'heure dans cette zone. Le cas échéant, veuillez inclure l'heure d'été.

Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, utilisez les heures UTC plutôt que les heures locales.
<status> REQUIRED AlertStatus

Google ne publie que les alertes publiques avec la valeur <status> d'élément Actual.
<msgType> REQUIRED AlertMsgType

Un élément <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 de l'élément <references> sur tous les messages précédents qui n'ont pas encore atteint leur date de <expires>.
  • L'élément <msgType> UPDATE ou CANCEL doit s'appliquer à une alerte qui n'a pas expiré. Par conséquent, tous les messages associés et les alertes en cours de validité doivent être référencés lorsqu'un <msgType> UPDATE ou CANCEL est émis.

Pour en savoir plus, consultez Modifications ou expiration de l'événement.
<source> FACULTATIF string L'élément <source> indique la source particulière de l'alerte. (opérateur ou appareil spécifique, par exemple).
<scope> REQUIRED AlertScope

L'élément <scope> indique la distribution prévue du message d'alerte.
<restriction> CONDITIONNAIRE 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> CONDITIONNAIRE string Si la valeur de l'élément <scope> est Private, l'élément <addresses> est obligatoire. Cet élément indique le destinataire du message d'alerte. Vous pouvez inclure plusieurs adresses séparées par des espaces, mais vous devez placer les adresses contenant des espaces blancs entre guillemets.
<code> FACULTATIF string

L'élément <code> indique un traitement spécial du message d'alerte.
<note> CONDITIONNAIRE 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> CONDITIONNAIRE string

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

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

Si vous référencez plusieurs messages, utilisez les espaces blancs comme délimiteurs.
<incidents> FACULTATIF string L'élément <incidents> regroupe plusieurs messages faisant 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 pour les éléments <category> et <event>.

* Google requiert des éléments avec une option REQUIRED en gras et rouge, 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>