區域

我們強烈建議 <area> 實體定義要通知的地理區域，而非事件發生區域。

在熱帶風暴的情況下，建議 <area> 實體包含 <polygon> 或 <geocode> 元素，用於表示您預期會受到強風、大雨或其他風暴威脅的地區。如果暴風雨仍在海上，請勿將 CAP 警報的 <area> 實體設為暴風雨的目前位置。

同樣地，在森林火災的情況下，建議 <area> 實體資料也應納入可能受到煙霧或其他火災威脅的城鎮或地點。

area 實體子元素

元素名稱 選填 類型 CAP 和 Google 附註和規定
<areaDesc> 必要 string

為產生警示標題或標題中使用的地點文字字串，Google 可能會使用 <areaDesc> 元素。<areaDesc> 值應精簡 (少於 50 個半形字元)。
<polygon> 選用 string

<polygon> 元素中的配對值點會定義多邊形，用於標示警示訊息中的警示區域。建議您使用以空格分隔的 WGS84 座標組合清單，表示 <polygon> 元素。

多邊形必須符合下列規定：

  • 必須關閉。
  • 且不得重疊。
  • 系統不支援洞孔 (例如甜甜圈形多邊形) 和交叉點。
  • 至少需要四個座標點組合。第一組和最後一組座標必須相同。
<circle> 選用 string

<circle> 元素包含配對的點和半徑值，可用於以警示訊息的形式標示警示區域。建議您使用中心點表示 <circle> 元素：WGS84 座標組合，後面接空格字元和半徑值 (以公里為單位)。

注意：如果您指定半徑為零或非常小的圓形，Google 就無法向使用者顯示警示。
<geocode> 選用 string

定義 <geocode> 元素，並使用可存取的開放多邊形資料集值。舉例來說，在美國，這些值來自下列資料來源：

  • FIPS6
  • UGC 代碼
  • SAME
  • 美國郵遞區號

如果您使用地理編碼，請向 Google 提供固定的地理編碼至多邊形和形狀檔案地圖清單。如要發布這份清單的更新通知，請使用另一個管道，最好是 RSS 或電子郵件快訊。舉例來說，美國國家海洋暨大氣總署 (NOAA) 會公開發布地理編碼更新。
<altitude> 選用 float

<altitude> 元素的值是警報訊息受影響區域的特定或最小高度。請根據 WGS84 資料，以英尺為單位提供海拔高度。
<ceiling> 條件式 float

只有在 <alert> 實體包含 <altitude> 元素時，才使用 <ceiling> 元素。<ceiling> 元素的值是警報訊息受影響區域的最高海拔高度。請根據 WGS84 資料座標，以英尺為單位提供海拔高度。

範例

<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>