info

Entity <info> menentukan detail pemberitahuan. Setidaknya satu blok <info> diperlukan untuk pemberitahuan. Jika Anda mendukung beberapa bahasa, sebaiknya gunakan satu blok <info> untuk setiap bahasa untuk entitas <alert> yang sama.

Elemen entitas info

Tabel berikut menjelaskan nilai sub-elemen untuk entitas <info>:

Nama elemen Opsionalitas Jenis Catatan dan persyaratan CAP serta Google
<language> OPSIONAL language

Untuk nilai kode <language>, sebaiknya gunakan RFC 3066 yang valid.

Jika elemen <language> tidak ada, nilai defaultnya adalah en-US.
<category> WAJIB InfoCategory Kode <category> menunjukkan kategori peristiwa subjek pesan pemberitahuan. Untuk mengidentifikasi kategori yang tepat untuk peristiwa Anda, lihat Daftar Istilah Peristiwa OASIS. Kategorisasi yang tepat dapat membantu Google menampilkan notifikasi dengan lebih akurat kepada pengguna.
<event> WAJIB string

Elemen <event> menunjukkan jenis peristiwa subjek pesan pemberitahuan.

Persyaratan Google untuk elemen <event> adalah sebagai berikut:

  • Buat panjangnya kurang dari 35 karakter.
  • Cantumkan kumpulan jenis <event> yang telah ditentukan sebelumnya dalam CSV atau Google Spreadsheet (lihat contoh Google Spreadsheet ini).
<responseType> OPSIONAL responseType

Untuk menunjukkan jenis tindakan yang direkomendasikan untuk audiens yang benar, jika berlaku, sebaiknya gunakan elemen <responseType>, beserta nilai elemen <instruction> yang sesuai.
<urgency> WAJIB urgency

Jangan gunakan nilai Tidak diketahui untuk elemen <urgency> karena nilai tersebut menyulitkan pengindeksan pemberitahuan dan peringkat relatif.

Google perlu mengetahui cara kolom <urgency> ditetapkan dan oleh siapa. Namun, informasi tersebut berada di luar cakupan profil formal.

Sebaiknya, penayang menetapkan nilai <urgency> berdasarkan kasus per kasus dan mengikuti panduan pemicu yang jelas. Namun, elemen <event> dapat memperbaiki nilai <urgency>, sehingga mengurangi fleksibilitas penulis pemberitahuan. Misalnya, NOAA di Amerika Serikat menetapkan urgensi secara statis berdasarkan jenis peristiwa.
<severity> WAJIB severity

Jangan gunakan nilai Tidak diketahui untuk elemen <severity> karena nilai tersebut menyulitkan pengindeksan pemberitahuan dan peringkat relatif.

Google perlu mengetahui cara kolom <severity> ditetapkan dan oleh siapa. Namun, informasi tersebut berada di luar cakupan profil formal.

Sebaiknya, penayang menetapkan nilai <severity> berdasarkan kasus per kasus dan mengikuti panduan pemicu yang jelas. Namun, elemen <event> dapat memperbaiki nilai <severity>, sehingga mengurangi fleksibilitas penulis pemberitahuan. Misalnya, NOAA di Amerika Serikat menetapkan urgensi secara statis berdasarkan jenis peristiwa.
<certainty> WAJIB certainty

Jangan gunakan nilai Tidak diketahui untuk elemen <certainty> karena nilai tersebut menyulitkan pengindeksan pemberitahuan dan peringkat relatif.

Google perlu mengetahui cara kolom <certainty> ditetapkan dan oleh siapa. Namun, informasi tersebut berada di luar cakupan profil formal.

Sebaiknya, penayang menetapkan nilai <certainty> berdasarkan kasus per kasus dan mengikuti panduan pemicu yang jelas. Namun, elemen <event> dapat memperbaiki nilai <certainty>, sehingga mengurangi fleksibilitas penulis pemberitahuan. Misalnya, NOAA di Amerika Serikat menetapkan urgensi secara statis berdasarkan jenis peristiwa.
<audience> OPSIONAL string Nilai elemen <audience> adalah teks yang menjelaskan audiens yang dituju dari pesan pemberitahuan.
<eventCode> OPSIONAL string

