En plus de la norme CAP, suivez les exigences spécifiques à Google pour les fichiers CAP afin de garantir le bon fonctionnement de vos alertes.
Vous disposez de deux options pour générer des alertes:
- Génération automatique : configurez votre système pour mettre en forme les informations de votre base de données de manière dynamique dans un flux CAP, puis les envoyer automatiquement à Google.
- Création manuelle : créez et envoyez manuellement du contenu d'alerte si nécessaire via une application Web.
Génération automatique
Consultez la bibliothèque Google CAP pour commencer à utiliser le langage de votre choix. La bibliothèque permet de créer, d'analyser et de valider des flux CAP.
L'équipe Google peut vous aider pendant la mise en œuvre. Contactez votre équipe Google ou envoyez un e-mail à google-public-alerts@google.com.
Création manuelle
- Collaborez avec votre équipe informatique pour installer l'application Web Open Source CAPCreatorTM sur un serveur Web. Vous pouvez également créer votre propre application Web.
- À mesure que les événements se produisent, accédez à l'URL de l'application et utilisez l'interface pour créer des alertes au format CAP.
- Votre application publie un flux sur une destination Web. Google extrait ensuite cette information de votre flux publié.
Éléments d'alerte
Anatomie d'une alerte
Une alerte doit répondre à ces questions clés:
- Quelle est la situation ?
- Quand ce changement aura-t-il lieu ?
- Que doit-on faire ?
- À qui sont envoyées les alertes ?
Voici un exemple simple d'alerte:
<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>
<instruction>
Do not 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>
N'oubliez pas de consulter nos exemples d'alertes CAP pour voir des exemples plus détaillés d'alertes opérationnelles pouvant être similaires à la vôtre.
événement
La chaîne <event> CAP (ou <headline>) apparaît dans le titre de nos alertes. Ils doivent être courts (moins de 35 caractères) et descriptifs. Pour en savoir plus sur les exigences, consultez la section Éléments et sous-éléments <info> du guide de référence.
dates
Les champs de fuseau horaire doivent être inclus dans toutes les valeurs de date et d'heure (<effective>, <expires>, <onset>, etc.). Si le lieu cité dans le bloc <area> se trouve dans un seul fuseau horaire, <effective> doit indiquer l'heure dans cette zone, y compris l'heure d'été. Lorsque le contenu d'un message s'applique à plusieurs fuseaux horaires, son producteur doit utiliser les heures UTC plutôt que les heures locales.
Instructions
Le champ <instruction> de l'alerte CAP s'affiche dans les pages d'informations des alertes en tant qu'action recommandée. Notez que le contenu de cet élément ne doit pas être identique à celui de <description>, qui est plus adapté à la synthèse de la nature et de l'intensité de l'alerte, et de la zone concernée.
Zone de notification
L'élément <area> de l'alerte CAP doit décrire la zone géographique à notifier, qui peut inclure des lieux en dehors de la zone d'incident. Prenons l'exemple d'une alerte d'incendie: comme les incendies peuvent s'étendre rapidement aux zones qui ne sont pas brûlées, la zone <area> doit couvrir l'intégralité de la zone de danger potentielle, et pas seulement le point d'origine ou la zone d'incendie actuelle.
Spécifier des zones en tant que polygones
Les zones d'alerte sont mieux adaptées aux polygones, car ils sont généralement plus précis.
Idéalement, la valeur de l'élément <area> est définie comme la zone géographique spécifique affectée par les conditions actuelles ou prévues, plutôt que par des zones géopolitiques prédéterminées telles que des districts ou des provinces. Les utilisateurs qui voient l'alerte la trouvent ainsi pertinente. Par exemple, les alertes d'orages ou d'inondation peuvent n'affecter qu'une petite partie d'une juridiction, tandis que les avertissements de chute de neige ne concernent que les utilisateurs situés au-dessus d'une certaine altitude. Dans ce cas, le fait de spécifier un district ou une province entier comme <area> de l'alerte du CAP surestiment la zone affectée et rend l'alerte moins utile.
D'après notre expérience, l'utilisation de logiciels ou d'outils d'alerte qui permettent aux outils de prévision de dessiner un polygone personnalisé est idéale dans la zone à avertir.
Si vous utilisez des polygones, nous vous recommandons de ne pas utiliser plus de 5 à 6 décimales pour les coordonnées de latitude/longitude. (Cela produit une résolution plus élevée que la plupart des systèmes d'alerte ne peuvent cibler.) Vérifiez également que les polygones sont valides. Par exemple, ils ne doivent pas se croiser.
Spécifier des zones en tant que géocodes
Si vous devez spécifier <area> sous la forme d'un géocode ou d'un ensemble de plusieurs géocodes, utilisez des géocodes au niveau le plus précis possible et incluez les noms de villes spécifiques, qui seront probablement affectés dans l'élément <description>. Vous devez partager les fichiers de formes sous-jacents au format d'un fichier de formes.
Compatibilité avec plusieurs langues
Veuillez créer un bloc <alert> comportant plusieurs blocs <info> (un bloc <info> par langue).
Pour en savoir plus et obtenir un exemple d'alerte multilingue, consultez cet article.
Valider les alertes CAP
Nous vous recommandons d'utiliser l'outil Open Source CAP Validator de Google pour valider vos alertes. Vous pouvez également vous abonner aux e-mails de notification d'erreur via cet outil. L'outil de validation propose plusieurs options de validation CAP et des exemples:
Sélectionnez Google Alertes publiques CAP v1.0 pour vérifier que les flux CAP respectent les exigences Google.
Pour vous abonner aux e-mails de notification d'erreur, cliquez sur S'abonner aux résultats de la validation du flux ou accédez à la page http://cap-validate.appspot.com/subscribe. Vous devez indiquer l'URL et l'adresse e-mail de votre flux, sélectionner Google Alertes publiques (version 1.0), puis cliquer sur S'abonner. Vous recevrez une notification lorsque nous détectons des problèmes dans votre flux CAP.
Les éditeurs d'alertes peuvent également télécharger la dernière version du schéma Google CAP à partir de la bibliothèque CAP et procéder à la validation hors connexion.