pemberitahuan

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

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

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

Atribut

Tabel 1 menjelaskan nilai atribut untuk entity <alert>:

Tabel 1. Atribut entitas <alert>

Nama elemen Opsional Type Deskripsi
xmlns:cap WAJIB DIISI string

Atribut xmlns harus merujuk ke CAP URN sebagai namespace.

Contoh:

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

Elemen

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

Tabel 2. Elemen entitas <alert>

Nama elemen Opsional Type Catatan dan persyaratan CAP dan Google
<identifier> WAJIB DIISI string Masukkan ID notifikasi yang mewakili peristiwa. Nilai elemen <identifier> harus unik di semua peristiwa.
<sender> WAJIB DIISI string Elemen <sender> mengidentifikasi pencetus notifikasi. Tidak boleh menyertakan spasi, koma, atau karakter yang dibatasi.
<sent> WAJIB DIISI dateTime

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

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

Google hanya memublikasikan notifikasi yang tersedia secara publik yang memiliki nilai elemen <status> sebesar Actual.
<msgType> WAJIB DIISI AlertMsgType

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

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

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

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

Elemen <code> menunjukkan penanganan khusus pada pesan pemberitahuan.
<note> KONDISI string

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

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

Jika nilai elemen <msgType> adalah UPDATE atau CANCEL, maka elemen <references> wajib diisi.

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

Jika Anda mereferensikan beberapa pesan, gunakan spasi kosong sebagai pembatas.
<incidents> OPSIONAL string Elemen <incidents> menyusun beberapa pesan yang merujuk ke aspek berbeda dari insiden yang sama.
<info>

DIPERLUKAN*

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

* Google mewajibkan elemen yang memiliki opsional REQUIRED dan berwarna merah, tetapi elemen tersebut bersifat opsional di 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>