info (ข้อมูล)

เอนทิตี <info> จะระบุรายละเอียดของการแจ้งเตือน ต้องมี<info>บล็อก อย่างน้อย 1 รายการสำหรับการแจ้งเตือน หากคุณรองรับหลายภาษา เราขอแนะนําให้ใช้บล็อก <info> 1 บล็อกสําหรับแต่ละภาษาสําหรับเอนทิตี <alert> เดียวกัน

info องค์ประกอบเอนทิตี

ตารางต่อไปนี้อธิบายค่าองค์ประกอบย่อยสำหรับเอนทิตี <info>

ชื่อองค์ประกอบ ความไม่บังคับ ประเภท หมายเหตุและข้อกำหนดของ CAP และ Google
<language> ไม่บังคับ language

สำหรับค่ารหัส <language> เราขอแนะนำให้คุณใช้ RFC 3066 ที่ถูกต้อง

หากไม่มีองค์ประกอบ <language> ค่าเริ่มต้นจะเป็น en-US
<category> ต้องระบุ InfoCategory รหัส <category> หมายถึงหมวดหมู่ของเหตุการณ์เรื่องในข้อความแจ้งเตือน หากต้องการระบุหมวดหมู่ที่เหมาะสมสําหรับเหตุการณ์ โปรดดูรายการคําศัพท์เหตุการณ์ OASIS การจัดหมวดหมู่ที่เหมาะสมจะช่วยให้ Google แสดงการแจ้งเตือนต่อผู้ใช้ได้อย่างแม่นยำยิ่งขึ้น
<event> ต้องระบุ string

องค์ประกอบ <event> หมายถึงประเภทเหตุการณ์ของเรื่องในข้อความแจ้งเตือน

ข้อกําหนดของ Google สําหรับองค์ประกอบ <event> มีดังนี้

<responseType> ไม่บังคับ responseType

หากต้องการระบุประเภทการดําเนินการที่แนะนําสําหรับกลุ่มเป้าหมายที่ถูกต้อง (หากมี) เราขอแนะนําอย่างยิ่งให้ใช้องค์ประกอบ <responseType> พร้อมกับค่าองค์ประกอบ <instruction> ที่สอดคล้องกับองค์ประกอบดังกล่าว
<urgency> ต้องระบุ urgency

อย่าใช้ค่า "ไม่ทราบ" สำหรับองค์ประกอบ <urgency> เนื่องจากค่าดังกล่าวทำให้จัดทำดัชนีการแจ้งเตือนและอันดับแบบสัมพัทธ์ได้ยาก

Google จำเป็นต้องทราบว่ามีการตั้งค่า<urgency> ช่องนี้อย่างไรและใครเป็นผู้ตั้งค่า อย่างไรก็ตาม ข้อมูลดังกล่าวอยู่นอกขอบเขตของโปรไฟล์อย่างเป็นทางการ

เราขอแนะนำให้ผู้เผยแพร่โฆษณากำหนดค่า <urgency> ทีละกรณีและปฏิบัติตามหลักเกณฑ์ทริกเกอร์ที่ชัดเจน อย่างไรก็ตาม องค์ประกอบ <event> อาจแก้ไขค่า <urgency> ซึ่งจะลดความยืดหยุ่นของผู้เขียนการแจ้งเตือน ตัวอย่างเช่น NOAA ในสหรัฐอเมริกาตั้งค่าความเร่งด่วนแบบคงที่ตามประเภทเหตุการณ์
<severity> ต้องระบุ severity

อย่าใช้ค่า "ไม่ทราบ" สำหรับองค์ประกอบ <severity> เนื่องจากค่าดังกล่าวทำให้จัดทำดัชนีการแจ้งเตือนและอันดับแบบสัมพัทธ์ได้ยาก

Google จำเป็นต้องทราบว่ามีการตั้งค่า<severity> ช่องนี้อย่างไรและใครเป็นผู้ตั้งค่า อย่างไรก็ตาม ข้อมูลดังกล่าวอยู่นอกขอบเขตของโปรไฟล์อย่างเป็นทางการ

