信息

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

info 实体元素

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

元素名称 可选性 类型 CAP 和 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> 元素值的字符串。

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

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

        <eventCode>
          <valueName>OET:v1.2</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> 元素的所有提醒向 Google 提供默认失效时间。例如，您可以声明，如果没有 <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 = 字符串值。

<info> 块中可以出现多个 <parameter> 元素实例。
<resource> 可选 resource

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

必填*

 area

<area> 元素包含与事件的提醒区域（而非突发事件区域）相关的信息。 <area> 块必须包含至少一个 <circle>、<polygon> 或 <geocode> 元素。

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

* Google 要求使用带有粗体红色 REQUIRED 选项性的元素，但这些元素在 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>