Google CAP 要求

您的提醒数据应遵循 OASIS 通用警报协议 v1.2 规范,以及 Google 公共提醒 CAP v1.0 规范和下文中列出的其他要求。

Google CAP 简介

CAP 标准为 CAP 提醒建立了基本结构和数据元素,但仍有相当大的空间来确保各种数据元素的使用方式和时间一致。

我们的平台旨在将优质的相关数据汇集到人们每天都在使用的在线工具中,从而简化查找紧急情况信息的过程。这些额外要求旨在最大限度地扩大您在 Google 产品上的提醒的覆盖面和效果。

Google 公开提醒 CAP v1.0 规范中总结了与 CAP 1.2 XML 要求的 Google 专用差异。

借助开源 CAP 验证器中的“Google 公共提醒 CAP”选项,您可以根据 OASIS 规范和 Google 的其他要求对数据进行验证。

以下准则适用于所有类型的提醒和危险。我们还在示例部分中针对这些特定提醒类型整理了一些其他要求和建议:

执行定期测试

  • 确保您的系统能够使用 <status>Test</status> 发布提醒,以便定期进行端到端系统测试。

目标提醒区域

  • 如果同一提醒级别和类型下有非连续区域,请创建单独的 <alert> 消息,而不是包含不连续区域的单个 <alert>
  • 如果 <area> 元素包含 <polygon> 元素,请确保它们是有效的多边形,没有自相交边或重叠的多边形,并指定不超过 6 位小数的精度。
  • 如果提醒的 <area> 元素包含地理编码,请以 shapefile 格式提供地理数据,并在任何 Shapefile 发生更改前至少 30 天通过 google-public-alerts@google.com 通知 Google。
  • 尽可能根据当前情况和事件性质绘制基于影响的多边形,而不是将提醒定位到预定义的地缘政治区域(例如省、地区)。
  • 在 CAP 提醒的 <areaDesc> 中或单独的 <parameter> 中,向 Google 提供受影响区域的简短(少于 50 个字符)说明。此文字将显示在提醒标题中。

添加富媒体内容

  • <description><instruction> 元素中添加富有实用价值且直观易懂的内容。
  • 描述当前事件、预测的发展趋势、预计影响和建议(如适用)。
  • 使用正确的拼写、语法和标点。
  • 使用纯文本(而非 HTML 标记)来提高内容的可读性。
  • 提供与每个提醒级别对应的 RGB 或十六进制颜色代码(可以离线提供给 Google)。

更新提醒

当提醒发生变化时,请发出引用之前提醒的新提醒,而不是更改或从 Feed 中移除现有提醒。等待适当的时间(最多两周)后,从 Feed 中移除过时的 CAP 提醒。

<msgType> UPDATE 或 CANCEL 必须包含至少一个 <references> 元素。如 CAP 标准中所述,用于更新之前提醒的任何提醒消息都应使用 <msgType>Update</msgType>,并将 <references>code</references> 设置为所有未达到 <expires> 日期的之前相关消息。UPDATE 或 CANCEL 必须应用于未过期的提醒。

您可以通过以下三种方式取消事件,优先级如下:

  1. 为每个事件设置 <expires> 日期时间,并在消息说明中设置此提醒将自行结束的预期。
  2. 未来不久,将发布包含 <msgType>UPDATE<responseType>"All Clear"<expires> 的新 <alert>
  3. 使用 <msgType>CANCEL 发出新的 <alert>

如需查看示例,请参阅更新和取消提醒示例

支持多种语言

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

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