Vos données d'alerte doivent respecter la spécification OASIS Common Alerting Protocol v1.2, la spécification Google Alertes v1.0 et les exigences supplémentaires mentionnées ci-dessous.
À propos de Google CAP
La norme CAP établit la structure de base et les éléments de données d'une alerte CAP, tout en laissant beaucoup de marge sur la façon dont les différents éléments de données sont utilisés.
Notre plate-forme vise à simplifier le processus de recherche d'informations d'urgence en rassemblant des données pertinentes et de haute qualité au sein d'outils en ligne déjà utilisés quotidiennement par les utilisateurs. Ces exigences supplémentaires visent à maximiser la couverture et l'efficacité de vos alertes sur les produits Google.
Les différences spécifiques à Google par rapport aux exigences XML relatives à CAP 1.2 sont résumées dans la spécification Google Alertes publiques (version 1.0).
L'option CAP (Alertes publiques) Google de l'outil de validation CAP Open Source vous permet de valider vos données par rapport aux spécifications OASIS et aux exigences supplémentaires de Google.
Les consignes ci-dessous s'appliquent à tous les types d'alertes et de risques. Nous avons également réuni quelques exigences et recommandations supplémentaires pour ces types d'alertes spécifiques dans la section Exemples:
Effectuer des tests périodiques
- Assurez-vous que votre système peut publier des alertes via
<status>Test</status>afin d'effectuer des tests système de bout en bout réguliers.
Cibler des zones d'alerte
- S'il existe des zones non contiguës sous le même niveau et le même type d'alerte, créez des messages
<alert>distincts au lieu d'un seul<alert>avec des zones dissociées. - Si l'élément
<area>contient des éléments<polygon>, assurez-vous qu'ils sont des polygones valides sans intersections, et spécifiez un maximum de six décimales. - Si l'élément
<area>de vos alertes contient des géocodes, fournissez les données géographiques au format shapefile et informez-en Google à l'adresse google-public-alerts@google.com au moins 30 jours avant toute modification du fichier. - Au lieu de cibler des alertes sur des zones géopolitiques prédéfinies (par exemple, des provinces ou des districts), tracez des polygones personnalisés en fonction des conditions actuelles et de la nature de l'événement.
- Fournissez à Google une brève description (moins de 50 caractères) de la zone concernée dans le champ
<areaDesc>ou dans un<parameter>distinct de vos alertes CAP. Ce texte s'affichera dans le titre de l'alerte.
Inclure du contenu enrichi
- Incluez un contenu riche, exploitable et lisible dans les éléments
<description>et<instruction>. - Décrivez l'événement actuel, les développements prévus, l'impact attendu et les recommandations, le cas échéant.
- Respectez les règles d'orthographe, de grammaire et de ponctuation.
- Utilisez du texte brut ou un balisage pour améliorer la lisibilité de votre contenu plutôt que des balises HTML.
- Fournissez des codes couleur RVB ou hexadécimals pour chaque niveau d'alerte (à fournir à Google hors connexion).
Mise à jour des alertes
Lorsqu'une alerte change, émettez une nouvelle alerte faisant référence à l'alerte précédente, au lieu de modifier ou de supprimer l'alerte existante de votre flux. Passé un délai approprié (par exemple, de 24 à 48 heures), supprimez les alertes annulées, mises à jour ou arrivées à expiration de votre flux.
L'élément <msgType> UPDATE ou CANCEL doit inclure au moins un élément <references>.
Comme spécifié dans la norme CAP, les messages d'alerte qui mettent à jour une alerte précédente doivent utiliser <msgType>Update</msgType> et définir <references>code</references> sur tous les messages associés précédents qui n'ont pas atteint leur date de <expires>. La mise à jour ou la résiliation doivent s'appliquer à une alerte qui n'a pas expiré.
Il existe trois façons d'ANNULER les événements, par ordre de préférence:
- Définissez une date et une heure
<expires>pour chaque événement, en indiquant que la description du message prévoit que cette alerte se terminera elle-même. - Publiez un nouveau
<alert>avec<msgType>UPDATE,<responseType>"All Clear"et<expires>peu de temps après. - Émettez un nouveau
<alert>avec<msgType>CANCEL.
Consultez les exemples d'alertes en cas de mise à jour ou d'annulation.
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 Plusieurs langues.