Data pemberitahuan Anda harus mengikuti spesifikasi Common Alerting Protocol v1.2 OASIS, plus spesifikasi Google Public Alerts CAP v1.0 serta persyaratan tambahan yang tercantum di bawah.
Tentang Google CAP
Standar CAP menetapkan struktur dasar dan elemen data untuk pemberitahuan CAP, tetapi masih ada cukup banyak inkonsistensi dalam cara dan waktu penggunaan berbagai elemen data.
Platform kami bertujuan untuk menyederhanakan proses pencarian informasi darurat dengan menyatukan data relevan berkualitas tinggi di dalam alat online yang sudah digunakan orang setiap hari. Persyaratan tambahan ini dimaksudkan untuk memaksimalkan jangkauan dan efektivitas notifikasi Anda di produk Google.
Perbedaan khusus Google dengan persyaratan XML CAP 1.2 dirangkum dalam spesifikasi Google Siap Siaga CAP v1.0.
Opsi "CAP
Pedoman di bawah ini berlaku untuk semua jenis peringatan dan bahaya. Kami juga telah mengumpulkan beberapa persyaratan dan rekomendasi tambahan untuk jenis pemberitahuan spesifik tersebut di bagian Contoh kami:
Lakukan pengujian berkala
- Pastikan sistem Anda dapat memublikasikan notifikasi dengan
<status>Pengujian</status>untuk melakukan pengujian sistem dari awal secara menyeluruh.
Area notifikasi target
- Jika ada area yang tidak berdekatan pada tingkat dan jenis notifikasi yang sama, buat
pesan
<alert>terpisah, bukan<alert>tunggal dengan area terpisah. - Jika elemen
<area>berisi elemen<polygon>, pastikan elemen tersebut adalah poligon yang valid tanpa memotong tepi, dan tentukan maksimum 6 titik desimal presisi. - Jika elemen
<area>dari notifikasi Anda berisi geocoding, berikan geodata dalam format shapefile dan beri tahu Google di google-public-alerts@google.com setidaknya 30 hari sebelum perubahan bentuk file apa pun. - Gambarkan poligon berbasis dampak yang disesuaikan untuk kondisi saat ini dan sifat peristiwa jika memungkinkan, daripada menargetkan peringatan ke area geopolitik yang telah ditentukan sebelumnya (misalnya, provinsi, distrik).
- Berikan Google deskripsi singkat (kurang dari 50 karakter) tentang area yang terpengaruh di
<areaDesc>atau dalam<parameter>khusus yang terpisah dari pemberitahuan CAP. Teks ini akan ditampilkan di judul notifikasi.
Sertakan konten lengkap
- Sertakan konten yang lengkap, dapat ditindaklanjuti, dan dapat dibaca manusia di elemen
<description>dan<instruction>. - Jelaskan peristiwa saat ini, prediksi pengembangan, dampak yang diharapkan, dan rekomendasi yang berlaku.
- Gunakan ejaan, tata bahasa, dan tanda baca yang benar.
- Gunakan teks biasa atau markup untuk meningkatkan keterbacaan konten, bukan tag HTML.
- Berikan kode warna RGB atau hex yang sesuai dengan setiap level notifikasi (dapat diberikan ke Google secara offline).
Memperbarui lansiran
Jika ada perubahan notifikasi, keluarkan notifikasi baru yang merujuk ke notifikasi sebelumnya, bukan mengubah atau menghapus notifikasi yang ada dari feed Anda. Setelah jangka waktu yang sesuai (misalnya 24-48 jam), hapus notifikasi yang dibatalkan, diperbarui, atau tidak berlaku lagi dari feed Anda.
UPDATE atau CANCEL <msgType> harus menyertakan setidaknya satu elemen <references>.
Seperti yang ditentukan dalam standar CAP, setiap pesan notifikasi yang memperbarui notifikasi sebelumnya harus menggunakan <msgType>Update</msgType> dan menetapkan <references>code</references> ke semua pesan terkait sebelumnya yang belum mencapai tanggal <expires>. UPDATE atau CANCEL harus diterapkan pada pemberitahuan yang masih berlaku.
Ada tiga cara untuk MEMBATALKAN acara, dalam urutan preferensi:
- Tetapkan tanggal waktu
<expires>untuk setiap peristiwa, dengan deskripsi pesan yang menentukan bahwa pemberitahuan ini akan berakhir sendiri. - Kirim
<alert>baru dengan<msgType>UPDATE,<responseType>"All Clear", dan<expires>dalam waktu singkat di masa mendatang. - Publikasikan
<alert>baru dengan<msgType>CANCEL.
Lihat Contoh Notifikasi untuk info terbaru dan pembatalan sebagai contoh.
Mendukung beberapa bahasa
Buat satu <alert> yang berisi beberapa blok <info> (satu blok <info> per bahasa).
Untuk mengetahui detail selengkapnya dan contoh notifikasi multibahasa, lihat Beberapa bahasa.