info

Thực thể <info> chỉ định thông tin chi tiết của cảnh báo. Bạn phải có ít nhất một khối <info> để tạo cảnh báo. Nếu hỗ trợ nhiều ngôn ngữ, bạn nên sử dụng một khối <info> cho mỗi ngôn ngữ cho cùng một thực thể <alert>.

Phần tử thực thể info

Bảng sau đây mô tả các giá trị phần tử con cho thực thể <info>:

Tên phần tử Không bắt buộc Loại Lưu ý và yêu cầu của CAP và Google
<language> KHÔNG BẮT BUỘC language

Đối với giá trị mã <language>, bạn nên sử dụng RFC 3066 hợp lệ.

Nếu không có phần tử <language>, thì giá trị mặc định sẽ là en-US.
<category> BẮT BUỘC InfoCategory Mã <category> biểu thị danh mục của sự kiện chủ đề trong thông báo cảnh báo. Để xác định danh mục phù hợp cho các sự kiện của bạn, hãy tham khảo Danh sách thuật ngữ sự kiện OASIS. Việc phân loại đúng cách có thể giúp Google hiển thị cảnh báo chính xác hơn cho người dùng.
<event> BẮT BUỘC string

Phần tử <event> biểu thị loại sự kiện chủ đề của thông báo cảnh báo.

Sau đây là các yêu cầu của Google đối với phần tử <event>:

  • Chiều dài phải dưới 35 ký tự.
  • Liệt kê một tập hợp các loại <event> được xác định trước trong tệp CSV hoặc bảng tính Google (xem ví dụ về Google Trang tính này).
<responseType> KHÔNG BẮT BUỘC responseType

Để biểu thị loại hành động được đề xuất cho đúng đối tượng, khi có thể, bạn nên sử dụng phần tử <responseType> cùng với giá trị phần tử <instruction> tương ứng.
<urgency> BẮT BUỘC urgency

Đừng sử dụng giá trị Không xác định cho phần tử <urgency> vì giá trị đó khiến bạn khó lập chỉ mục cảnh báo và thứ hạng tương đối.

Điều quan trọng là Google phải biết cách thiết lập trường <urgency> và ai là người thiết lập. Tuy nhiên, thông tin đó nằm ngoài phạm vi của hồ sơ chính thức.

Tốt nhất là nhà xuất bản đặt giá trị <urgency> theo từng trường hợp và tuân theo các nguyên tắc rõ ràng về điều kiện kích hoạt. Tuy nhiên, phần tử <event> có thể khắc phục giá trị <urgency>, từ đó làm giảm tính linh hoạt của tác giả cảnh báo. Ví dụ: NOAA ở Hoa Kỳ đặt mức độ khẩn cấp một cách tĩnh dựa trên loại sự kiện.
<severity> BẮT BUỘC severity

Đừng sử dụng giá trị Không xác định cho phần tử <severity> vì giá trị đó khiến bạn khó lập chỉ mục cảnh báo và thứ hạng tương đối.

Điều quan trọng là Google phải biết cách thiết lập trường <severity> và ai là người thiết lập. Tuy nhiên, thông tin đó nằm ngoài phạm vi của hồ sơ chính thức.

Tốt nhất là nhà xuất bản đặt giá trị <severity> theo từng trường hợp và tuân theo các nguyên tắc rõ ràng về điều kiện kích hoạt. Tuy nhiên, phần tử <event> có thể khắc phục giá trị <severity>, từ đó làm giảm tính linh hoạt của tác giả cảnh báo. Ví dụ: NOAA ở Hoa Kỳ đặt mức độ khẩn cấp một cách tĩnh dựa trên loại sự kiện.
<certainty> BẮT BUỘC certainty

Đừng sử dụng giá trị Không xác định cho phần tử <certainty> vì giá trị đó khiến bạn khó lập chỉ mục cảnh báo và thứ hạng tương đối.

Điều quan trọng là Google phải biết cách đặt trường <certainty> và ai là người đặt. Tuy nhiên, thông tin đó nằm ngoài phạm vi của hồ sơ chính thức.

Tốt nhất là nhà xuất bản đặt giá trị <certainty> theo từng trường hợp và tuân theo các nguyên tắc rõ ràng về điều kiện kích hoạt. Tuy nhiên, phần tử <event> có thể khắc phục giá trị <certainty>, từ đó làm giảm tính linh hoạt của tác giả cảnh báo. Ví dụ: NOAA ở Hoa Kỳ đặt mức độ khẩn cấp một cách tĩnh dựa trên loại sự kiện.
<audience> KHÔNG BẮT BUỘC string Giá trị của phần tử <audience> là văn bản mô tả đối tượng mục tiêu của thông báo cảnh báo.
<eventCode> KHÔNG BẮT BUỘC string