Elemen <eventCode> berisi kode khusus sistem yang mengidentifikasi jenis peristiwa pesan pemberitahuan dalam bentuk berikut.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

dalam hal ini:

  • valueName = String yang ditetapkan pengguna yang menentukan domain kode. Jika string tersebut adalah akronim, tampilkan dalam huruf besar semua tanpa titik. Contohnya adalah SAME, FIPS, dan ZIP.
  • value = String yang menunjukkan nilai elemen <eventCode>.

Beberapa instance elemen <eventCode> dapat terjadi dalam blok <info>.

Sebaiknya dapatkan nilai elemen <eventCode> dari Daftar Istilah Peristiwa OASIS. Jika Anda menggunakan daftar istilah peristiwa OASIS, gunakan OET:v1.2 sebagai nama nilai, seperti yang ditunjukkan dalam contoh ini:

        <eventCode>
          <valueName>OET:v1.2</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> OPSIONAL dateTime

Nilai elemen <effective> adalah waktu efektif informasi dalam pesan pemberitahuan.

Anda harus menyertakan kolom zona waktu di semua nilai dateTime. Jika lokasi yang dikutip dalam blok <area> berada dalam satu zona waktu, sebaiknya elemen <effective> menentukan waktu di zona tersebut. Jika berlaku, sertakan pengecualian untuk Waktu Musim Panas.

Jika konten pesan berlaku di beberapa zona waktu, sebaiknya produsen pesan menggunakan waktu UTC, bukan waktu lokal.

Contoh:

2002-05-24T16:49:00-07:00 mewakili 24 Mei 2002 pukul 16.49 PDT.
<onset> OPSIONAL dateTime

Nilai elemen <onset> adalah waktu yang diharapkan saat peristiwa subjek pesan pemberitahuan dimulai. Anda harus menyertakan kolom zona waktu di semua nilai dateTime.

Jika lokasi yang dikutip dalam blok <area> berada dalam satu zona waktu, sebaiknya elemen <effective> menentukan waktu di zona tersebut. Jika berlaku, sertakan toleransi untuk Waktu Musim Panas.

Jika konten pesan berlaku di beberapa zona waktu, sebaiknya produsen pesan menggunakan waktu UTC, bukan waktu lokal.

Contoh:

2002-05-24T16:49:00-07:00 mewakili 24 Mei 2002 pukul 16.49 PDT.
<expires>

WAJIB*

 dateTime

Nilai elemen <expires> adalah waktu habis masa berlaku peristiwa subjek pesan pemberitahuan. Elemen <expires> harus muncul setelah elemen <effective> dalam urutan waktu.

Jika Anda tidak dapat menetapkan waktu habis masa berlaku untuk semua pemberitahuan, berikan waktu habis masa berlaku default kepada Google untuk pemberitahuan yang tidak memiliki elemen <expires>. Misalnya, Anda dapat menyatakan bahwa secara default, semua pemberitahuan Anda akan berakhir masa berlakunya setelah 48 jam jika tidak ada elemen <expires>.

Anda harus menyertakan kolom zona waktu di semua nilai dateTime. Jika lokasi yang dikutip dalam blok <area> berada dalam satu zona waktu, sebaiknya elemen <effective> menentukan waktu di zona tersebut. Jika berlaku, sertakan pengecualian untuk Waktu Musim Panas.

Jika konten pesan berlaku di beberapa zona waktu, sebaiknya produsen pesan menggunakan waktu UTC, bukan waktu lokal.

Contoh:

2002-05-24T16:49:00-07:00 mewakili 24 Mei 2002 pukul 16.49 PDT.
<senderName> OPSIONAL string

Elemen <senderName> bersifat opsional, tetapi sangat direkomendasikan.

