Google CAP 規定

您的快訊資料應遵循 OASIS 通用快訊通訊協定 v1.2 規格,以及 Google PublicAlert CAP v1.0 規格和其他下列規定。

關於 Google CAP

CAP 標準會建立 CAP 快訊的基本結構和資料元素,但對於使用不同資料元素的方式和時機,仍有很大的幫助。

我們的平台旨在整合使用者每天在線上工具中取得的高品質相關資料,簡化尋找緊急救援資訊的程序。這些附加規定旨在提高快訊在 Google 產品的觸及率和成效。

如要瞭解 Google 與 CAP 1.2 XML 相關的規定,請參閱 Google 災害示警 CAP 1.0 版規格的摘要說明。

開放原始碼 CAP 驗證工具中的「Google 災害示警上限」選項可讓您根據 OASIS 規格和 Google 的額外規定驗證資料。

以下指南適用於所有類型的快訊和危險內容。我們在樣本部分中,針對這些特定快訊類型列出了幾項額外規定和建議:

定期測試

  • 使用 <status>測試</status>來確認系統能夠執行快訊,以便執行一般的端對端系統測試。

目標快訊區域

  • 如果相同快訊層級和類型下連續字詞以外的區域,請建立單獨的 <alert> 訊息,而非只使用分離區域的單一 <alert> 訊息。
  • 如果 <area> 元素包含 <polygon> 元素,請確認這些多邊形有效且不含交集邊緣,且最多只能指定 6 個小數位數。
  • 如果快訊的 <area> 元素包含地理編碼,請在變更 Shapefile 前至少 30 天,以 shapefile 格式提供地理資料,並來信至 google-public-alerts@google.com 通知 Google。
  • 繪製根據目前條件和事件性質自訂的影響程度多邊形,而不是將範圍限定在預先定義的地理政治區域 (例如省、區)。
  • <areaDesc> 中受影響區域的簡短說明 (少於 50 個字元) 提供給 Google,或另外提供獨立的 CAP 快訊專屬 <parameter>。這段文字會顯示在快訊標題中。

加入多媒體內容

  • <description><instruction> 元素中加入內容豐富且可讓人理解的內容。
  • 請說明當前事件、預期開發作業、預期影響和建議的最佳化建議。
  • 請使用正確的拼字、文法和標點符號。
  • 使用純文字或 Markdown 標記,提升內容的可讀性,而非 HTML 標記。
  • 請為每個快訊層級提供對應的 RGB 或十六進位顏色代碼 (可提供給 Google 離線)。

更新快訊

快訊變更時,請發出新的快訊來參照先前的快訊,而不是從動態饋給中變更現有的快訊。請在適當的時間 (例如 24 到 48 小時) 後,從動態饋給中移除已取消、更新或過期的快訊。

<msgType> 更新或取消作業至少須包含一個 <references> 元素。如 CAP 標準中所指定,所有更新先前快訊的快訊訊息皆應使用 <msgType>Update</msgType>,並將 <references>code</references> 設為所有尚未收到 <expires> 日期的相關訊息。「更新」或「取消」必須套用至未過期的快訊。

您可以透過下列 3 種方式取消事件:

  1. 為每個事件設定 <expires> 日期,並使用訊息說明設定此快訊將結束。
  2. 很快就會在 <msgType>UPDATE<responseType>"All Clear"<expires> 中發布新的 <alert>
  3. 使用 <msgType>CANCEL 核發新的 <alert>

如需查看相關更新和取消的範例,請參閱這篇文章

支援多種語言

請建立一個<alert>包含多個<info>區塊 (每個語言一個<info>區塊) 的一個。

如需詳細資訊和多語言快訊範例,請參閱多種語言