以 CAP 格式生成提醒

除了 CAP 标准之外，请遵循 CAP 文件的 Google 专用要求，以确保您的提醒能够正确处理。

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

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

自动生成

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

Google 团队可以在实现过程中提供支持。请与您的 Google 团队或 google-public-alerts@google.com 联系。

手动创建

  1. 与您的 IT 团队合作，将 CAPCreator™ 开源 Web 应用安装到 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</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 提醒示例，了解可能与您的提醒类似的更多有效提醒示例。

事件

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 格式分享底层 Shapefile。

支持多种语言

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

如需了解详情和多语言提醒示例，请参阅多语言示例。

验证 CAP 提醒

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

验证器屏幕截图

选择 Google 公开提醒 CAP v1.0，以便根据 Google 对 CAP Feed 的特定要求进行验证。

如需订阅错误通知电子邮件，请点击订阅 Feed 验证结果，或前往 http://cap-validator.appspot.com/subscribe。您需要提供 Feed 网址和电子邮件地址，选择 Google 公开提醒 CAP v1.0，然后点击订阅。如果在您的 CAP Feed 中发现问题，您会收到通知。

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

后续步骤：向 Google 发送您的“快讯”Feed