diện tích

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

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

Tương tự, trong trường hợp cháy rừng, bạn nên thêm dữ liệu thực thể <area> về các thị trấn hoặc địa điểm mà bạn cho rằng sẽ chịu ảnh hưởng của khói hoặc các mối đe doạ khác từ đám cháy.

Phần tử phụ của thực thể area

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
<areaDesc> BẮT BUỘC string

Để tạo chuỗi văn bản địa điểm dùng trong tiêu đề hoặc dòng tiêu đề của cảnh báo, Google có thể sử dụng phần tử <areaDesc>. Giữ giá trị <areaDesc> ngắn gọn (dưới 50 ký tự).
<polygon> KHÔNG BẮT BUỘC string

Các điểm giá trị được ghép nối trong phần tử <polygon> xác định một đa giác phân định khu vực cần cảnh báo trong thông báo cảnh báo. Bạn nên biểu thị phần tử <polygon> bằng một danh sách được phân tách bằng khoảng trắng gồm các cặp toạ độ WGS84.

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

  • Bạn phải đóng các thẻ này.
  • Các khoảng thời gian này không được trùng lặp.
  • Không hỗ trợ lỗ (như trong đa giác hình bánh rán) và giao lộ.
  • Bạn phải có tối thiểu 4 cặp toạ độ. Các cặp toạ độ đầu tiên và cuối cùng phải giống nhau.
<circle> KHÔNG BẮT BUỘC string

Phần tử <circle> bao gồm các giá trị điểm và bán kính được ghép nối để xác định 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 biểu thị 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ự khoảng trắng và giá trị bán kính tính bằng kilômét.

Lưu ý: Nếu bạn chỉ định một vòng tròn có bán kính bằng 0 hoặc rất nhỏ, thì Google sẽ không thể hiển thị cảnh báo cho người dùng.
<geocode> KHÔNG BẮT BUỘC 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 mở và có thể truy cập. Ví dụ: ở Hoa Kỳ, các giá trị này đến từ các nguồn dữ liệu sau:

  • FIPS6
  • Mã nội dung do người dùng tạo
  • SAME
  • Mã bưu chính 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ã địa lý sang đa giác và tệp shapefile. Để đă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, tốt nhất là dưới dạng cảnh báo qua RSS hoặc email. Ví dụ: NOAA của Hoa Kỳ công khai bản cập nhật mã địa lý.
<altitude> KHÔNG BẮT BUỘC float

Giá trị của phần tử <altitude> là độ cao cụ thể hoặc tối thiểu của khu vực chịu ảnh hưởng của thông báo cảnh báo. Cung cấp số đo này theo feet (m) so với mực nước biển trung bình theo toạ độ WGS84.
<ceiling> CONDITIONAL 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 khu vực chịu ảnh hưởng của thông báo cảnh báo. Cung cấp số đo này theo feet trên mực nước biển trung bình theo toạ độ 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>