luas

Sebaiknya entitas <area> menentukan area geografis yang akan diberi tahu, bukan area insiden.

Dalam kasus badai tropis, sebaiknya entitas <area> berisi elemen <polygon> atau <geocode> yang menunjukkan tempat yang Anda perkirakan terkena dampak angin kencang, hujan lebat, atau ancaman lain dari badai. Jika badai masih lepas pantai, jangan tetapkan entitas <area> untuk pemberitahuan CAP ke lokasi badai saat ini.

Demikian pula, dalam kasus kebakaran hutan, sebaiknya data entitas <area> juga menyertakan kota atau tempat yang diperkirakan akan terkena dampak asap atau ancaman lainnya dari kebakaran.

area sub-elemen entitas

Nama elemen Opsional Type Catatan dan persyaratan CAP dan Google
<areaDesc> WAJIB DIISI string

Untuk membuat string teks lokasi yang digunakan dalam judul atau judul notifikasi, Google dapat menggunakan elemen <areaDesc>. Buat nilai <areaDesc> yang singkat (kurang dari 50 karakter).

<polygon> OPSIONAL string

Titik nilai yang dipasangkan di elemen <polygon> menentukan poligon yang menggambarkan area untuk pemberitahuan dalam pesan pemberitahuan. Sebaiknya Anda mewakili elemen <polygon> dengan daftar pasangan koordinat WGS84 yang dipisahkan spasi.

Poligon harus memenuhi persyaratan berikut:

  • Keduanya harus ditutup.
  • Keduanya tidak boleh tumpang-tindih.
  • Lubang (seperti dalam poligon berbentuk donat) dan persimpangan tidak didukung.
  • Diperlukan minimal empat pasangan koordinat. Pasangan koordinat pertama dan terakhir harus sama.
<circle> OPSIONAL string

Elemen <circle> terdiri dari nilai titik dan radius yang dipasangkan yang menandai area untuk memberikan peringatan dalam bentuk pesan pemberitahuan. Sebaiknya Anda merepresentasikan elemen <circle> dengan titik tengah: pasangan koordinat WGS84, diikuti dengan karakter spasi dan nilai radius dalam kilometer.

Catatan: Jika Anda menentukan lingkaran dengan radius nol atau sangat kecil, Google tidak dapat menampilkan pemberitahuan kepada pengguna kami.

<geocode> OPSIONAL string

Tentukan elemen <geocode> dengan nilai dari set data poligon yang dapat diakses dan terbuka. Sebagai contoh, di Amerika Serikat, nilai-nilai ini berasal dari sumber data berikut:

  • FIPS6
  • Kode UGC
  • SAMA
  • Kode Pos Amerika Serikat

Jika Anda menggunakan geocode, berikan daftar lengkap peta geocode-to-poligon dan shapefile kepada Google. Untuk memposting pemberitahuan pembaruan ke daftar ini, gunakan saluran terpisah, sebaiknya sebagai peringatan RSS atau email. Misalnya, NOAA AS secara publik memublikasikan update geocode mereka.

<altitude> OPSIONAL float

Nilai elemen <altitude> adalah ketinggian tertentu atau minimum dari area pesan pemberitahuan yang terpengaruh. Berikan pengukuran ini dalam kaki di atas permukaan laut rata-rata menurut data WGS84.

<ceiling> KONDISI float

Gunakan elemen <ceiling> hanya jika entitas <alert> berisi elemen <altitude>. Nilai elemen <ceiling> adalah ketinggian maksimum area yang terpengaruh dari pesan pemberitahuan. Berikan pengukuran ini dalam kaki di atas permukaan laut rata-rata menurut data WGS84.

Contoh

<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>