信息

<info> 实体指定提醒的详细信息。提醒至少需要一个 <info> 块。如果您支持多种语言，我们建议您为同一 <alert> 实体每种语言使用一个 <info> 代码块。

info 个实体元素

下表介绍了 <info> 实体的子元素值：

元素名称 可选 类型 上限和 Google 说明与要求
<language> 可选 language

对于 <language> 代码值，我们建议您使用有效的 RFC 3066。

如果 <language> 元素不存在，则默认值为 en-US。
<category> 必需 InfoCategory <category> 代码表示提醒消息主题事件的类别。如需为您的活动指定合适的类别，请参阅 OASIS 活动条款列表。适当的分类有助于 Google 更准确地向用户呈现提醒。
<event> 必需 string

<event> 元素表示提醒消息的主题事件的类型。

Google 对 <event> 元素的要求如下：

  • 长度不得超过 35 个字符。
  • 使用 CSV 或 Google 电子表格列出一组预定义的 <event> 类型（请参阅此 Google 表格示例）。
<responseType> 可选 responseType

为了指明建议适合的受众群体的操作类型，我们强烈建议您使用 <responseType> 元素及其对应的 <instruction> 元素值。
<urgency> 必需 urgency

请勿对 <urgency> 元素使用未知值，因为这会导致难以将提醒和相对排名编入索引。

请务必让 Google 知道 <urgency> 字段的设置方式以及具体作者。但是，该信息不在正式资料的涵盖范围内。

发布商最好根据具体情况设置 <urgency> 值，并遵循明确的触发准则。不过，<event> 元素可能会修复 <urgency> 值，从而降低提醒作者的灵活性。例如，美国的 NOAA 根据事件类型静态设定的紧迫性。
<severity> 必需 severity

请勿对 <severity> 元素使用未知值，因为这会导致难以将提醒和相对排名编入索引。

请务必让 Google 知道 <severity> 字段的设置方式以及具体作者。但是，该信息不在正式资料的涵盖范围内。

发布商最好根据具体情况设置 <severity> 值，并遵循明确的触发准则。不过，<event> 元素可能会修复 <severity> 值，从而降低提醒作者的灵活性。例如，美国的 NOAA 根据事件类型静态设定的紧迫性。
<certainty> 必需 certainty

请勿对 <certainty> 元素使用未知值，因为这会导致难以将提醒和相对排名编入索引。

请务必让 Google 知道 <certainty> 字段的设置方式以及具体作者。但是，该信息不在正式资料的涵盖范围内。

发布商最好根据具体情况设置 <certainty> 值，并遵循明确的触发准则。不过，<event> 元素可能会修复 <certainty> 值，从而降低提醒作者的灵活性。例如，美国的 NOAA 根据事件类型静态设定的紧迫性。
<audience> 可选 string <audience> 元素的值是描述警报消息目标受众群体的内容。
<eventCode> 可选 string

<eventCode> 元素包含系统专属代码，用于标识提醒消息的事件类型，具体格式如下。

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

其中：

  • valueName = 由用户分配的字符串，用于指定代码的网域。如果这些字符串是首字母缩略词，请以不带句点的所有大写字母来表示它们。例如 SAME、FIPS 和 ZIP。
  • value = 一个字符串，表示 <eventCode> 元素的值。

<eventCode> 元素的多个实例可以出现在 <info> 代码块中。

我们强烈建议您从 OASIS 事件条款列表中获取 <eventCode> 元素值。如果您使用 OASIS 事件术语列表，请使用 OET:v1.0 作为值名称，如以下示例所示：

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> 可选 dateTime

<effective> 元素的值是提醒消息中的信息的有效时间。

您必须在所有 dateTime 值中添加时区字段。如果 <area> 代码块中引用的位置位于单个时区内，我们建议 <effective> 元素指定该时区的时间。在适用的情况下，请添加夏令时的时间。

当消息的内容应用于多个时区时，我们建议消息提供方优先使用世界协调时间 (UTC)，而不是当地时间。

示例：

2002-05-24T16:49:00-07:00 表示 2002 年 5 月 24 日 16:49（美国太平洋夏季时间）。
<onset> 可选 dateTime

<onset> 元素的值是提醒消息主题事件开始的预期时间。您必须在所有 dateTime 值中添加时区字段。

