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

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

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

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

Attributes

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

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

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

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

ตัวอย่าง

<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

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

  • ข้อความแจ้งเตือนที่อัปเดตการแจ้งเตือนก่อนหน้าจะใช้ UPDATE และตั้งค่าองค์ประกอบ <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>