資訊

<info> 實體會指定快訊的詳細資料，建立快訊時至少要有一個 <info> 區塊。如果支援多種語言，建議您為同個 <alert> 實體的每種語言使用一個 <info> 區塊。

info 實體元素

下表描述 <info> 實體的子元素值：

元素名稱 選填 類型 CAP 和 Google 的附註和規定
<language> 選擇性 language

針對 <language> 程式碼值，建議您使用有效的 RFC 3066。

如果沒有 <language> 元素，則預設值為 en-US。
<category> 必填 InfoCategory <category> 程式碼表示快訊訊息的主旨事件類別。如要為您的活動決定合適的類別，請參閱 OASIS 活動條款清單。正確分類可協助 Google 更準確地向使用者顯示快訊。
<event> 必填 string

<event> 元素表示快訊訊息的主旨事件類型。

<event> 元素的 Google 規定如下：

  • 長度必須少於 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.0 做為值名稱，如以下範例所示：

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> 選擇性 dateTime

<effective> 元素的值是快訊訊息中的資訊生效時間。

所有 dateTime 值都必須包括時區欄位。如果 <area> 區塊中引用的地點位於單一時區中，建議 <effective> 元素指定該時區的時間。如果可以，請在日光節約時間中加入相關限制。

如果訊息內容適用於多個時區，我們建議訊息製作者以世界標準時間為準，再使用當地時間。

範例：

2002-05-24T16:49:00-07:00 代表太平洋夏令時間 2002 年 5 月 24 日 16:49。
<onset> 選擇性 dateTime

<onset> 元素的值是快訊訊息的主旨事件開始的預期時間。所有 dateTime 值都必須包括時區欄位。

如果 <area> 區塊中引用的地點位於單一時區中，建議 <effective> 元素指定該時區的時間。如果可以的話，請在「日光節約時間」許可範圍中加入許可。

如果訊息內容適用於多個時區，我們建議訊息製作者以世界標準時間為準，再使用當地時間。

範例：

2002-05-24T16:49:00-07:00 代表太平洋夏令時間 2002 年 5 月 24 日 16:49。
<expires>

必填*

 dateTime

<expires> 元素的值是快訊訊息的主旨事件的到期時間。<expires> 元素必須依照時間順序置於 <effective> 元素後方。

如果無法為所有快訊設定到期時間，請將任何沒有 <expires> 元素的快訊提供 Google 預設到期時間。舉例來說，您可以規定如果沒有任何 <expires> 元素，所有快訊都會在 48 小時後失效。

所有 dateTime 值都必須包括時區欄位。如果 <area> 區塊中引用的地點位於單一時區中，建議 <effective> 元素指定該時區的時間。如果可以，請在日光節約時間中加入相關限制。

如果訊息內容適用於多個時區，我們建議訊息製作者以世界標準時間為準，再使用當地時間。

範例：

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 個)。開始在說明這個字串時，使用一些描述性字詞來說明快訊核心。例如「橋橋封閉...」

請勿為 <headline> 和 <description> 元素使用相同的值。請在 <description> 元素中比 <headline> 元素提供更多詳細資料。
<description>

必填*

 string

<description> 元素的值是描述快訊訊息主旨的文字。

建議您使用使用者可理解且實用的資訊，以回答下列問題：

  • 異動內容
  • 發生在哪裡？
  • 你覺得品質如何？

Google 會使用 <description> 元素來填入網頁的「Message」(訊息) 部分，並使用 <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>