Google CAP 要求

您的提醒数据应遵循 OASIS 通用提醒协议 v1.2 规范以及 Google 公共安全警报 v1.0 规范及下文所述的其他要求。

关于 Google CAP

CAP 标准为 CAP 提醒确立了基本结构和数据元素,但仍在采用各种数据元素的方式和时间上存在很大的差异。

我们的平台旨在整合人们每天都在使用的在线工具中的高质量相关数据,从而简化查找急救信息的过程。这些额外要求旨在最大限度地扩大 Google 产品提醒的覆盖面和有效性。

Google 公共安全警报 CAP v1.0 规范总结了 Google 在 CAP 1.2 XML 要求方面的具体差异。

通过开源 CAP 验证器中的“Google 公共安全警报上限”选项,您可以对照 OASIS 规范和 Google 的其他要求验证自己的数据。

以下指南适用于所有类型的提醒和危险。我们还在示例部分汇总了针对这些特定提醒类型的一些额外要求和建议:

执行定期测试

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

目标提醒区域

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

包含富媒体内容

  • <description><instruction> 元素中添加丰富、可操作、人类可读的内容。
  • 描述当前事件、预测的发展、预期影响和适用的建议。
  • 使用正确的拼写、语法和标点符号。
  • 使用纯文本或 markdown 可提高内容的可读性,而不是使用 HTML 标记。
  • 提供与每个提醒级别对应的 RGB 或十六进制颜色代码(可以在离线状态下提供给 Google)。

更新提醒

当提醒发生变化时,请发出新提醒来引用之前的提醒,而不是更改或移除 Feed 中的现有提醒。在一段时间(例如 24-48 小时)过后,从 Feed 中移除取消、更新或过期的提醒。

<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> 代码块)。

有关详情和多语言提醒示例,请参阅多种语言