Vos données d'alerte doivent respecter la spécification Common Alerting Protocol v1.2 de l'OASIS, ainsi que la spécification Google Public Alerts CAP v1.0 et les exigences supplémentaires indiquées ci-dessous.
À propos de Google CAP
La norme CAP définit la structure de base et les éléments de données d'une alerte CAP, mais laisse encore une marge considérable d'incohérences dans la manière et le moment où les différents éléments de données sont utilisés.
Notre plate-forme vise à simplifier la recherche d'informations d'urgence en rassemblant des données pertinentes et de haute qualité dans des outils en ligne que les utilisateurs utilisent déjà au quotidien. Les 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 du CAP 1.2 sont résumées dans la spécification CAP 1.0 pour les alertes publiques Google.
L'option"Google Public Alerts CAP" (Google Public Alerts CAP) du validateur CAP Open Source vous permet de valider vos données par rapport à la spécification OASIS et aux exigences supplémentaires de Google.
Les consignes ci-dessous s'appliquent à tous les types d'alertes et de dangers. Nous avons également rassemblé 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 est capable de publier des alertes avec
<status>Test</status>afin d'effectuer des tests système réguliers de bout en bout.
Zones cibles d'alerte
- Si des zones non contiguës sont associées au même niveau et au même type d'alerte, créez des messages
<alert>distincts plutôt qu'un seul<alert>avec des zones disjointes. - Si l'élément
<area>contient des éléments<polygon>, assurez-vous qu'il s'agit de polygones valides sans arêtes qui s'intersectent ni polygones qui se chevauchent, et spécifiez une précision maximale de six décimales. - Si l'élément
<area>de vos alertes contient des géocodes, fournissez les géodonnées au format shapefile et informez Google à l'adresse google-public-alerts@google.com au moins 30 jours avant toute modification du fichier de forme. - Dessinez des polygones basés sur l'impact, qui sont personnalisés en fonction des conditions actuelles et de la nature de l'événement dans la mesure du possible, plutôt que de cibler des alertes sur des zones géopolitiques prédéfinies (par exemple, provinces, districts).
- Fournissez à Google une brève description (moins de 50 caractères) de la zone concernée dans le
<areaDesc>ou dans un<parameter>dédié de vos alertes CAP. Ce texte s'affichera dans le titre de l'alerte.
Inclure du contenu enrichi
- Incluez du contenu riche, exploitable et lisible par l'humain dans les éléments
<description>et<instruction>. - Décrivez l'événement en cours, 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 pour améliorer la lisibilité de votre contenu plutôt que des balises HTML.
- Indiquez les codes couleur RVB ou hexadécimaux correspondant à chaque niveau d'alerte (vous pouvez les fournir à Google hors connexion).
Mise à jour des alertes
Lorsqu'une alerte change, émettez une nouvelle alerte qui fait référence à l'alerte précédente, au lieu de modifier ou de supprimer l'alerte existante de votre flux. Après un délai approprié (jusqu'à deux semaines), supprimez les alertes CAP obsolètes de votre flux.
<msgType> UPDATE ou CANCEL doit inclure au moins un élément <references>.
Comme indiqué dans la norme CAP, tout message d'alerte qui met à jour une alerte précédente doit 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 <expires>.
Les valeurs UPDATE ou CANCEL doivent s'appliquer à une alerte non expirée.
Il existe trois façons d'ANNULER des événements, par ordre de préférence:
- Définissez une date et une heure
<expires>pour chaque événement, en indiquant dans la description du message que cette alerte se terminera d'elle-même. - Émettez un nouveau
<alert>avec<msgType>UPDATE,<responseType>"All Clear"et<expires>dans un court laps de temps. - Émettez un nouvel élément
<alert>avec<msgType>CANCEL.
Pour obtenir des exemples, consultez nos exemples d'alertes pour les mises à jour et les annulations.
Compatibilité avec plusieurs langues
Veuillez créer un <alert> contenant plusieurs blocs <info> (un bloc <info> par langue).
Pour en savoir plus et consulter un exemple d'alerte multilingue, consultez Plusieurs langues.