เราขอแนะนำให้ผู้เผยแพร่โฆษณากำหนดค่า <severity> ทีละกรณีและปฏิบัติตามหลักเกณฑ์ทริกเกอร์ที่ชัดเจน อย่างไรก็ตาม องค์ประกอบ <event> อาจแก้ไขค่า <severity> ซึ่งจะลดความยืดหยุ่นของผู้เขียนการแจ้งเตือน ตัวอย่างเช่น NOAA ในสหรัฐอเมริกาตั้งค่าความเร่งด่วนแบบคงที่ตามประเภทเหตุการณ์
<certainty> ต้องระบุ certainty

อย่าใช้ค่า "ไม่ทราบ" สำหรับองค์ประกอบ <certainty> เนื่องจากค่าดังกล่าวทำให้จัดทำดัชนีการแจ้งเตือนและอันดับแบบสัมพัทธ์ได้ยาก

Google จำเป็นต้องทราบว่ามีการตั้งค่าช่อง <certainty> อย่างไรและใครเป็นผู้ตั้งค่า อย่างไรก็ตาม ข้อมูลดังกล่าวอยู่นอกขอบเขตของโปรไฟล์อย่างเป็นทางการ

เราขอแนะนำให้ผู้เผยแพร่โฆษณากำหนดค่า <certainty> ทีละกรณีและปฏิบัติตามหลักเกณฑ์ทริกเกอร์ที่ชัดเจน อย่างไรก็ตาม องค์ประกอบ <event> อาจแก้ไขค่า <certainty> ซึ่งจะลดความยืดหยุ่นของผู้เขียนการแจ้งเตือน ตัวอย่างเช่น NOAA ในสหรัฐอเมริกาตั้งค่าความเร่งด่วนแบบคงที่ตามประเภทเหตุการณ์
<audience> ไม่บังคับ string ค่าขององค์ประกอบ <audience> คือข้อความที่อธิบายกลุ่มเป้าหมายที่ต้องการของข้อความแจ้งเตือน
<eventCode> ไม่บังคับ string

องค์ประกอบ <eventCode> มีโค้ดเฉพาะระบบที่ระบุประเภทเหตุการณ์ของข้อความแจ้งเตือนในรูปแบบต่อไปนี้

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

where:

  • valueName = สตริงที่ผู้ใช้กําหนดซึ่งระบุโดเมนของโค้ด หากสตริงเหล่านั้นเป็นตัวย่อ ให้แสดงเป็นตัวพิมพ์ใหญ่ทั้งหมดโดยไม่มีจุด เช่น SAME, FIPS และ ZIP
  • value = สตริงที่ระบุค่าขององค์ประกอบ <eventCode>

องค์ประกอบ <eventCode> หลายอินสแตนซ์อาจเกิดขึ้นภายในบล็อก <info>

เราขอแนะนําอย่างยิ่งให้คุณรับค่าองค์ประกอบ <eventCode>จากรายการข้อกําหนดของกิจกรรม OASIS หากคุณใช้รายการคำศัพท์เหตุการณ์ OASIS ให้ใช้ OET:v1.2 เป็นชื่อค่า ดังที่แสดงในตัวอย่างต่อไปนี้

        <eventCode>
          <valueName>OET:v1.2</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> ไม่บังคับ dateTime

ค่าขององค์ประกอบ <effective> คือเวลาที่มีผลของข้อมูลในข้อความแจ้งเตือน

คุณต้องใส่ช่องเขตเวลาในค่า dateTime ทั้งหมด หากสถานที่ที่ระบุไว้ในบล็อก <area> อยู่ภายในเขตเวลาเดียว เราขอแนะนำให้องค์ประกอบ <effective> ระบุเวลาในเขตเวลานั้น ระบุเวลาออมแสงหากมี

เมื่อเนื้อหาของข้อความมีผลกับเขตเวลาหลายเขต เราขอแนะนำให้ผู้ผลิตข้อความใช้เขตเวลา UTC แทนเขตเวลาท้องถิ่น

ตัวอย่างเช่น

2002-05-24T16:49:00-07:00 หมายถึงวันที่ 24 พฤษภาคม 2002 เวลา 16:49 น. ตามเขตเวลา PDT
<onset> ไม่บังคับ dateTime

ค่าขององค์ประกอบ <onset> คือเวลาที่คาดไว้เมื่อเหตุการณ์เรื่องของข้อความแจ้งเตือนเริ่มต้น คุณต้องใส่ฟิลด์เขตเวลาในค่า dateTime ทั้งหมด

