cảnh báo

Để xác định thông tin cơ bản về một sự kiện hiện tại, hãy sử dụng thực thể <alert>.

Nếu một sự kiện chiếm nhiều vị trí đang diễn ra cùng lúc, bạn nên chia sự kiện đó thành nhiều đối tượng alert. Ví dụ: nếu một vụ cháy rừng xảy ra ở nhiều tiểu bang, bạn có thể chia các cảnh báo thành nhiều cảnh báo, mỗi cảnh báo cho một tiểu bang. Bằng cách đó, bạn có thể cung cấp thông tin khẩn cấp cụ thể cho từng tiểu bang và cập nhật tình hình hỏa hoạn một cách chính xác hơn.

Nếu một sự kiện thay đổi nhanh chóng, chẳng hạn như một cơn bão di chuyển từ đông sang tây, bạn nên cập nhật cảnh báo định kỳ. Đừng xóa cảnh báo hiện có khỏi nguồn cấp dữ liệu. Thay vào đó, đưa ra một cảnh báo mới đề cập đến cảnh báo trước đó.

Thuộc tính

Bảng 1 mô tả giá trị thuộc tính của thực thể <alert>:

Bảng 1. Thuộc tính thực thể <alert>

Tên phần tử Tùy chọn Loại Nội dung mô tả
xmlns:cap BẮT BUỘC string

Thuộc tính xmlns phải tham chiếu CAP URN làm không gian tên.

Ví dụ:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

Các phần tử

Bảng 2 mô tả các giá trị phần tử phụ cho thực thể <alert>:

Bảng 2. <alert> phần tử của thực thể

Tên phần tử Tùy chọn Loại CAP và ghi chú cũng như yêu cầu của Google
<identifier> BẮT BUỘC string Cung cấp ID của cảnh báo đại diện cho sự kiện. Giá trị của phần tử <identifier> phải là duy nhất trên tất cả các sự kiện.
<sender> BẮT BUỘC string Phần tử <sender> xác định nguồn gốc của cảnh báo. Mật khẩu này không được chứa dấu cách, dấu phẩy hoặc ký tự bị hạn chế.
<sent> BẮT BUỘC dateTime

Nếu vị trí được trích dẫn trong khối <area> nằm trong một múi giờ duy nhất, hãy sử dụng phần tử <sent> để chỉ định thời gian trong múi giờ đó. Nếu có thể, hãy cung cấp một khoản trợ cấp theo Giờ mùa hè.

Khi nội dung của một thông báo được áp dụng ở nhiều múi giờ, hãy sử dụng giờ UTC để ưu tiên giờ địa phương.
<status> BẮT BUỘC AlertStatus

Google chỉ phát hành các cảnh báo công khai có giá trị phần tử <status> là Actual.
<msgType> BẮT BUỘC AlertMsgType

Một UPDATE hoặc CANCEL <msgType> phải bao gồm ít nhất một phần tử <references>. Tiêu chuẩn CAP chỉ định những nội dung sau:

  • Mọi thông báo cập nhật một thông báo trước đều sử dụng tính năng CẬP NHẬT và đặt giá trị phần tử <references> thành tất cả thông báo trước đó chưa đến ngày <expires>.
  • Phần tử UPDATE hoặc CANCEL <msgType> phải áp dụng cho một cảnh báo chưa hết hạn. Do đó, tất cả thông báo liên quan và cảnh báo chưa hết hạn phải được tham chiếu khi UPDATE hoặc CANCEL <msgType> được phát hành.

Để biết thêm thông tin, hãy xem bài viết Thay đổi hoặc thời gian hết hạn của sự kiện.
<source> TÙY CHỌN string Phần tử <source> biểu thị nguồn cụ thể của cảnh báo. Ví dụ như toán tử hoặc một thiết bị cụ thể.
<scope> BẮT BUỘC AlertScope

Phần tử <scope> biểu thị sự phân phối dự kiến của thông báo cảnh báo.
<restriction> CÓ ĐIỀU KIỆN string Nếu giá trị phần tử <scope> là Restricted, thì bạn bắt buộc phải có phần tử <restriction>. Phần tử này mô tả quy tắc giới hạn việc phân phối thông báo cảnh báo bị hạn chế.
<addresses> CÓ ĐIỀU KIỆN string Nếu giá trị phần tử <scope> là Private, thì bạn bắt buộc phải có phần tử <addresses>. Phần tử này liệt kê người nhận dự kiến của tin nhắn cảnh báo. Bạn có thể bao gồm nhiều địa chỉ được phân tách bằng dấu cách, nhưng bạn phải thêm địa chỉ có dấu cách vào trong dấu ngoặc kép.
<code> TÙY CHỌN string

Phần tử <code> biểu thị quá trình xử lý đặc biệt của thông báo cảnh báo.
<note> CÓ ĐIỀU KIỆN string

Nếu cảnh báo chứa một trong các giá trị phần tử sau đây, thì bạn bắt buộc phải có phần tử <note>:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CÓ ĐIỀU KIỆN string

Nếu giá trị phần tử <msgType> là UPDATE hoặc CANCEL, thì bạn bắt buộc phải có phần tử <references>.

Khi hệ thống của bạn xuất bản lại nội dung CAP từ nhà xuất bản khác, hãy bao gồm thông báo CAP đầy đủ. Để liên kết nội dung đã chỉnh sửa với nguồn ban đầu, hãy dùng thẻ <references>.

Nếu bạn tham chiếu nhiều thông báo thì hãy sử dụng khoảng trắng làm dấu phân cách.
<incidents> TÙY CHỌN string Phần tử <incidents> đối chiếu với nhiều thông báo đề cập đến nhiều khía cạnh của cùng một sự cố.
<info>

BẮT BUỘC*

 info Phải có ít nhất một phần tử <info>. Nhiều khối <info> phải có cùng giá trị phần tử <category> và <event>.

* Google yêu cầu các phần tử có tùy chọn BẮT BUỘC được in đậm và màu đỏ, nhưng các phần tử đó cũng là tùy chọn trong tiêu chuẩn CAP.

Ví dụ:

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>