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 akan terkena dampak angin kencang, hujan lebat, atau ancaman lainnya dari badai. Jika badai masih berada di lepas pantai, jangan tetapkan entity <area> pemberitahuan CAP Anda ke lokasi badai saat ini.

Demikian pula, dalam kasus kebakaran hutan, sebaiknya data entity <area> juga menyertakan kota atau tempat yang Anda perkirakan akan terpengaruh oleh asap atau ancaman lain dari kebakaran.

Sub-elemen entitas area

Nama elemen Opsionalitas Jenis Catatan dan persyaratan CAP serta Google
<areaDesc> WAJIB string

Untuk membuat string teks lokasi yang digunakan dalam judul atau judul utama pemberitahuan, Google dapat menggunakan elemen <areaDesc>. Buat nilai <areaDesc> tetap pendek (kurang dari 50 karakter).
<polygon> OPSIONAL string

Titik nilai yang disambungkan dalam elemen <polygon> menentukan poligon yang menandai area untuk diberi tahu dalam pesan pemberitahuan. Sebaiknya tampilkan elemen <polygon> dengan daftar pasangan koordinat WGS84 yang dipisahkan spasi kosong.

Poligon harus memenuhi persyaratan berikut:

  • Mereka 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 berpasangan yang menandai area untuk pemberitahuan dalam bentuk pesan pemberitahuan. Sebaiknya Anda merepresentasikan elemen <circle> dengan titik tengah: pasangan koordinat WGS84 yang 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. Misalnya, di Amerika Serikat, nilai ini berasal dari sumber data berikut:

  • FIPS6
  • Kode UGC
  • SAME
  • Kode Pos AS

Jika Anda menggunakan geocode, berikan daftar tetap peta geocode-to-polygon dan shapefile kepada Google. Untuk memposting pemberitahuan pembaruan ke daftar ini, gunakan saluran terpisah, sebaiknya sebagai pemberitahuan RSS atau email. Misalnya, NOAA AS memublikasikan secara publik pembaruan geocode mereka.
<altitude> OPSIONAL float

Nilai elemen <altitude> adalah ketinggian minimum atau spesifik dari area yang terpengaruh dalam pesan pemberitahuan. Berikan pengukuran ini dalam kaki di atas permukaan laut rata-rata sesuai dengan datum WGS84.
<ceiling> BERSYARAT float

Gunakan elemen <ceiling> hanya jika entitas <alert> berisi elemen <altitude>. Nilai elemen <ceiling> adalah ketinggian maksimum area yang terpengaruh pesan pemberitahuan. Berikan pengukuran ini dalam kaki di atas permukaan laut rata-rata sesuai dengan datum 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>