区域

我们强烈建议 <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 提供固定的地理编码到多边形和 Shapefile 映射列表。如需发布此列表更新的通知，请使用单独的渠道，最好是 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>