Dữ liệu cảnh báo của bạn phải tuân theo quy cách Common Alerting Protocol v1.2 (Giao thức cảnh báo chung phiên bản 1.2) của OASIS, cùng với quy cách CAP v1.0 của Google Public Alerts (CAP phiên bản 1.0 của Cảnh báo công khai của Google) và các yêu cầu bổ sung được nêu bên dưới.
Giới thiệu về Google CAP
Tiêu chuẩn CAP thiết lập cấu trúc cơ bản và các phần tử dữ liệu cho cảnh báo CAP, nhưng vẫn có nhiều chỗ để xảy ra sự không nhất quán về cách thức và thời điểm sử dụng các phần tử dữ liệu.
Nền tảng của chúng tôi hướng đến việc đơn giản hoá quy trình tìm thông tin khẩn cấp bằng cách kết hợp dữ liệu chất lượng cao và phù hợp bên trong các công cụ trực tuyến mà mọi người đã sử dụng hằng ngày. Các yêu cầu bổ sung này nhằm tối đa hoá phạm vi tiếp cận và hiệu quả của cảnh báo trên các sản phẩm của Google.
Những điểm khác biệt dành riêng cho Google với các yêu cầu về XML CAP 1.2 được tóm tắt trong quy cách CAP v1.0 của Cảnh báo công cộng của Google.
Tuỳ chọn "CAP Cảnh báo công khai của Google" trong Trình xác thực CAP nguồn mở cho phép bạn xác thực dữ liệu của mình dựa trên cả thông số kỹ thuật OASIS và các yêu cầu bổ sung của Google.
Các nguyên tắc dưới đây áp dụng cho mọi loại cảnh báo và mối nguy hiểm. Chúng tôi cũng đã tổng hợp một số yêu cầu và đề xuất bổ sung cho các loại cảnh báo cụ thể này trong phần Mẫu:
Kiểm thử định kỳ
- Đảm bảo hệ thống của bạn có thể phát hành cảnh báo bằng
<status>Test</status>để thường xuyên kiểm thử hệ thống toàn diện.
Khu vực cảnh báo mục tiêu
- Nếu có các khu vực không liền kề thuộc cùng một cấp độ và loại cảnh báo, hãy tạo các thông báo
<alert>riêng biệt thay vì một<alert>duy nhất với các khu vực rời rạc. - Nếu phần tử
<area>chứa các phần tử<polygon>, hãy đảm bảo đó là các đa giác hợp lệ không có cạnh tự giao nhau hoặc các đa giác chồng chéo nhau, đồng thời chỉ định độ chính xác tối đa là 6 dấu thập phân. - Nếu phần tử
<area>của cảnh báo chứa mã địa lý, hãy cung cấp dữ liệu địa lý ở định dạng shapefile và thông báo cho Google theo địa chỉ google-public-alerts@google.com ít nhất 30 ngày trước khi có bất kỳ thay đổi nào đối với tệp shapefile. - Vẽ các đa giác dựa trên mức độ tác động được tuỳ chỉnh cho các điều kiện hiện tại và bản chất của sự kiện bất cứ khi nào có thể, thay vì nhắm mục tiêu cảnh báo đến các khu vực địa chính trị được xác định trước (ví dụ: tỉnh, huyện).
- Cung cấp cho Google nội dung mô tả ngắn (dưới 50 ký tự) về khu vực bị ảnh hưởng trong
<areaDesc>hoặc trong một<parameter>riêng biệt dành riêng cho cảnh báo CAP. Văn bản này sẽ xuất hiện trong tiêu đề cảnh báo.
Thêm nội dung đa dạng thức
- Thêm nội dung đa dạng thức, hữu ích và dễ đọc vào các phần tử
<description>và<instruction>. - Mô tả sự kiện hiện tại, sự phát triển dự kiến, tác động dự kiến và các đề xuất (nếu có).
- Sử dụng đúng chính tả, ngữ pháp và dấu câu.
- Sử dụng văn bản thuần tuý để cải thiện khả năng đọc của nội dung thay vì thẻ HTML.
- Cung cấp mã màu RGB hoặc hex tương ứng với từng cấp độ cảnh báo (có thể cung cấp cho Google khi không có mạng).
Cập nhật thông báo
Khi một cảnh báo thay đổi, hãy phát hành một cảnh báo mới tham chiếu đến cảnh báo trước đó, thay vì thay đổi hoặc xoá cảnh báo hiện có khỏi nguồn cấp dữ liệu. Sau một khoảng thời gian thích hợp (tối đa 2 tuần), hãy xoá các cảnh báo CAP cũ khỏi nguồn cấp dữ liệu.
<msgType> UPDATE hoặc CANCEL phải bao gồm ít nhất một phần tử <references>.
Như đã chỉ định trong tiêu chuẩn CAP, mọi thông báo cảnh báo cập nhật thông báo trước đó phải sử dụng <msgType>Update</msgType> và đặt <references>code</references> thành tất cả thông báo liên quan trước đó chưa đến ngày <expires>.
Thao tác CẬP NHẬT hoặc HUỶ phải áp dụng cho một cảnh báo chưa hết hạn.
Có 3 cách để HUỶ sự kiện, theo thứ tự ưu tiên:
- Đặt ngày giờ
<expires>cho mỗi sự kiện, trong đó nội dung mô tả thông báo sẽ đặt kỳ vọng rằng cảnh báo này sẽ tự kết thúc. - Phát hành
<alert>mới với<msgType>UPDATE,<responseType>"All Clear"và<expires>trong một thời gian ngắn trong tương lai. - Phát hành
<alert>mới bằng<msgType>CANCEL.
Vui lòng xem Cảnh báo mẫu về nội dung cập nhật và huỷ để biết ví dụ.
Hỗ trợ nhiều ngôn ngữ
Vui lòng tạo một <alert> chứa nhiều khối <info> (mỗi ngôn ngữ có một khối <info>).
Để biết thêm thông tin chi tiết và một cảnh báo mẫu bằng nhiều ngôn ngữ, hãy xem phần Nhiều ngôn ngữ.