Jika pengirim memiliki nama yang dapat dibaca manusia, link <web> dapat ditampilkan dengan cara yang mudah digunakan, sesuai dengan preferensi penayang atau pengirim. Selain itu, elemen <senderName> memungkinkan agregator pemberitahuan memublikasikan dari beberapa otoritas.
<headline> OPSIONAL string

Buat panjang string elemen <headline> kurang dari 140 karakter.

String <headline> dapat berupa teks terbuka, tetapi sebaiknya terdiri dari kurang dari 140 karakter. (CAP 1.2 menyarankan kurang dari 160 untuk pesan teks.) Mulai string ini dengan beberapa kata deskriptif yang menjelaskan inti pemberitahuan. Contohnya adalah "Pontoon bridge closure...."

Jangan gunakan nilai yang sama untuk elemen <headline> dan <description>. Berikan detail selengkapnya di elemen <description> daripada di elemen <headline>.
<description>

WAJIB*

 string

Nilai elemen <description> adalah teks yang mendeskripsikan subjek peristiwa pesan pemberitahuan.

Sebaiknya gunakan konten informatif yang dapat dibaca manusia dan menjawab pertanyaan berikut:

  • Apa yang terjadi atau akan terjadi?
  • Di mana hal ini terjadi?
  • Seberapa buruk masalah ini?

Google menggunakan elemen <description> untuk mengisi bagian Pesan di halaman kami dan menggunakan elemen <instruction> untuk mengisi bagian Tindakan yang direkomendasikan. Kedua kolom tersebut dapat dilihat oleh pengguna.

Anda dapat menggunakan tag Markdown yang didukung ini: <newline>, <b>, dan <a href>.
<instruction> OPSIONAL string

Nilai elemen <instruction> adalah teks yang menjelaskan tindakan yang direkomendasikan untuk penerima pesan pemberitahuan. Sebaiknya gunakan konten yang informatif dan dapat dibaca manusia.

Cantumkan tindakan yang sesuai dengan tingkat keparahan pemberitahuan dan yang tidak bersifat umum. Gunakan kalimat ringkas yang peka huruf besar/kecil dan sertakan tips keamanan yang dapat dilakukan pembaca, dengan tips yang paling penting terlebih dahulu.

Elemen <instruction> bersifat opsional, tetapi kami sangat merekomendasikannya. Google Public Alerts menggunakan kolom <instruction> untuk mengisi bagian Tindakan yang disarankan di halaman detail notifikasi. Buat nilai kolom <instruction> dan <description> berbeda karena memiliki tujuan yang berbeda.
<web>

OPSIONAL

 string

Tautkan elemen <web> ke URL yang berfungsi dan memberikan informasi selengkapnya tentang pemberitahuan Anda.
<contact> OPSIONAL string

Kolom <contact> bersifat opsional, tetapi sebaiknya kolom ini ada karena memberikan cara bagi pengguna untuk memberikan masukan dan merespons pemberitahuan. Misalnya, "Untuk keadaan darurat, hubungi 911".
<parameter> OPSIONAL string

Elemen <parameter> berisi data khusus sistem dalam bentuk berikut:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

dalam hal ini:

valueName = String yang ditetapkan pengguna yang menentukan domain kode.

value = Nilai string.

Beberapa instance elemen <parameter> dapat terjadi dalam blok <info>.
<resource> OPSIONAL resource

Elemen <resource> memberikan informasi tambahan tambahan yang terkait dengan elemen <info> induk. Beberapa instance elemen <resource> dapat terjadi dalam blok <info>.
<area>

WAJIB*

 area

Elemen <area> berisi informasi tentang area pemberitahuan peristiwa, bukan area insiden. Blok <area> harus menyertakan setidaknya satu elemen <circle>, <polygon>, atau <geocode>.

Sebaiknya gunakan elemen <polygon> atau <circle>, bukan <geocode>.

* Google mewajibkan elemen yang memiliki opsionalitas WAJIB yang tebal dan berwarna merah, tetapi elemen tersebut bersifat opsional dalam standar CAP.

Contoh

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>