Thực thể <info>
sẽ chỉ định thông tin chi tiết về thông báo. Cần có ít nhất một khối <info>
cho một 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>
.
info
phần tử của thực thể
Bảng sau đây mô tả các giá trị phần tử phụ cho thực thể <info>
:
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 |
---|---|---|---|
<language> |
TÙY CHỌN | language |
Đối với giá trị mã Nếu phần tử |
<category> |
BẮT BUỘC | InfoCategory |
Mã <category> biểu thị danh mục của sự kiện chủ đề của thông báo cảnh báo. Để xác định đúng danh mục cho
các sự kiện của bạn, hãy tham khảo
Danh sách điều khoản sự kiện của OASIS. Phân loại đúng 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ử Các yêu cầu của Google đối với phần tử
|
<responseType> |
TÙY CHỌN | responseType |
Để biểu thị loại thao tác được đề xuất cho đúng đối tượng (nếu có), bạn nên sử dụng phần tử |
<urgency> |
BẮT BUỘC | urgency |
Đừng sử dụng giá trị Không xác định cho phần tử Điều quan trọng là Google phải biết trường Tốt nhất là nhà xuất bản đặt giá trị |
<severity> |
BẮT BUỘC | severity |
Đừng sử dụng giá trị Không xác định cho phần tử Điều quan trọng là Google phải biết trường Tốt nhất là nhà xuất bản đặt giá trị |
<certainty> |
BẮT BUỘC | certainty |
Đừng sử dụng giá trị Không xác định cho phần tử Điều quan trọng là Google phải biết trường Tốt nhất là nhà xuất bản đặt giá trị |
<audience> |
TÙY CHỌN | string |
Giá trị của phần tử <audience> là văn bản mô tả đối tượng dự kiến của tin nhắn cảnh báo. |
<eventCode> |
TÙY CHỌN | string |
Phần tử
nơi:
Nhiều thực thể của các phần tử Bạn nên lấy các giá trị phần tử
|
<effective> |
TÙY CHỌN | dateTime |
Giá trị của phần tử Bạn phải thêm các trường múi giờ vào tất cả Khi nội dung của một thông báo áp dụng ở nhiều múi giờ, nhà sản xuất thông báo nên sử dụng giờ UTC để ưu tiên thời gian địa phương. Ví dụ:
|
<onset> |
TÙY CHỌN | dateTime |
Giá trị của phần tử Nếu vị trí được trích dẫn trong khối Khi nội dung của một thông báo áp dụng ở nhiều múi giờ, nhà sản xuất thông báo nên sử dụng giờ UTC để ưu tiên thời gian địa phương. Ví dụ:
|
<expires> |
BẮT BUỘC* |
dateTime |
Giá trị của phần tử Nếu bạn không thể đặt thời gian hết hạn cho tất cả các thông báo, hãy cung cấp cho Google thời gian hết hạn mặc định cho mọi thông báo không có phần tử Bạn phải thêm các trường múi giờ vào tất cả Khi nội dung của một thông báo áp dụng ở nhiều múi giờ, nhà sản xuất thông báo nên sử dụng giờ UTC để ưu tiên thời gian địa phương. Ví dụ:
|
<senderName> |
TÙY CHỌN | string |
Phần tử Khi người gửi có tên dễ đọc, đường liên kết |
<headline> |
TÙY CHỌN | string |
Làm cho độ dài của chuỗi phần tử Chuỗi Đừng sử dụng các giá trị giống nhau cho phần tử |
<description> |
BẮT BUỘC* |
string |
Giá trị của phần tử Bạn nên cung cấp nội dung giàu thông tin và dễ đọc, giúp giải đáp những câu hỏi này:
Google sử dụng phần tử Bạn có thể sử dụng các thẻ Markdown được hỗ trợ sau: |
<instruction> |
TÙY CHỌN | string |
Giá trị của phần tử Liệt kê các thao tác không phù hợp với mức độ nghiêm trọng của cảnh báo. Hãy 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ể áp dụng, cùng với các mẹo quan trọng nhất trước tiên. Thành phần |
<web> |
BẮT BUỘC* |
string |
Liên kết phần tử |
<contact> |
TÙY CHỌN | string |
Trường |
<parameter> |
TÙY CHỌN | string |
Phần tử
nơi:
Nhiều thực thể của phần tử |
<resource> |
TÙY CHỌN | resource |
Phần tử |
<area> |
BẮT BUỘC* |
area |
Phần tử Bạn nên sử dụng phần tử |
* 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ụ:
<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>