การแจ้งเตือน

หากต้องการกําหนดข้อมูลพื้นฐานเกี่ยวกับเหตุการณ์ปัจจุบัน ให้ใช้เอนทิตี <alert>

หากกิจกรรมมีสถานที่ตั้งที่กําลังดําเนินอยู่มากกว่า 1 แห่งพร้อมกัน ให้แบ่งเหตุการณ์ออกเป็นออบเจ็กต์ alert หลายรายการ เช่น หากไฟป่ากินพื้นที่หลายรัฐ คุณอาจแบ่งการแจ้งเตือนออกเป็นหลายๆ สถานะ โดยแบ่งเป็นการแจ้งเตือนสําหรับแต่ละรัฐ วิธีนี้จะทําให้คุณให้ข้อมูลสําหรับกรณีฉุกเฉินโดยเฉพาะสําหรับแต่ละรัฐ และอัปเดตสถานการณ์ไฟไหม้ได้ถูกต้องมากขึ้น

หากเหตุการณ์มีการเปลี่ยนแปลงอย่างรวดเร็ว เช่น พายุเฮอริเคนที่เคลื่อนจากทิศตะวันออกไปทิศตะวันตก เราขอแนะนําให้คุณอัปเดตการแจ้งเตือนเป็นระยะ อย่านําการแจ้งเตือนที่มีอยู่ออกจากฟีด แต่ให้ออกการแจ้งเตือนใหม่ที่อ้างถึงการแจ้งเตือนก่อนหน้าแทน

Attributes

ตาราง 1 จะอธิบายค่าแอตทริบิวต์สําหรับเอนทิตี <alert> ดังนี้

ตารางที่ 1 แอตทริบิวต์ของ <alert>

ชื่อองค์ประกอบ ตัวเลือก ประเภท คำอธิบาย
xmlns:cap ต้องระบุ string

แอตทริบิวต์ xmlns ต้องอ้างอิง CAP URN เป็นเนมสเปซ

ตัวอย่าง

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

องค์ประกอบ

ตาราง 2 จะอธิบายค่าองค์ประกอบย่อยสําหรับเอนทิตี <alert>

ตารางที่ 2 องค์ประกอบเอนทิตี <alert>

ชื่อองค์ประกอบ ตัวเลือก ประเภท CAP และบันทึกและข้อกําหนดของ Google
<identifier> ต้องระบุ string ระบุรหัสการแจ้งเตือนที่แสดงถึงเหตุการณ์นั้น ค่าขององค์ประกอบ <identifier> ต้องไม่ซ้ํากันในทุกเหตุการณ์
<sender> ต้องระบุ string องค์ประกอบ <sender> ระบุผู้สร้างการแจ้งเตือน โดยต้องไม่มีการเว้นวรรค จุลภาค หรืออักขระที่จํากัด
<sent> ต้องระบุ dateTime

หากตําแหน่งที่อ้างถึงในบล็อก <area> อยู่ในเขตเวลาเดียว ให้ใช้องค์ประกอบ <sent> เพื่อระบุเวลาในโซนนั้น หากเป็นไปได้ ให้ระบุเวลาออมแสง

เมื่อมีการใช้เนื้อหาของข้อความในหลายเขตเวลา ให้ใช้เวลา UTC มากกว่าเวลาท้องถิ่น
<status> ต้องระบุ AlertStatus

Google เผยแพร่เฉพาะการแจ้งเตือนที่เปิดเผยต่อสาธารณะซึ่งมีค่าเอลิเมนต์ <status> เป็น Actual
<msgType> ต้องระบุ AlertMsgType

<msgType> หรือ CANCEL ของ UPDATE ต้องมีองค์ประกอบ <references> อย่างน้อย 1 รายการ มาตรฐาน CAP จะระบุสิ่งต่อไปนี้

  • ข้อความแจ้งเตือนใดๆ ที่อัปเดตการแจ้งเตือนก่อนหน้านี้จะใช้อัปเดต และตั้งค่าเอลิเมนต์ <references> เป็นข้อความก่อนหน้าทั้งหมดที่ยังไม่ถึงวันที่ <expires>
  • องค์ประกอบ UPDATE หรือ CANCEL <msgType> ต้องนําไปใช้กับการแจ้งเตือนที่ยังไม่หมดอายุ ดังนั้น จะต้องอ้างอิงข้อความที่เกี่ยวข้องทั้งหมดและการแจ้งเตือนที่ยังไม่หมดอายุเมื่อมีการออก UPDATE หรือ CANCEL <msgType>

ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงหรือวันหมดอายุของกิจกรรม
<source> ไม่บังคับ string องค์ประกอบ <source> แสดงถึงแหล่งที่มาของการแจ้งเตือนหนึ่งๆ ตัวอย่างเช่น โอเปอเรเตอร์ หรืออุปกรณ์ที่เฉพาะเจาะจง
<scope> ต้องระบุ AlertScope

องค์ประกอบ <scope> หมายถึงการกระจายข้อความแจ้งเตือน
<restriction> มีเงื่อนไข string หากค่าขององค์ประกอบ <scope> คือ Restricted คุณจะต้องระบุองค์ประกอบ <restriction> องค์ประกอบนี้จะอธิบายกฎเพื่อจํากัดการกระจายของข้อความแจ้งเตือนที่ถูกจํากัด
<addresses> มีเงื่อนไข string หากค่าขององค์ประกอบ <scope> คือ Private คุณจะต้องระบุองค์ประกอบ <addresses> องค์ประกอบนี้แสดงรายการผู้รับข้อความแจ้งเตือน คุณใส่อีเมลหลายรายการที่คั่นด้วยช่องว่างได้ แต่ต้องใส่อีเมลที่มีช่องว่างในเครื่องหมายคําพูดคู่
<code> ไม่บังคับ string

องค์ประกอบ <code> หมายถึงการจัดการข้อความแจ้งเตือนโดยเฉพาะ
<note> มีเงื่อนไข string

หากการแจ้งเตือนมีค่าองค์ประกอบอย่างใดอย่างหนึ่งต่อไปนี้ คุณต้องระบุองค์ประกอบ <note>

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> มีเงื่อนไข string

หากค่าขององค์ประกอบ <msgType> คือ UPDATE หรือ CANCEL คุณจะต้องระบุองค์ประกอบ <references>

เมื่อระบบเผยแพร่เนื้อหา CAP อีกครั้งจากผู้เผยแพร่อื่น ให้ใส่การแจ้งเตือน CAP แบบเต็ม หากต้องการลิงก์เนื้อหาที่แก้ไขกับแหล่งที่มาเดิม ให้ใช้แท็ก <references>

หากอ้างอิงหลายข้อความ ให้ใช้การเว้นวรรคเป็นตัวคั่น
<incidents> ไม่บังคับ string องค์ประกอบ <incidents> จะรวมข้อความหลายรายการซึ่งกล่าวถึงแง่มุมต่างๆ ของเหตุการณ์เดียวกันไว้
<info>

ต้องระบุ*

 info ต้องมีองค์ประกอบ <info> อย่างน้อย 1 รายการ บล็อก <info> หลายรายการต้องมีค่าองค์ประกอบ <category> และ <event> เดียวกัน

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

ตัวอย่าง

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>