หากสถานที่ที่ระบุไว้ในบล็อก <area> อยู่ภายในเขตเวลาเดียวกัน เราขอแนะนำให้องค์ประกอบ <effective> ระบุเวลาในเขตเวลานั้น ระบุเวลาออมแสงหากมี

เมื่อเนื้อหาของข้อความมีผลกับเขตเวลาหลายเขต เราขอแนะนำให้ผู้ผลิตข้อความใช้เขตเวลา UTC แทนเขตเวลาท้องถิ่น

ตัวอย่างเช่น

2002-05-24T16:49:00-07:00 หมายถึงวันที่ 24 พฤษภาคม 2002 เวลา 16:49 น. ตามเขตเวลา PDT
<expires>

ต้องระบุ*

 dateTime

ค่าขององค์ประกอบ <expires> คือเวลาหมดอายุของเหตุการณ์เรื่องในข้อความแจ้งเตือน องค์ประกอบ <expires> ต้องอยู่หลังองค์ประกอบ <effective> ตามลำดับเวลา

หากตั้งค่าเวลาหมดอายุสำหรับการแจ้งเตือนทั้งหมดไม่ได้ ให้ระบุเวลาหมดอายุเริ่มต้นสำหรับคำเตือนที่ไม่มีองค์ประกอบ <expires> ให้กับ Google เช่น คุณสามารถระบุว่าโดยค่าเริ่มต้น ระบบจะตั้งค่าการแจ้งเตือนทั้งหมดให้หมดอายุหลังผ่านไป 48 ชั่วโมงหากไม่มีองค์ประกอบ <expires>

คุณต้องใส่ช่องเขตเวลาในค่า dateTime ทั้งหมด หากสถานที่ที่ระบุไว้ในบล็อก <area> อยู่ภายในเขตเวลาเดียว เราขอแนะนำให้องค์ประกอบ <effective> ระบุเวลาในเขตเวลานั้น ระบุเวลาออมแสงหากมี

เมื่อเนื้อหาของข้อความมีผลกับเขตเวลาหลายเขต เราขอแนะนำให้ผู้ผลิตข้อความใช้เขตเวลา UTC แทนเขตเวลาท้องถิ่น

ตัวอย่างเช่น

2002-05-24T16:49:00-07:00 หมายถึงวันที่ 24 พฤษภาคม 2002 เวลา 16:49 น. ตามเขตเวลา PDT
<senderName> ไม่บังคับ string

องค์ประกอบ <senderName> เป็นค่าที่ไม่บังคับ แต่เราขอแนะนำอย่างยิ่งให้ระบุ

เมื่อผู้ส่งมีชื่อที่อ่านออกได้ <web> ลิงก์จะแสดงในลักษณะที่ใช้งานง่ายตามค่ากําหนดของผู้เผยแพร่โฆษณาหรือผู้ส่ง นอกจากนี้ องค์ประกอบ <senderName> ยังช่วยให้ผู้รวบรวมการแจ้งเตือนเผยแพร่ข้อมูลจากหน่วยงานหลายแห่งได้
<headline> ไม่บังคับ string

ปรับความยาวของสตริงองค์ประกอบ <headline> ให้น้อยกว่า 140 อักขระ

สตริง <headline> อาจเป็นข้อความแบบเปิดได้ แต่เราขอแนะนำให้มีความยาวไม่เกิน 140 อักขระ (CAP 1.2 แนะนำให้ใช้ข้อความไม่เกิน 160 ตัวสำหรับ SMS) เริ่มสตริงนี้ด้วยคำอธิบายสั้นๆ 2-3 คำที่อธิบายถึงประเด็นสำคัญของการแจ้งเตือน ตัวอย่างเช่น "Pontoon bridge closure...."

อย่าใช้ค่าเดียวกันสำหรับองค์ประกอบ <headline> และ <description> ระบุรายละเอียดในองค์ประกอบ <description> มากกว่าในองค์ประกอบ <headline>
<description>

ต้องระบุ*

 string

ค่าขององค์ประกอบ <description> คือข้อความที่อธิบายเรื่องเหตุการณ์ของข้อความแจ้งเตือน

