Buat Notifikasi dalam format CAP

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

Anda memiliki 2 opsi untuk membuat pemberitahuan:

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

Pembuatan otomatis

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

Tim Google dapat memberikan dukungan selama penerapan. Hubungi tim Google Anda atau google-public-alerts@google.com.

Pembuatan manual

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

Elemen pemberitahuan

Anatomi notifikasi

Pemberitahuan akan menjawab pertanyaan utama berikut:

  1. Apa yang terjadi?
  2. Kapan acaranya?
  3. Apa yang harus dilakukan orang?
  4. Di mana notifikasi akan disimpan?

Berikut adalah contoh sederhana notifikasi:

    <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>
            <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 kerja yang lebih beragam yang mungkin mirip dengan milik Anda.

Acara

String <event> CAP (atau terkadang <headline>) muncul di judul notifikasi kami. Deskripsi singkat harus (kurang dari 35 karakter) dan cukup deskriptif untuk dipahami publik. Untuk persyaratan yang lebih mendetail, lihat elemen dan sub-elemen <info> dalam panduan referensi.

tanggal

Kolom zona waktu harus disertakan di 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 kelonggaran untuk Penghematan Waktu Musim Panas jika berlaku. Jika konten pesan berlaku di beberapa zona waktu, pembuat pesan harus menggunakan waktu UTC yang lebih disarankan daripada waktu lokal.

Petunjuk

Kolom <instruction> peringatan 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 notifikasi, serta area yang terpengaruh.

area notifikasi

Elemen <area> peringatan CAP harus menjelaskan area geografis yang akan diberi tahu, yang mungkin 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 potensi zona bahaya, bukan hanya titik asal kebakaran. atau area pembakaran saat ini.

Menentukan area sebagai poligon

Area pemberitahuan paling baik digunakan sebagai poligon karena cenderung lebih akurat. Idealnya, nilai elemen <area> didefinisikan sebagai area geografis tertentu yang terpengaruh oleh kondisi saat ini atau perkiraan, 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 badai petir atau banjir hanya dapat memengaruhi sebagian kecil wilayah hukum politik, dan peringatan hujan salju kemungkinan hanya memengaruhi pengguna yang berada di atas ketinggian tertentu. Dalam kasus seperti ini, menentukan seluruh distrik atau provinsi sebagai <area> dari peringatan CAP melebih-lebihkan area yang terpengaruh dan membuat peringatan kurang berguna.

Berdasarkan pengalaman kami, software atau alat pemberitahuan yang memungkinkan peramal untuk menggambar poligon kustom di area yang diinginkan untuk diperingatkan adalah idealnya.

Jika Anda menggunakan poligon, sebaiknya sertakan tidak lebih dari 5-6 titik desimal presisi dalam koordinat lintang/bujur. (Ini menghasilkan resolusi lebih tinggi daripada yang dapat ditargetkan oleh sebagian besar sistem peringatan.) Selain itu, pastikan poligon tersebut valid; misalnya, poligon tidak boleh berpotongan.

Menentukan area sebagai geocode

Jika Anda harus menentukan <area> sebagai geocoding atau sekumpulan beberapa geocode sebagai gantinya, gunakan geocode pada tingkat yang paling terperinci dan sertakan nama kota tertentu, dll. yang mungkin 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 pemberitahuan CAP

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

screenshot validator

Pilih Google Siap Siaga CAP v1.0 untuk memvalidasi 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 perlu memberikan URL feed dan alamat email, pilih Google Siap Siaga CAP v1.0, lalu klik Berlangganan. Anda akan menerima notifikasi saat ditemukan masalah di feed CAP.

Penayang notifikasi juga dapat mendownload skema Google CAP versi terbaru dari library CAP dan memvalidasi secara offline.

Langkah berikutnya: Kirim feed Notifikasi Anda ke Google