区域

我们强烈建议 <area> 实体定义要通知的地理区域，而不是突发事件区域。

对于热带风暴，我们建议 <area> 实体包含 <polygon> 或 <geocode> 元素，用于表示您预计风暴、大雨或其他风暴影响的地点。如果风暴仍在海上，那么请勿将 CAP 警报的 <area> 实体设置为风暴的当前位置。

同样，对于森林火灾，我们建议 <area> 实体数据也包括您预计会因火灾产生的烟雾或其他威胁而影响的城镇或地点。

area 个实体子元素

元素名称 可选 类型 上限和 Google 说明与要求
<areaDesc> 必需 string

为了生成提醒标题中的标题文本字符串，Google 可能会使用 <areaDesc> 元素。请缩短 <areaDesc> 值（少于 50 个字符）。
<polygon> 可选 string

<polygon> 元素中的配对值点定义了一个多边形，用于绘制提醒消息中要描述的区域。我们建议您使用由空格分隔的 WGS84 坐标对列表来表示 <polygon> 元素。

多边形必须满足以下要求：

  • 必须关闭。
  • 它们不能重叠。
  • 不支持孔（例如圆环形状的多边形）和交叉路口。
  • 至少需要四个坐标对。第一对和最后一对坐标必须相同。
<circle> 可选 string

<circle> 元素包含成对的点和半径值，用于以提醒消息的形式描述要警报的区域。我们建议您用中心点来表示 <circle> 元素：WGS84 坐标对，后跟空格字符和半径值（以公里为单位）。

注意：如果您指定的半径范围为零或非常小，Google 就无法向用户显示提醒。
<geocode> 可选 string

使用可访问的开放多边形数据集中的值定义 <geocode> 元素。例如，在美国，这些值来自以下数据源：

  • FIPS6
  • UGC 代码
  • 相同
  • 美国邮政编码

如果您使用地理编码，请向 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>