如果 <area> 代码块中引用的位置位于单个时区内，我们建议 <effective> 元素指定该时区的时间。在适用的情况下，请包含夏令时的限额。

当消息的内容应用于多个时区时，我们建议消息提供方优先使用世界协调时间 (UTC)，而不是当地时间。

示例：

2002-05-24T16:49:00-07:00 表示 2002 年 5 月 24 日 16:49（美国太平洋夏季时间）。
<expires>

必填*

 dateTime

<expires> 元素的值是指提醒消息主题事件的过期时间。<expires> 元素必须位于 <effective> 元素之后，按时间顺序排列。

如果您无法为所有提醒设置过期时间，请为不含 <expires> 元素的所有提醒提供默认过期时间。例如，您可以声明默认情况下，如果没有 <expires> 元素，所有提醒都将设置为在 48 小时后过期。

您必须在所有 dateTime 值中添加时区字段。如果 <area> 代码块中引用的位置位于单个时区内，我们建议 <effective> 元素指定该时区的时间。在适用的情况下，请添加夏令时的时间。

当消息的内容应用于多个时区时，我们建议消息提供方优先使用世界协调时间 (UTC)，而不是当地时间。

示例：

2002-05-24T16:49:00-07:00 表示 2002 年 5 月 24 日 16:49（美国太平洋夏季时间）。
<senderName> 可选 string

<senderName> 元素是可选的，但强烈建议提供。

当发送者有人类可读的名称时，<web> 链接可以根据发布商或发送者的偏好设置以人性化方式显示。此外，<senderName> 元素还允许提醒聚合信息网站从多个机构发布。
<headline> 可选 string

<headline> 元素字符串的长度应少于 140 个字符。

<headline> 字符串可以是开放式文本，但我们建议包含少于 140 个字符。（对于文字消息，CAP 1.2 建议少于 160 条。）该字符串以几个描述性字词开头，用于说明提醒的核心。例如“Pontoon bridge closure...”。

请勿对 <headline> 和 <description> 元素使用相同的值。在 <description> 元素中提供比 <headline> 元素更多详细信息。
<description>

必填*

 string

<description> 元素的值是用于描述提醒消息事件的文本。

我们建议采用人类可读的实用信息来解答以下问题：

  • 发生了什么或即将发生什么？
  • 这件事在哪里发生？
  • 有多糟糕？

Google 会使用 <description> 元素填充我们网页的消息部分，并使用 <instruction> 元素填充建议采取的措施部分。用户可以看到这两个字段。

您可以使用这些受支持的 Markdown 标记：<newline>、<b> 和 <a href>。
<instruction> 可选 string

<instruction> 元素的值是文本，用于描述提醒消息收件人的建议操作。 我们建议您提供人类可读的信息性内容。

列出适合提醒严重级别且非通用的操作。使用简洁、区分大小写的句子，并包含安全提示，便于读者采取行动，最重要的提示排在最前面。

<instruction> 元素是可选的，但我们强烈建议您使用。Google 公共安全警报使用 <instruction> 字段填充提醒详情页面中的建议采取的措施部分。请为 <instruction> 和 <description> 字段设置不同的值，因为它们的用途不同。
<web>

必填*

 string

将 <web> 元素链接到可在您的网络服务器上访问的原始提醒的副本。
<contact> 可选 string

<contact> 字段是选填字段，但我们强烈建议您填写该字段，因为它为用户提供了提供反馈和响应提醒的方式。例如，“紧急时，请拨打 911”。
<parameter> 可选 string

<parameter> 元素包含以下格式的系统专属数据：

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

其中：

valueName = 由用户分配的字符串，用于指定代码的网域。

value = 一个字符串值。

<parameter> 元素的多个实例都可以在 <info> 代码块内出现。
<resource> 可选 resource

<resource> 元素提供与父级 <info> 元素相关的任何其他补充信息。<resource> 元素的多个实例都可以在 <info> 代码块内出现。
<area>

必填*

 area

<area> 元素包含事件的警报区域（而非事件区域）的相关信息。 <area> 代码块必须包含至少一个 <circle>、<polygon> 或 <geocode> 元素。

我们强烈建议使用 <polygon> 或 <circle> 元素，而不是 <geocode> 元素。

* Google 要求具有可选和红色必需元素的元素，但这些元素在 CAP 标准中是可选元素。

示例

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>