เราขอแนะนำให้ใช้เนื้อหาที่อ่านเข้าใจได้และให้ข้อมูลซึ่งตอบคำถามต่อไปนี้

  • เหตุการณ์ที่กำลังเกิดขึ้นหรือกำลังจะเกิดขึ้น
  • ปัญหาเกิดขึ้นที่ใด
  • ปัญหารุนแรงแค่ไหน

Google ใช้องค์ประกอบ <description> เพื่อป้อนข้อมูลในส่วนข้อความของหน้าเว็บ และใช้องค์ประกอบ <instruction> เพื่อป้อนข้อมูลในส่วนการดำเนินการที่แนะนำ ผู้ใช้จะเห็นทั้ง 2 ช่อง

คุณสามารถใช้แท็ก Markdown ที่รองรับต่อไปนี้ <newline>, <b> และ <a href>
<instruction> ไม่บังคับ string

ค่าขององค์ประกอบ <instruction> คือข้อความที่อธิบายการดำเนินการที่แนะนำสำหรับผู้รับข้อความแจ้งเตือน เราขอแนะนำให้ใช้เนื้อหาที่อ่านเข้าใจได้และให้ข้อมูล

แสดงรายการการดำเนินการที่เหมาะกับระดับความรุนแรงของการแจ้งเตือนและไม่ใช่การดำเนินการทั่วไป ใช้ประโยคที่กระชับ คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และใส่เคล็ดลับด้านความปลอดภัยที่ผู้อ่านสามารถนำไปใช้ได้ โดยให้เคล็ดลับที่สำคัญที่สุดก่อน

คุณจะใช้องค์ประกอบ <instruction> หรือไม่ก็ได้ แต่เราขอแนะนำอย่างยิ่งให้ใช้ Google Public Alerts ใช้ช่อง <instruction> เพื่อป้อนข้อมูลในส่วนการดำเนินการที่แนะนำในหน้ารายละเอียดการแจ้งเตือน ตั้งค่าฟิลด์ <instruction> และ <description> ให้แตกต่างกันเนื่องจากมีวัตถุประสงค์ต่างกัน
<web>

ไม่บังคับ

 string

ลิงก์องค์ประกอบ <web> กับ URL ที่ใช้งานได้ซึ่งให้ข้อมูลเพิ่มเติมเกี่ยวกับการแจ้งเตือน
<contact> ไม่บังคับ string

ช่อง <contact> เป็นช่องที่ไม่บังคับ แต่เราขอแนะนำอย่างยิ่งให้ระบุช่องนี้เนื่องจากเป็นช่องทางให้ผู้ใช้แสดงความคิดเห็นและตอบสนองต่อการแจ้งเตือน เช่น "หากเกิดเหตุฉุกเฉิน ให้โทรหา 911"
<parameter> ไม่บังคับ string

องค์ประกอบ <parameter> มีข้อมูลที่เจาะจงระบบในรูปแบบต่อไปนี้

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

where:

valueName = สตริงที่ผู้ใช้กําหนดซึ่งระบุโดเมนของโค้ด

value = ค่าสตริง

องค์ประกอบ <parameter> หลายอินสแตนซ์สามารถปรากฏภายในบล็อก <info> ได้
<resource> ไม่บังคับ resource

องค์ประกอบ <resource> ให้ข้อมูลเพิ่มเติมที่เกี่ยวข้องกับองค์ประกอบ <info> หลัก องค์ประกอบ <resource> หลายอินสแตนซ์สามารถปรากฏภายในบล็อก <info> ได้
<area>

ต้องระบุ*

 area

องค์ประกอบ <area> มีข้อมูลเกี่ยวกับพื้นที่การแจ้งเตือนของเหตุการณ์ ไม่ใช่พื้นที่ที่เกิดเหตุการณ์ บล็อก <area> ต้องมีองค์ประกอบ <circle>, <polygon> หรือ <geocode> อย่างน้อย 1 รายการ

เราขอแนะนําอย่างยิ่งให้ใช้องค์ประกอบ <polygon> หรือ <circle> แทนองค์ประกอบ <geocode>

* Google กำหนดให้องค์ประกอบที่มีตัวเลือกเป็นตัวหนาสีแดงต้องระบุ แต่องค์ประกอบเหล่านั้นเป็นตัวเลือกในมาตรฐาน CAP

ตัวอย่าง

<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>