Membuat Pemberitahuan dalam format CAP

Selain Standar CAP, ikuti persyaratan khusus Google untuk file CAP guna memastikan notifikasi Anda diproses dengan benar.

Penting: Pastikan sistem Anda dapat memublikasikan pemberitahuan dengan <status>Test</status> untuk melakukan pengujian sistem menyeluruh secara rutin.

Anda memiliki 2 opsi untuk membuat pemberitahuan:

1. Pembuatan otomatis: Siapkan sistem Anda untuk memformat informasi database secara dinamis ke dalam feed CAP dan mengirimkannya secara otomatis ke Google.
2. Pembuatan manual: Buat dan kirim konten pemberitahuan secara manual sesuai kebutuhan melalui aplikasi berbasis web.

Pembuatan otomatis

Lihat library CAP Google untuk memulai dalam bahasa pilihan Anda. Library ini mendukung pembuatan, penguraian, dan validasi feed CAP.

Tim Google dapat memberikan dukungan selama penerapan. Hubungi tim Google Anda atau [e-mail].

Pembuatan manual

Catatan: Untuk memastikan ketersediaan dan perlindungan yang tinggi dari pemadaman daya, internet, atau pemadaman lainnya, Anda dapat menggunakan layanan hosting cloud seperti Google Cloud Platform.

1. Bekerja samalah dengan tim IT Anda untuk menginstal aplikasi web open source CAPCreator™ ke server web. Atau, Anda dapat membuat aplikasi web sendiri.
2. Saat peristiwa terjadi, buka URL aplikasi dan gunakan antarmuka untuk membuat pemberitahuan dalam format CAP.
3. Aplikasi Anda memublikasikan feed ke lokasi web; Google kemudian mengambil informasi tersebut dari feed yang dipublikasikan.

Elemen pemberitahuan

Anatomi pemberitahuan

Notifikasi harus menjawab pertanyaan utama berikut:

1. Apa yang terjadi?
2. Kapan hal ini terjadi?
3. Apa yang harus dilakukan orang-orang?
4. Ke mana notifikasi dikirim?

Berikut adalah contoh sederhana pemberitahuan:

    <alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
        <identifier>AL20110412020900TornadoWarning</identifier>
        <sender>[e-mail]</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</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>
            <instruction>
                Do not 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>

Pastikan untuk melihat Contoh Notifikasi CAP kami untuk mengetahui contoh notifikasi yang berfungsi lebih lengkap yang mungkin serupa dengan notifikasi Anda.

Peristiwa

String CAP <event> (atau terkadang <headline>) muncul dalam judul pemberitahuan kami. Nama ini harus singkat (kurang dari 35 karakter) dan cukup deskriptif agar dapat dipahami oleh publik. Untuk persyaratan yang lebih mendetail, lihat elemen dan sub-elemen <info> dalam panduan referensi.

Tanggal

Kolom zona waktu harus disertakan dalam semua nilai tanggal/waktu (seperti <effective>, <expires>, dan <onset>). Jika lokasi yang dikutip dalam blok <area> berada dalam satu zona waktu, <effective> harus menentukan waktu di zona tersebut, termasuk toleransi untuk Waktu Musim Panas jika berlaku. Jika konten pesan berlaku di beberapa zona waktu, produsen pesan harus menggunakan waktu UTC, bukan waktu lokal.

Petunjuk

Kolom <instruction> notifikasi CAP muncul di halaman detail notifikasi sebagai "tindakan yang direkomendasikan". Perhatikan bahwa konten elemen ini tidak boleh sama dengan <description>, yang lebih cocok untuk meringkas sifat dan intensitas pemberitahuan, serta area yang terpengaruh.

Area notifikasi

Elemen <area> pemberitahuan CAP harus mendeskripsikan area geografis yang akan diberi tahu,yang dapat mencakup lokasi di luar area insiden. Misalnya, pertimbangkan peringatan kebakaran hutan: Karena kebakaran hutan dapat menyebar dengan cepat ke area yang saat ini tidak terbakar, <area> harus mencakup seluruh zona bahaya potensial, bukan hanya titik asal kebakaran atau area kebakaran saat ini.

Menentukan area sebagai poligon

Area pemberitahuan sebaiknya diberikan sebagai poligon karena cenderung lebih akurat. Idealnya, nilai elemen <area> ditentukan sebagai area geografis tertentu yang terpengaruh oleh kondisi saat ini atau yang diprediksi, bukan area geopolitik yang telah ditentukan sebelumnya seperti distrik atau provinsi. Hal ini membantu memastikan bahwa pengguna yang melihat pemberitahuan merasa relevan dengan lokasi mereka. Misalnya, peringatan petir atau banjir mungkin hanya memengaruhi sebagian kecil wilayah hukum, dan peringatan salju mungkin hanya memengaruhi pengguna yang berada di atas ketinggian tertentu. Dalam kasus seperti ini, menentukan seluruh distrik atau provinsi sebagai <area> pemberitahuan CAP akan melebih-lebihkan area yang terpengaruh dan membuat pemberitahuan kurang berguna.

Berdasarkan pengalaman kami, software atau alat pemberitahuan yang memungkinkan peramal menggambar poligon kustom di area yang ingin mereka beri peringatan adalah ideal.

Jika Anda menggunakan poligon, sebaiknya sertakan presisi titik desimal maksimal 5-6 dalam koordinat lintang/bujur. (Hal ini menghasilkan resolusi yang lebih tinggi daripada yang dapat ditargetkan oleh sebagian besar sistem pemberitahuan.) Selain itu, pastikan poligon valid; misalnya, poligon tidak boleh memiliki tepi yang bersimpangan.

Menentukan area sebagai geocode

Jika Anda harus menentukan <area> sebagai geocode atau kumpulan beberapa geocode, gunakan geocode pada tingkat yang paling terperinci dan sertakan nama kota, kota, dll. tertentu yang kemungkinan akan terpengaruh dalam elemen <description>. Anda harus membagikan shapefile yang mendasarinya dalam format shapefile.

Mendukung beberapa bahasa

Buat satu <alert> yang berisi beberapa blok <info> (satu blok <info> per bahasa).

Untuk detail selengkapnya dan contoh pemberitahuan multibahasa, lihat Contoh Beberapa Bahasa.

Memvalidasi notifikasi CAP

Sebaiknya gunakan alat CAP Validator open source Google untuk memvalidasi pemberitahuan CAP Anda. Anda juga dapat berlangganan email notifikasi error melalui alat ini. Validator menawarkan beberapa opsi dan contoh validasi CAP:

Pilih Google Public Alerts CAP v1.0 untuk memvalidasi terhadap persyaratan khusus Google untuk feed CAP.

Untuk berlangganan email notifikasi error, klik Berlangganan hasil validasi feed, atau buka http://cap-validator.appspot.com/subscribe. Anda harus memberikan URL feed dan alamat email, memilih Google Public Alerts CAP v1.0, dan mengklik Berlangganan. Anda akan menerima notifikasi saat masalah ditemukan di feed CAP.

Catatan: Validator tidak memeriksa kepatuhan terhadap semua persyaratan Google. Tim Google Anda mungkin menyarankan peningkatan lebih lanjut.

Penayang pemberitahuan juga dapat mendownload versi terbaru skema CAP Google dari library CAP dan memvalidasinya secara offline.

Langkah berikutnya: Kirim feed Notifikasi Anda ke Google