資訊

<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> 元素使用「Unknown」值，因為這會導致警示和相對排名無法建立索引。

Google 必須瞭解 <urgency> 欄位的設定方式和設定者為何人。不過，這類資訊不在正式檔案的範圍內。

建議發布商視個別情況設定 <urgency> 值，並遵循明確的觸發規範。不過，<event> 元素可能會固定 <urgency> 值，因此會降低警示作者的彈性。舉例來說，美國國家海洋暨大氣總署 (NOAA) 會根據事件類型靜態設定緊急程度。
<severity> 必要 severity

請勿為 <severity> 元素使用「Unknown」值，因為這會導致警示和相對排名無法建立索引。

Google 必須瞭解 <severity> 欄位的設定方式和設定者為何人。不過，這類資訊不在正式檔案的範圍內。

建議發布商視個別情況設定 <severity> 值，並遵循明確的觸發規範。不過，<event> 元素可能會固定 <severity> 值，因此會降低警示作者的彈性。舉例來說，美國國家海洋暨大氣總署 (NOAA) 會根據事件類型靜態設定緊急程度。
<certainty> 必要 certainty

請勿為 <certainty> 元素使用「Unknown」值，因為這會導致警示和相對排名無法建立索引。

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> 元素中指定該時區的時間。在適用情況下，請加入日光節約時間的時間差異。

如果訊息內容適用於多個時區，建議訊息產生者使用世界標準時間，而非當地時間。

範例：

2002-05-24T16:49:00-07:00 代表 2002 年 5 月 24 日下午 4 點 49 分 (太平洋夏令時間)。
<onset> 選用 dateTime

<onset> 元素的值是快訊主旨事件開始的預期時間。您必須在所有 dateTime 值中加入時區欄位。

如果 <area> 區塊中提及的位置位於單一時區內，建議 <effective> 元素指定該時區的時間。在適用情況下，請納入日光節約時間。

如果訊息內容適用於多個時區，建議訊息產生者使用世界標準時間，而非當地時間。

範例：

2002-05-24T16:49:00-07:00 代表 2002 年 5 月 24 日下午 4 點 49 分 (太平洋夏令時間)。
<expires>

必填欄位*

 dateTime

<expires> 元素的值是警示訊息主旨事件的到期時間。<expires> 元素必須按時間順序排在 <effective> 元素之後。

如果您無法為所有快訊設定到期時間，請為沒有 <expires> 元素的快訊提供預設到期時間。舉例來說，您可以宣告，如果沒有 <expires> 元素，則預設所有警示都會在 48 小時後過期。

您必須在所有 dateTime 值中加入時區欄位。如果 <area> 區塊中提及的位置位於單一時區內，建議您在 <effective> 元素中指定該時區的時間。在適用情況下，請加入日光節約時間的時間差異。

如果訊息內容適用於多個時區，建議訊息產生者使用世界標準時間，而非當地時間。

範例：

2002-05-24T16:49:00-07:00 代表 2002 年 5 月 24 日下午 4 點 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 要求元素具有粗體紅色 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>