ข้อมูล

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

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

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

ชื่อองค์ประกอบ	ตัวเลือก	ประเภท	CAP และบันทึกและข้อกําหนดของ Google
<language>	ไม่บังคับ	language	สําหรับค่ารหัส <language> เราขอแนะนําให้คุณใช้ RFC 3066 ที่ถูกต้อง หากไม่มีองค์ประกอบ <language> ค่าเริ่มต้นจะเป็น en-US
<category>	ต้องระบุ	InfoCategory	รหัส <category> หมายถึงหมวดหมู่เหตุการณ์การแจ้งเตือนของข้อความแจ้งเตือน หากต้องการระบุหมวดหมู่ที่เหมาะกับกิจกรรมของคุณ โปรดดูที่รายการข้อกําหนดของเหตุการณ์ OASIS การจัดหมวดหมู่ที่ถูกต้องจะช่วยให้ Google แสดงการแจ้งเตือนแก่ผู้ใช้ได้ถูกต้องแม่นยํายิ่งขึ้น
<event>	ต้องระบุ	string	องค์ประกอบ <event> หมายถึงประเภทของเหตุการณ์ที่เป็นชื่อเรื่องของข้อความแจ้งเตือน ข้อกําหนดของ Google สําหรับองค์ประกอบ <event> มีดังนี้ ทําให้มีความยาวน้อยกว่า 35 อักขระ แสดงรายการชุดประเภท <event> ที่กําหนดไว้ล่วงหน้าใน CSV หรือสเปรดชีต Google (ดูตัวอย่าง Google ชีต) สําคัญ: ขอแนะนําอย่างยิ่งให้ใช้รายการข้อกําหนดของเหตุการณ์ OASIS และติดตั้งโค้ด <event> ในส่วน <eventCode>
<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> โดยที่: valueName = สตริงที่ผู้ใช้กําหนดซึ่งกําหนดโดเมนของโค้ด หากสตริงเหล่านั้นเป็นคําย่อ ให้แสดงด้วยอักษรตัวพิมพ์ใหญ่ทั้งหมดโดยไม่มีจุด เช่น SAME, FIPS และ ZIP value = สตริงที่มีค่าของเอลิเมนต์ <eventCode> องค์ประกอบ <eventCode> หลายรายการอาจเกิดขึ้นภายในบล็อก <info> ขอแนะนําอย่างยิ่งให้รับค่าองค์ประกอบ <eventCode> จากรายการข้อกําหนดของเหตุการณ์ OASIS หากใช้รายการคําสําหรับเหตุการณ์ OASIS ให้ใช้ OET:v1.0 เป็นชื่อค่าดังที่แสดงในตัวอย่างนี้ <eventCode> <valueName>OET:v1.0</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) เริ่มต้นสตริงนี้ด้วยคําที่สื่อความหมาย 2-3 คําที่อธิบายหลักของการแจ้งเตือน ตัวอย่างคือ "ปิดสะพานลอยน้ํา..." อย่าใช้ค่าเดียวกันสําหรับองค์ประกอบ <headline> และ <description> ให้รายละเอียดในองค์ประกอบ <description> มากกว่าในองค์ประกอบ <headline>
<description>	ต้องระบุ*	string	ค่าขององค์ประกอบ <description> คือข้อความที่อธิบายหัวเรื่องของเหตุการณ์ในข้อความแจ้งเตือน เราขอแนะนําเนื้อหาที่มนุษย์อ่านได้และมีข้อมูลซึ่งให้คําตอบสําหรับคําถามต่อไปนี้ สิ่งที่กําลังเกิดขึ้นหรือกําลังเกิดขึ้น ปัญหานี้เกิดขึ้นที่ไหน เลวร้ายแค่ไหน สําคัญ: ค่าขององค์ประกอบ <description> ต้องไม่ใช่ค่าเดียวกับขององค์ประกอบ <instruction> Google ใช้องค์ประกอบ <description> เพื่อป้อนข้อมูลในส่วนข้อความของหน้า และใช้องค์ประกอบ <instruction> เพื่อป้อนข้อมูลในส่วนการดําเนินการที่แนะนํา ช่องทั้งสองจะปรากฏต่อผู้ใช้ คุณใช้แท็ก Markdown ที่รองรับต่อไปนี้ได้ <newline>, <b> และ <a href>
<instruction>	ไม่บังคับ	string	ค่าขององค์ประกอบ <instruction> คือข้อความที่อธิบายการดําเนินการที่แนะนําต่อผู้รับข้อความแจ้งเตือน เราขอแนะนําเนื้อหาที่มนุษย์อ่านได้และให้ข้อมูล แสดงรายการการดําเนินการที่เหมาะกับระดับความรุนแรงของการแจ้งเตือนและที่ไม่ใช่ข้อมูลทั่วไป ใช้ประโยคที่สั้นกระชับและพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ รวมถึงเคล็ดลับความปลอดภัยที่ผู้อ่านดําเนินการได้ โดยให้เคล็ดลับที่สําคัญที่สุดมาก่อน องค์ประกอบ <instruction> เป็นค่าที่ไม่บังคับ แต่เราขอแนะนําให้ระบุ Google เตือนภัยสาธารณะจะใช้ช่อง <instruction> เพื่อป้อนข้อมูลในส่วนการดําเนินการที่แนะนําในหน้ารายละเอียดการแจ้งเตือน ทําให้ค่าของช่อง <instruction> และ <description> แตกต่างกันเพราะมีจุดประสงค์การใช้งานที่ต่างกัน
<web>	ต้องระบุ*	string	ลิงก์องค์ประกอบ <web> กับสําเนาของการแจ้งเตือนต้นฉบับที่เข้าถึงได้ในเว็บเซิร์ฟเวอร์ หมายเหตุ: Google จะตรวจสอบกับองค์ประกอบ <web>
<contact>	ไม่บังคับ	string	ช่อง <contact> เป็นช่องที่ไม่บังคับ แต่เราขอแนะนําให้ใช้เพราะช่องนี้ช่วยให้ผู้ใช้แสดงความคิดเห็นและตอบสนองต่อการแจ้งเตือนได้ เช่น "โทรฉุกเฉิน 911"
<parameter>	ไม่บังคับ	string	องค์ประกอบ <parameter> มีข้อมูลเฉพาะของระบบในรูปแบบต่อไปนี้ <parameter> <valueName>valueName</valueName> <value>value</value> </parameter> โดยที่: 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>