pemberitahuan

Untuk menentukan informasi dasar tentang peristiwa saat ini, gunakan entity <alert>.

Jika peristiwa menempati lebih dari satu lokasi yang sedang berlangsung secara bersamaan, sebaiknya bagi peristiwa menjadi beberapa objek alert. Misalnya, jika kebakaran hutan mencakup beberapa negara bagian, Anda dapat membagi pemberitahuan menjadi beberapa pemberitahuan, satu untuk setiap negara bagian. Dengan begitu, Anda memberikan informasi darurat tertentu ke setiap status, dan Anda memperbarui situasi kebakaran dengan lebih akurat.

Jika suatu peristiwa berubah dengan cepat, seperti badai yang bergerak dari timur ke barat, sebaiknya Anda melakukan pembaruan berkala pada pemberitahuan. Jangan hapus pemberitahuan yang ada dari feed Anda. Sebagai gantinya, berikan pemberitahuan baru yang merujuk ke pemberitahuan sebelumnya.

Atribut

Tabel 1 menjelaskan nilai atribut untuk entity <alert>:

Tabel 1. Atribut entitas <alert>

Nama elemen Opsionalitas Jenis Deskripsi
xmlns:cap WAJIB string

Atribut xmlns harus mereferensikan CAP URN sebagai namespaces.

Contoh:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

Elemen

Tabel 2 menjelaskan nilai sub-elemen untuk entitas <alert>:

Tabel 2. Elemen entitas <alert>

Nama elemen Opsionalitas Jenis Catatan dan persyaratan CAP serta Google
<identifier> WAJIB string Berikan ID pemberitahuan yang mewakili peristiwa. Nilai elemen <identifier> harus unik di semua peristiwa.
<sender> WAJIB string Elemen <sender> mengidentifikasi asal pemberitahuan. Nama tidak boleh berisi spasi, koma, atau karakter yang dibatasi.
<sent> WAJIB dateTime

Jika lokasi yang dikutip dalam blok <area> berada dalam satu zona waktu, gunakan elemen <sent> untuk menentukan waktu di zona tersebut. Jika berlaku, sertakan toleransi untuk Waktu Musim Panas.

Jika konten pesan berlaku di beberapa zona waktu, gunakan waktu UTC, bukan waktu lokal.
<status> WAJIB AlertStatus

Google hanya memublikasikan pemberitahuan yang tersedia secara publik dan memiliki <status> nilai elemen Actual.
<msgType> WAJIB AlertMsgType

UPDATE atau CANCEL <msgType> harus menyertakan setidaknya satu elemen <references>. Standar CAP menentukan hal berikut:

  • Setiap pesan pemberitahuan yang memperbarui pemberitahuan sebelumnya menggunakan UPDATE dan menetapkan nilai elemen <references> ke semua pesan sebelumnya yang belum mencapai tanggal <expires>.
  • Elemen UPDATE atau CANCEL <msgType> harus berlaku untuk pemberitahuan yang belum habis masa berlakunya. Oleh karena itu, semua pesan terkait dan pemberitahuan yang belum berakhir masa berlakunya harus dirujuk saat UPDATE atau CANCEL <msgType> dikeluarkan.

Untuk informasi selengkapnya, lihat Perubahan atau habis masa berlaku peristiwa.
<source> OPSIONAL string Elemen <source> menunjukkan sumber pemberitahuan tertentu. Contohnya adalah operator atau perangkat tertentu.
<scope> WAJIB AlertScope

Elemen <scope> menunjukkan distribusi pesan pemberitahuan yang dimaksudkan.
<restriction> BERSYARAT string Jika nilai elemen <scope> adalah Restricted, elemen <restriction> diperlukan. Elemen ini menjelaskan aturan untuk membatasi distribusi pesan pemberitahuan yang dibatasi.
<addresses> BERSYARAT string Jika nilai elemen <scope> adalah Private, elemen <addresses> diperlukan. Elemen ini mencantumkan penerima pesan pemberitahuan yang dimaksud. Anda dapat menyertakan beberapa alamat yang dipisahkan spasi, tetapi Anda harus mengapit alamat yang menyertakan spasi kosong dalam tanda kutip ganda.
<code> OPSIONAL string

Elemen <code> menunjukkan penanganan khusus untuk pesan pemberitahuan.
<note> BERSYARAT string

Jika pemberitahuan berisi salah satu nilai elemen berikut, elemen <note> diperlukan:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> BERSYARAT string

Jika nilai elemen <msgType> adalah UPDATE atau CANCEL, elemen <references> diperlukan.

Saat sistem Anda memublikasikan ulang konten CAP dari penayang lain, sertakan pemberitahuan CAP lengkap. Untuk menautkan konten yang diedit ke sumber asli, gunakan tag <references>.

Jika Anda mereferensikan beberapa pesan, gunakan spasi kosong sebagai pemisah.
<incidents> OPSIONAL string Elemen <incidents> mengumpulkan beberapa pesan yang merujuk ke berbagai aspek insiden yang sama.
<info>

WAJIB*

 info Harus ada setidaknya satu elemen <info>. Beberapa blok <info> harus memiliki nilai elemen <category> dan <event> yang sama.

* Google mewajibkan elemen yang memiliki opsionalitas WAJIB yang tebal dan berwarna merah, tetapi elemen tersebut bersifat opsional dalam standar CAP.

Contoh

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>