Persyaratan Google CAP

Data pemberitahuan Anda harus mengikuti spesifikasi Common Alerting Protocol v1.2 OASIS, serta spesifikasi Google Public Alerts CAP v1.0 dan persyaratan tambahan yang tercantum di bawah.

Tentang Google CAP

Standar CAP menetapkan struktur dasar dan elemen data untuk pemberitahuan CAP, tetapi masih menyisakan banyak ruang untuk inkonsistensi dalam cara dan waktu berbagai elemen data digunakan.

Platform kami bertujuan untuk menyederhanakan proses menemukan informasi darurat dengan menggabungkan data yang relevan dan berkualitas tinggi di dalam alat online yang sudah digunakan orang setiap hari. Persyaratan tambahan ini dimaksudkan untuk memaksimalkan jangkauan dan efektivitas pemberitahuan Anda di produk Google.

Perbedaan khusus Google dengan persyaratan XML CAP 1.2 diringkas dalam spesifikasi Google Public Alerts CAP v1.0.

Opsi "Google Public Alerts CAP" di CAPValidator open source memungkinkan Anda memvalidasi data berdasarkan spesifikasi OASIS dan persyaratan tambahan Google.

Panduan di bawah berlaku untuk semua jenis pemberitahuan dan bahaya. Kami juga telah mengumpulkan beberapa persyaratan dan rekomendasi tambahan untuk jenis pemberitahuan khusus ini di bagian Contoh:

Melakukan pengujian berkala

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

Area pemberitahuan target

  • Jika ada area yang tidak berdekatan dalam tingkat dan jenis pemberitahuan yang sama, buat pesan <alert> terpisah, bukan satu <alert> dengan area yang terpisah.
  • Jika elemen <area> berisi elemen <polygon>, pastikan elemen tersebut merupakan poligon yang valid tanpa tepi yang berpotongan sendiri atau poligon yang tumpang-tindih, dan tentukan presisi maksimum 6 titik desimal.
  • Jika elemen <area> pemberitahuan Anda berisi geocode, berikan geodata dalam format shapefile dan beri tahu Google di google-public-alerts@google.com setidaknya 30 hari sebelum shapefile berubah.
  • Menggambar poligon berbasis dampak yang disesuaikan untuk kondisi saat ini dan sifat peristiwa jika memungkinkan, bukan menargetkan pemberitahuan ke area geopolitik yang telah ditentukan sebelumnya (misalnya, provinsi, distrik).
  • Berikan deskripsi singkat (kurang dari 50 karakter) tentang area yang terpengaruh kepada Google di <areaDesc> atau di <parameter> khusus terpisah dari pemberitahuan CAP Anda. Teks ini akan ditampilkan di judul pemberitahuan.

Menyertakan konten lengkap

  • Sertakan konten lengkap, yang dapat ditindaklanjuti, dan dapat dibaca manusia dalam elemen <description> dan <instruction>.
  • Jelaskan peristiwa saat ini, perkiraan perkembangan, dampak yang diharapkan, dan rekomendasi yang berlaku.
  • Gunakan ejaan, tata bahasa, dan tanda baca yang benar.
  • Gunakan teks biasa untuk meningkatkan keterbacaan konten Anda, bukan tag HTML.
  • Berikan kode warna RGB atau heksadesimal yang sesuai dengan setiap tingkat pemberitahuan (dapat diberikan ke Google secara offline).

Pembaruan pemberitahuan

Saat pemberitahuan berubah, terbitkan pemberitahuan baru yang merujuk pada pemberitahuan sebelumnya, bukan mengubah atau menghapus pemberitahuan yang ada dari feed Anda. Setelah waktu yang sesuai (hingga dua minggu), hapus pemberitahuan CAP yang sudah tidak berlaku dari feed Anda.

<msgType> UPDATE atau CANCEL harus menyertakan minimal satu elemen <references>. Seperti yang ditentukan dalam standar CAP, setiap pesan pemberitahuan yang memperbarui pemberitahuan 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 berlaku untuk pemberitahuan yang belum habis masa berlakunya.

Ada tiga cara untuk MENGBATALKAN acara, dalam urutan preferensi:

  1. Tetapkan waktu <expires> untuk setiap peristiwa, dengan deskripsi pesan yang menetapkan ekspektasi bahwa pemberitahuan ini akan berakhir dengan sendirinya.
  2. Terbitan <alert> baru dengan <msgType>UPDATE, <responseType>"All Clear", dan <expires> dalam waktu singkat di masa mendatang.
  3. Terbitan <alert> baru dengan <msgType>CANCEL.

Lihat Contoh Pemberitahuan untuk pembaruan dan pembatalan untuk mengetahui contohnya.

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.