surface

Nous vous recommandons vivement que l'entité <area> définisse la zone géographique à avertir, et non la zone de l'incident.

En cas de tempête tropicale, nous vous recommandons que l'entité <area> contienne des éléments <polygon> ou <geocode> qui indiquent les endroits où vous prévoyez des impacts dus à des vents forts, à de fortes pluies ou à d'autres menaces de la tempête. Si une tempête est toujours au large, ne définissez pas l'entité <area> de votre alerte CAP sur l'emplacement actuel de la tempête.

De même, en cas d'incendie de forêt, nous vous recommandons que les données de l'entité <area> incluent également les villes ou les lieux où vous prévoyez des impacts de la fumée ou d'autres menaces liées à l'incendie.

Sous-éléments de l'entité area

Nom de l'élément Facultatif Type Remarques et exigences concernant le CAP et Google
<areaDesc> REQUIRED string

Pour générer la chaîne de texte d'emplacement utilisée dans le titre ou le titre de l'alerte, Google peut utiliser un élément <areaDesc>. La valeur <areaDesc> doit être courte (moins de 50 caractères).
<polygon> FACULTATIF string

Les points de valeur associés dans un élément <polygon> définissent un polygone qui délimite la zone à signaler dans un message d'alerte. Nous vous recommandons de représenter l'élément <polygon> par une liste de paires de coordonnées WGS84 séparées par des espaces.

Les polygones doivent répondre aux exigences suivantes:

  • Elles doivent être fermées.
  • Elles ne peuvent pas se chevaucher.
  • Les trous (comme dans les polygones en forme de beignet) et les intersections ne sont pas acceptés.
  • Vous devez fournir au moins quatre paires de coordonnées. Les premières et dernières paires de coordonnées doivent être identiques.
<circle> FACULTATIF string

L'élément <circle> se compose de valeurs de point et de rayon associées qui délimitent la zone à alerter sous la forme d'un message d'alerte. Nous vous recommandons de représenter l'élément <circle> par un point central: une paire de coordonnées WGS84 suivie d'un espace et d'une valeur de rayon en kilomètres.

Remarque: Si vous spécifiez un cercle avec un rayon nul ou très faible, Google ne peut pas afficher l'alerte à nos utilisateurs.
<geocode> FACULTATIF string

Définissez l'élément <geocode> avec des valeurs provenant d'un ensemble de données de polygones accessible et ouvert. Par exemple, aux États-Unis, ces valeurs proviennent des sources de données suivantes:

  • FIPS6
  • Code généré par les utilisateurs
  • SAME
  • Code postal des États-Unis

Si vous utilisez des géocodes, fournissez à Google une liste fixe de cartes de géocodes vers polygones et de fichiers de forme. Pour publier des notifications de mises à jour de cette liste, utilisez un canal distinct, de préférence des alertes RSS ou par e-mail. Par exemple, la NOAA américaine publie publiquement ses mises à jour de géocodes.
<altitude> FACULTATIF float

La valeur de l'élément <altitude> correspond à l'altitude spécifique ou minimale de la zone affectée du message d'alerte. Indiquez cette mesure en pieds au-dessus du niveau moyen de la mer selon le repère WGS84.
<ceiling> CONDITIONNEL float

N'utilisez l'élément <ceiling> que si l'entité <alert> contient un élément <altitude>. La valeur de l'élément <ceiling> correspond à l'altitude maximale de la zone affectée du message d'alerte. Indiquez cette mesure en pieds au-dessus du niveau moyen de la mer, conformément au repère WGS84.

Exemple

<area>
    <areaDesc>Cavite</areaDesc>
    <polygon>14.473860833486,120.9718174024 14.347454023196,121.01386683476
     14.142014336735,121.03024107602 14.063075455227,120.85558468426
     14.221664765773,120.59001887699 14.473860833486,
     120.9718174024</polygon>
    <geocode>
        <valueName>SAME</valueName>
        <value>042100000</value>
    </geocode>
</area>

<area>
    <areaDesc>107 km SouthWest DENPASAR-BALI</areaDesc>
    <circle>-9.63,115.12 300.0</circle>
</area>