diện tích

Bạn nên định nghĩa thực thể <area> để xác định khu vực địa lý cần thông báo, chứ không phải là khu vực xảy ra sự cố.

Trong trường hợp có bão nhiệt đới, bạn nên sử dụng thực thể <area> cho biết các yếu tố <polygon> hoặc <geocode> biểu thị những nơi bạn mong muốn có gió giật mạnh, mưa lớn hoặc các mối đe dọa khác từ bão. Nếu một cơn bão vẫn ở ngoài khơi, thì đừng đặt thực thể <area> của thông báo CAP thành vị trí hiện tại của cơn bão.

Tương tự như vậy, trong trường hợp xảy ra cháy rừng, bạn cũng nên bao gồm dữ liệu về thực thể <area>, bao gồm cả các thị trấn hoặc nơi bạn mong muốn bị ảnh hưởng bởi khói hoặc các mối đe dọa khác từ đám cháy.

area thành phần phụ 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
<areaDesc> BẮT BUỘC string

Để tạo chuỗi văn bản vị trí dùng trong tiêu đề hoặc dòng tiêu đề thông báo, Google có thể sử dụng phần tử <areaDesc>. Giữ giá trị <areaDesc> ngắn (dưới 50 ký tự).
<polygon> TÙY CHỌN string

Các điểm giá trị đã ghép nối trong một phần tử <polygon> sẽ xác định một đa giác có chức năng mô tả khu vực cần thông báo trong thông báo cảnh báo. Bạn nên đại diện cho phần tử <polygon> bằng danh sách các cặp tọa độ WGS84 được phân tách bằng khoảng trắng.

Đa giác phải đáp ứng các yêu cầu sau:

  • Các địa điểm này phải đóng cửa.
  • Chúng không được chồng chéo lên nhau.
  • Các lỗ (như trong hình đa giác có hình bánh rán) và giao lộ không được hỗ trợ.
  • Cần có tối thiểu 4 cặp tọa độ. Cặp tọa độ đầu tiên và cuối cùng phải giống nhau.
<circle> TÙY CHỌN string

Phần tử <circle> bao gồm các giá trị điểm và bán kính ghép nối để phân tách khu vực cần cảnh báo dưới dạng thông báo cảnh báo. Bạn nên đại diện cho phần tử <circle> bằng một điểm trung tâm: một cặp toạ độ WGS84 theo sau là một ký tự dấu cách và một giá trị bán kính theo ki lô mét.

Lưu ý: Nếu bạn chỉ định một vòng tròn có 0 hoặc bán kính rất nhỏ, Google sẽ không thể hiển thị thông báo cho người dùng.
<geocode> TÙY CHỌN string

Xác định phần tử <geocode> bằng các giá trị từ một tập dữ liệu đa giác có thể truy cập và mở. Ví dụ: ở Hoa Kỳ, những giá trị này đến từ các nguồn dữ liệu sau:

  • FIPS6 (FIPS6)
  • Mã UGC
  • TƯƠNG TỰ
  • Mã Zip Hoa Kỳ

Nếu bạn sử dụng mã địa lý, hãy cung cấp cho Google danh sách cố định các bản đồ mã hóa địa lý đến đa giác và tệp hình dạng. Để đăng thông báo về nội dung cập nhật cho danh sách này, hãy sử dụng một kênh riêng, ưu tiên dưới dạng RSS hoặc cảnh báo qua email. Ví dụ: US NOAA công khai bản cập nhật mã địa lý của họ.
<altitude> TÙY CHỌN float

Giá trị của phần tử <altitude> là độ cao cụ thể hoặc tối thiểu của khu vực bị ảnh hưởng trong thông báo cảnh báo. Hãy cung cấp chỉ số đo này tính bằng feet trên mực nước biển trung bình theo mốc đo lường WGS84.
<ceiling> CÓ ĐIỀU KIỆN float

Chỉ sử dụng phần tử <ceiling> nếu thực thể <alert> chứa phần tử <altitude>. Giá trị của phần tử <ceiling> là độ cao tối đa của vùng bị ảnh hưởng trong thông báo cảnh báo. Hãy cung cấp số đo này theo bộ trên mực nước biển trung bình theo mốc đo lường WGS84.

Ví dụ:

<area>
    <areaDesc>Cavite</areaDesc>
    <polygon>14.473860833486,120.9718174024 14.347454023196,121.01386683476
     14.142014336735,121.03024107602 14.063075455227,120.85558468426
     14.221664765773,120.59001887699 14.473860833486,
     120.9718174024</polygon>
    <geocode>
        <valueName>SAME</valueName>
        <value>042100000</value>
    </geocode>
</area>

<area>
    <areaDesc>107 km SouthWest DENPASAR-BALI</areaDesc>
    <circle>-9.63,115.12 300.0</circle>
</area>