info

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

Elemen entitas info

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

Nama elemen Opsional Type Catatan dan persyaratan CAP dan 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 DIISI InfoCategory Kode <category> menunjukkan kategori peristiwa subjek pesan pemberitahuan. Untuk mengidentifikasi kategori yang tepat untuk acara Anda, lihat Daftar Persyaratan Peristiwa OASIS. Kategorisasi yang tepat dapat membantu Google menampilkan notifikasi secara lebih akurat kepada pengguna.
<event> WAJIB DIISI string

Elemen <event> menunjukkan jenis peristiwa subjek pesan pemberitahuan.

Persyaratan Google untuk elemen <event> adalah sebagai berikut:

  • Buat panjang kurang dari 35 karakter.
  • Buat daftar kumpulan jenis <event> yang telah ditetapkan di CSV atau spreadsheet Google (lihat contoh Google Spreadsheet ini).
<responseType> OPSIONAL responseType

Untuk menunjukkan jenis tindakan yang direkomendasikan untuk audiens yang tepat, jika berlaku, kami sangat merekomendasikan elemen <responseType>, beserta nilai elemen <instruction> yang sesuai.
<urgency> WAJIB DIISI urgency

Jangan gunakan nilai Unknown untuk elemen <urgency> karena nilai tersebut akan mempersulit pengindeksan notifikasi dan peringkat relatif.

Google harus mengetahui cara menetapkan dan menetapkan kolom <urgency>. 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> mungkin telah memperbaiki nilai <urgency> sehingga mengurangi fleksibilitas penulis pemberitahuan. Sebagai contoh, NOAA di AS menetapkan urgensi secara statis berdasarkan jenis peristiwa.
<severity> WAJIB DIISI severity

Jangan gunakan nilai Unknown untuk elemen <severity> karena nilai tersebut akan mempersulit pengindeksan notifikasi dan peringkat relatif.

Google harus mengetahui cara menetapkan dan menetapkan kolom <severity>. 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> mungkin telah memperbaiki nilai <severity> sehingga mengurangi fleksibilitas penulis pemberitahuan. Sebagai contoh, NOAA di AS menetapkan urgensi secara statis berdasarkan jenis peristiwa.
<certainty> WAJIB DIISI certainty

Jangan gunakan nilai Unknown untuk elemen <certainty> karena nilai tersebut akan mempersulit pengindeksan notifikasi dan peringkat relatif.

Google perlu mengetahui cara menetapkan dan menentukan kolom <certainty>. 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> mungkin telah memperbaiki nilai <certainty> sehingga mengurangi fleksibilitas penulis pemberitahuan. Sebagai contoh, NOAA di AS 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 formulir berikut.

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

dalam hal ini:

  • valueName = String yang ditetapkan pengguna yang menentukan domain kode. Jika string tersebut merupakan akronim, representasikan semuanya dengan huruf kapital 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 Anda mendapatkan nilai elemen <eventCode> dari Daftar Persyaratan Peristiwa OASIS. Jika Anda menggunakan daftar istilah peristiwa OASIS, gunakan OET:v1.0 sebagai nama nilai, seperti yang ditunjukkan dalam contoh ini:

        <eventCode>
          <valueName>OET:v1.0</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 ada, sertakan kuota waktu Musim Panas.

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

Contoh:

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

Nilai elemen <onset> adalah waktu yang diharapkan ketika 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 kuota waktu Musim Panas.

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

Contoh:

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

DIPERLUKAN*

 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 notifikasi, beri Google waktu habis masa berlaku default untuk notifikasi yang tidak memiliki elemen <expires>. Misalnya, Anda dapat menyatakan bahwa secara default, semua pemberitahuan akan habis 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 ada, sertakan kuota waktu Musim Panas.

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

Contoh:

2002-05-24T16:49:00-07:00 merepresentasikan 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 notifikasi untuk dipublikasikan dari beberapa otoritas.
<headline> OPSIONAL string

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

String <headline> dapat berupa teks terbuka, tetapi sebaiknya string ini terdiri dari kurang dari 140 karakter. (CAP 1.2 menyarankan kurang dari 160 untuk SMS.) Awali string ini dengan beberapa kata deskriptif yang menjelaskan inti notifikasi. Contohnya adalah "Penutupan jembatan ponton...."

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

DIPERLUKAN*

 string

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

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

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

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

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

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

Cantumkan tindakan yang sesuai dengan tingkat keparahan notifikasi dan tidak bersifat umum. Gunakan kalimat yang ringkas dan peka huruf besar/kecil serta sertakan tips keselamatan yang dapat ditindaklanjuti pembaca, dengan tips terpenting terlebih dahulu.

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

DIPERLUKAN*

 string

Tautkan elemen <web> ke salinan pemberitahuan asli yang dapat diakses di server web Anda.
<contact> OPSIONAL string

Kolom <contact> bersifat opsional, tetapi sebaiknya kolom tersebut tersedia karena memberikan cara bagi pengguna untuk memberikan masukan dan merespons notifikasi. 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 terkait elemen <info> induk. Beberapa instance elemen <resource> dapat terjadi dalam blok <info>.
<area>

DIPERLUKAN*

 area

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

Kami sangat merekomendasikan penggunaan elemen <polygon> atau <circle>, bukan elemen <geocode>.

* Google mewajibkan elemen yang memiliki opsional REQUIRED dan berwarna merah, tetapi elemen tersebut bersifat opsional di 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>