Phần tử <eventCode> chứa mã dành riêng cho hệ thống giúp xác định loại sự kiện của thông báo cảnh báo ở dạng sau.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

trong đó:

  • valueName = Chuỗi do người dùng chỉ định, chỉ định miền của mã. Nếu các chuỗi đó là từ viết tắt, hãy biểu thị các chuỗi đó bằng toàn bộ chữ cái viết hoa mà không có dấu chấm. Ví dụ: SAME, FIPS và ZIP.
  • value = Một chuỗi biểu thị giá trị của phần tử <eventCode>.

Nhiều thực thể của phần tử <eventCode> có thể xuất hiện trong một khối <info>.

Bạn nên lấy các giá trị phần tử <eventCode> từ Danh sách thuật ngữ sự kiện OASIS. Nếu bạn sử dụng danh sách thuật ngữ sự kiện OASIS, hãy sử dụng OET:v1.2 làm tên giá trị, như minh hoạ trong ví dụ sau:

        <eventCode>
          <valueName>OET:v1.2</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> KHÔNG BẮT BUỘC dateTime

Giá trị của phần tử <effective> là thời gian có hiệu lực của thông tin trong thông báo cảnh báo.

Bạn phải thêm các trường múi giờ vào tất cả giá trị dateTime. Nếu vị trí được trích dẫn trong khối <area> nằm trong một múi giờ, thì bạn nên chỉ định thời gian trong múi giờ đó bằng phần tử <effective>. Khi có thể, hãy thêm mức chênh lệch cho giờ mùa hè.

Khi nội dung của một thông báo áp dụng trên nhiều múi giờ, bạn nên sử dụng múi giờ UTC thay vì múi giờ địa phương.

Ví dụ:

2002-05-24T16:49:00-07:00 biểu thị ngày 24 tháng 5 năm 2002 lúc 16:49 theo giờ PDT.
<onset> KHÔNG BẮT BUỘC dateTime

Giá trị của phần tử <onset> là thời gian dự kiến khi sự kiện chủ đề của thông báo cảnh báo bắt đầu. Bạn phải thêm các trường múi giờ vào tất cả giá trị dateTime.

Nếu vị trí được trích dẫn trong khối <area> nằm trong một múi giờ, thì bạn nên chỉ định thời gian trong múi giờ đó bằng phần tử <effective>. Khi có thể, hãy thêm khoản chênh lệch cho Giờ tiết kiệm ánh sáng ban ngày.

Khi nội dung của một thông báo áp dụng trên nhiều múi giờ, bạn nên sử dụng múi giờ UTC thay vì múi giờ địa phương.

Ví dụ:

2002-05-24T16:49:00-07:00 đại diện cho ngày 24 tháng 5 năm 2002 lúc 16:49 theo giờ PDT.
<expires>

BẮT BUỘC*

 dateTime

Giá trị của phần tử <expires> là thời gian hết hạn của sự kiện chủ đề trong thông báo cảnh báo. Phần tử <expires> phải đứng sau phần tử <effective> theo thứ tự thời gian.

Nếu bạn không thể đặt thời gian hết hạn cho tất cả cảnh báo, hãy cung cấp cho Google thời gian hết hạn mặc định cho mọi cảnh báo không có phần tử <expires>. Ví dụ: bạn có thể nêu rõ rằng theo mặc định, tất cả cảnh báo của bạn sẽ hết hạn sau 48 giờ nếu không có phần tử <expires>.

Bạn phải thêm các trường múi giờ vào tất cả giá trị dateTime. Nếu vị trí được trích dẫn trong khối <area> nằm trong một múi giờ, thì bạn nên chỉ định thời gian trong múi giờ đó bằng phần tử <effective>. Khi có thể, hãy thêm mức chênh lệch cho giờ mùa hè.

Khi nội dung của một thông báo áp dụng trên nhiều múi giờ, bạn nên sử dụng múi giờ UTC thay vì múi giờ địa phương.

Ví dụ:

2002-05-24T16:49:00-07:00 biểu thị ngày 24 tháng 5 năm 2002 lúc 16:49 theo giờ PDT.
<senderName> KHÔNG BẮT BUỘC string

Phần tử <senderName> là phần tử không bắt buộc nhưng bạn nên sử dụng.

