surface

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

En cas de tempête tropicale, nous recommandons que l'entité <area> contienne des éléments <polygon> ou <geocode> indiquant les endroits où vous prévoyez un impact dû à des vents forts, une forte pluie ou d'autres menaces associées à la tempête. Si une tempête est toujours en mer, ne définissez pas l'entité <area> de votre alerte CAP sur son emplacement actuel.

De même, dans le cas d'un incendie de forêt, nous recommandons que les données d'entité <area> incluent également les villes ou les lieux où vous prévoyez l'impact d'un incendie ou d'autres menaces.

area sous-éléments d'entité

Nom de l'élément Facultatif Type Remarques et conditions requises pour CAP et Google
<areaDesc> REQUIRED string

Pour générer la chaîne de texte de lieu utilisée dans le titre ou 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 à alerter 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 donut) et les intersections ne sont pas acceptés.
  • Au moins quatre paires de coordonnées sont requises. Les première et dernière paires de coordonnées doivent être identiques.
<circle> FACULTATIF string

L'élément <circle> est composé 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 caractère d'espacement et d'une valeur de rayon en kilomètres.

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

Définissez l'élément <geocode> avec les valeurs 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
  • MÊME
  • Code postal des États-Unis

Si vous utilisez des geocodes, fournissez à Google une liste fixe de cartes geocode-to-polygon et shapefile. Pour publier des mises à jour de cette liste, utilisez un canal distinct, de préférence sous forme de flux RSS ou d'alertes par e-mail. Par exemple, l'agence américaine NOAA 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 concernée par le message d'alerte. Indiquez cette mesure en pieds au-dessus du niveau de la mer selon le plan de référence WGS84.
<ceiling> CONDITIONNAIRE 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 concernée par le message d'alerte. Indiquez cette mesure en mètres au-dessus du niveau de la mer, conformément au plan de référence 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>