警報資料應遵循 OASIS 通用警報通報協定 v1.2 規格,以及 Google 公共警報 CAP v1.0 規格和下列其他規定。
關於 Google CAP
CAP 標準會建立 CAP 警示的基本結構和資料元素,但仍會在使用各種資料元素的方式和時間上,留下相當大的不一致性。
我們的平台旨在將高品質的相關資料整合至使用者每天使用的線上工具中,簡化緊急資訊搜尋程序。額外規定旨在盡可能擴大 Google 產品中快訊的觸及範圍和成效。
Google 公共警報 CAP 第 1.0 版規格總結了 Google 與 CAP 1.2 XML 規定的差異。
開放原始碼 CAP Validator 中的「Google Public Alerts CAP」選項可讓您根據 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>
元素中加入豐富、可執行且人類可讀的內容。 - 說明目前事件、預測的發展趨勢、預期影響,以及適用的建議。
- 使用正確的拼字、文法和標點符號。
- 使用純文字,而非 HTML 標記,可提高內容的可讀性。
- 提供與各警報層級相對應的 RGB 或十六進位顏色代碼 (可離線提供給 Google)。
更新快訊
快訊變更時,請發出新的快訊,並參照先前的快訊,而非變更或從動態消息中移除現有快訊。在適當的時間 (最多兩週) 後,從動態饋給中移除過期的 CAP 警示。
<msgType>
UPDATE 或 CANCEL 必須包含至少一個 <references>
元素。如 CAP 標準所述,任何更新先前快訊的快訊訊息都應使用 <msgType>Update</msgType>
,並將 <references>code</references>
設為所有先前相關訊息 (未達 <expires>
日期)。UPDATE 或 CANCEL 必須套用於未到期的警報。
取消事件有三種方法,依優先順序如下:
- 為每個事件設定
<expires>
日期時間,並在訊息說明中設定預期這項快訊會自動結束。 - 在未來不久,請使用
<msgType>UPDATE
、<responseType>"All Clear"
和<expires>
發出新的<alert>
。 - 使用
<msgType>CANCEL
發出新的<alert>
。
如需範例,請參閱更新和取消提醒範例。
支援多種語言
請建立一個包含多個 <info>
區塊的 <alert>
(每種語言一個 <info>
區塊)。
如需更多詳細資訊和多語言快訊範例,請參閱「多種語言」。