Khi người gửi có tên mà con người có thể đọc được, đường liên kết <web> có thể hiển thị theo cách thân thiện với người dùng, tuỳ theo lựa chọn ưu tiên của nhà xuất bản hoặc người gửi. Ngoài ra, phần tử <senderName> cho phép trình tổng hợp cảnh báo phát hành từ nhiều cơ quan chức năng.
<headline> KHÔNG BẮT BUỘC string

Đặt độ dài của chuỗi phần tử <headline> dưới 140 ký tự.

Chuỗi <headline> có thể là văn bản mở, nhưng bạn nên sử dụng chuỗi có ít hơn 140 ký tự. (CAP 1.2 đề xuất rằng số ký tự trong tin nhắn văn bản không được vượt quá 160.) Bắt đầu chuỗi này bằng một vài từ mô tả giải thích cốt lõi của cảnh báo. Ví dụ: "Đóng cầu phao...."

Đừng sử dụng cùng một giá trị cho phần tử <headline> và <description>. Cung cấp thông tin chi tiết hơn trong phần tử <description> so với phần tử <headline>.
<description>

BẮT BUỘC*

 string

Giá trị của phần tử <description> là văn bản mô tả chủ đề của sự kiện thông báo cảnh báo.

Bạn nên cung cấp nội dung mang tính thông tin và dễ đọc, trả lời các câu hỏi sau:

  • Điều gì đang hoặc sắp xảy ra?
  • Sự cố xảy ra ở đâu?
  • Tình trạng này nghiêm trọng đến mức nào?

Google sử dụng phần tử <description> để điền sẵn vào phần Thông báo của trang và sử dụng phần tử <instruction> để điền sẵn vào phần Hành động được đề xuất. Người dùng có thể thấy cả hai trường này.

Bạn có thể sử dụng các thẻ Markdown được hỗ trợ sau: <newline>, <b> và <a href>.
<instruction> KHÔNG BẮT BUỘC string

Giá trị của phần tử <instruction> là văn bản mô tả các hành động được đề xuất cho người nhận thông báo cảnh báo. Bạn nên sử dụng nội dung mà người dùng có thể đọc được và cung cấp thông tin hữu ích.

Liệt kê các hành động phù hợp với mức độ nghiêm trọng của cảnh báo và không mang tính chung chung. Sử dụng các câu ngắn gọn, phân biệt chữ hoa chữ thường và đưa ra các mẹo an toàn mà người đọc có thể làm theo, trong đó mẹo quan trọng nhất được đưa ra trước tiên.

Bạn không bắt buộc phải sử dụng phần tử <instruction>, nhưng bạn nên sử dụng. Google Public Alerts sử dụng trường <instruction> để điền vào phần Hành động được đề xuất trong trang chi tiết về cảnh báo. Hãy đặt giá trị trường <instruction> và <description> khác nhau vì chúng phục vụ các mục đích khác nhau.
<web>

KHÔNG BẮT BUỘC

 string

Liên kết phần tử <web> với một URL đang hoạt động cung cấp thêm thông tin về cảnh báo của bạn.
<contact> KHÔNG BẮT BUỘC string

Trường <contact> là không bắt buộc, nhưng bạn nên sử dụng trường này vì nó cung cấp cách để người dùng đưa ra ý kiến phản hồi và phản hồi cảnh báo. Ví dụ: "Trong trường hợp khẩn cấp, hãy gọi 911".
<parameter> KHÔNG BẮT BUỘC string

Phần tử <parameter> chứa dữ liệu dành riêng cho hệ thống ở dạng sau:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

trong đó:

valueName = Chuỗi do người dùng chỉ định, chỉ định miền của mã.

value = Giá trị chuỗi.

Nhiều thực thể của một phần tử <parameter> có thể xuất hiện trong một khối <info>.
<resource> KHÔNG BẮT BUỘC resource

Phần tử <resource> cung cấp mọi thông tin bổ sung liên quan đến phần tử <info> mẹ. Nhiều thực thể của một phần tử <resource> có thể xuất hiện trong một khối <info>.
<area>

BẮT BUỘC*

 area

Phần tử <area> chứa thông tin về khu vực cảnh báo của sự kiện, chứ không phải khu vực sự cố. Khối <area> phải bao gồm ít nhất một phần tử <circle>, <polygon> hoặc <geocode>.

Bạn nên sử dụng phần tử <polygon> hoặc <circle> thay vì phần tử <geocode>.

* Google yêu cầu các phần tử có dấu BẮT BUỘC in đậm và màu đỏ, nhưng các phần tử đó không bắt buộc theo tiêu chuẩn CAP.

Ví dụ:

<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>