生成 CAP 格式的提醒

除了遵循 CAP 标准之外，您还需要遵循适用于 CAP 文件的 Google 特定要求，以确保系统正确处理您的提醒。

您可以通过以下 2 种方式生成提醒：

  1. 自动生成：将您的系统设置为动态地将数据库信息转换为 CAP Feed，并自动将其提交给 Google。
  2. 手动创建：根据需要通过 Web 应用手动创建和提交提醒内容。

自动生成

请查看 Google CAP 库，以您选择的语言开始使用。 该库支持创建、解析和验证 CAP Feed。

Google 团队可以在实施过程中提供支持。请联系您的 Google 团队或发送电子邮件至 google-public-alerts@google.com。

手动创建

  1. 与您的 IT 团队合作，将 CAPCreatorTM 开源 Web 应用安装到网络服务器上。或者，您可以创建自己的 Web 应用。
  2. 发生事件时，请访问应用的网址，然后使用界面以 CAP 格式创建提醒。
  3. 您的应用会将 Feed 发布到网络位置，然后 Google 会从已发布的 Feed 中提取该信息。

提醒元素

提醒剖析

提醒应回答以下关键问题：

  1. 发生了什么？
  2. 何时举行？
  3. 用户应该怎么做？
  4. 提醒去了哪里？

以下是一个简单的提醒示例：

    <alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
        <identifier>AL20110412020900TornadoWarning</identifier>
        <sender>w-nws.webmaster@noaa.gov</sender>
        <sent>2011-04-11T21:18:07-05:00</sent>
        <status>Actual</status>
        <msgType>Alert</msgType>
        <scope>Public</scope>
        <info>
            <language>en-US</language>
            <category>Met</category>
            <event>Tornado Warning</event>
            <urgency>Immediate</urgency>
            <severity>Extreme</severity>
            <certainty>Observed</certainty>
            <effective>2011-04-11T21:09:00-05:00</effective>
            <expires>2011-04-11T21:30:00-05:00</expires>
            <headline>Tornado Warning issued April 11 at
            9:30PM CDT by NWS Birmingham</headline>
            <instruction>
                Do not wait to see or hear the tornado.
            For your protection, move to an interior room on the 
            lowest floor of your home or business.</instruction> 
            <area>
                <areaDesc>Cleburne</areaDesc>
                <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58 
                33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
                33.61,-85.58</polygon> 
            </area>
        </info>
    </alert>

请务必查看我们的示例上限提醒，以便获得更丰富的可能与您的提醒类似的工作提醒示例。

事件

CAP <event> 字符串（有时是 <headline>）会显示在提醒的标题中。标题应简短（少于 35 个字符），并且应具有足够的描述性，以便公众理解。如需了解更详细的要求，请参阅参考指南中的 <info> 元素和子元素。

个日期

所有日期/时间值中都必须包含时区字段（例如 <effective>、<expires> 和 <onset>）。如果 <area> 代码块中引用的位置属于单个时区，则 <effective> 应指定该时区中的时间，包括夏令时所适用的时间。如果邮件内容适用于多个时区，则邮件制作工具应使用 UTC 时间，而非当地时间。

操作说明

CAP 提醒的 <instruction> 字段在提醒详情页面中显示为“推荐操作”。请注意，此元素的内容不应与 <description> 相同，后者更适用于总结提醒的性质和强度，以及受影响的区域。

通知区域

CAP 提醒的 <area> 元素应描述要通知的地理区域，其中可能包括突发事件区域以外的地点。例如，设想一下野火警报：由于野火可能会迅速扩散到目前的燃烧区域，因此 <area> 应该覆盖整个潜在的危险区域，而不是仅覆盖起火点或当前燃烧区域。

将区域指定为多边形

最好以多边形形式指定提醒区域，因为它们往往更精确。理想情况下，<area> 元素的值是指受当前或预测条件影响的特定地理区域，而不是区域或省级行政区等预先确定的地理区域。这有助于确保看到提醒的用户发现提醒与其所在地相关。例如，雷暴或洪水警报可能仅影响政治管辖区的一小部分，降雪警报可能只会影响位于特定海拔高度的用户。在这种情况下，将整个行政区或省级行政区指定为 CAP 提醒的 <area> 会导致高估了受影响的区域，并降低该提醒的实用性。

根据我们的经验，最好使用能够让预报人员在他们想要警告的区域上绘制自定义多边形的警报软件或工具。

如果使用的是多边形，我们建议在纬度/经度坐标中包含的小数点不超过 5-6 位。（这样生成的分辨率高于大多数提醒系统应该能够达到的分辨率。）此外，请确保多边形有效；例如，它们不应该有相交的边。

将区域指定为地理编码

如果您必须改为将 <area> 指定为一个地理编码或多个地理编码集，请尽可能使用最详细的地理编码，并在 <description> 元素中添加可能受到影响的具体城镇、城市等的名称。您需要以 shapefile 格式分享底层形状文件。

支持多种语言

请创建一个包含多个 <info> 代码块的 <alert>（每种语言一个 <info> 代码块）。

有关详情和多语言提醒示例，请参阅多语言示例。

验证 CAP 提醒

我们建议您使用 Google 的开源 CAP 验证器工具来验证您的 CAP 提醒。您还可以通过此工具订阅错误通知电子邮件。验证工具提供几种 CAP 验证选项和示例：

验证工具屏幕截图

选择 Google Public Alerts CAP v1.0，验证 Google 对 CAP Feed 的特定要求。

若要订阅错误通知电子邮件，请点击订阅 Feed 验证结果，或转到 http://cap-Verifier.appspot.com/subscribe。您需要提供 Feed 网址和电子邮件地址，选择 Google Public Alerts CAP v1.0，然后点击 Subscription（订阅）。在 CAP Feed 中发现问题后，您会收到通知。

提醒发布商还可以从 CAP 库下载最新版本的 Google CAP 架构，并离线进行验证。

下一步：向 Google 发送提醒 Feed