พื้นที่

เราขอแนะนําว่าเอนทิตี <area> ควรกําหนดพื้นที่ทางภูมิศาสตร์ที่จะได้รับการแจ้งเตือน ไม่ใช่พื้นที่เหตุการณ์

ในกรณีของพายุเขตร้อน เราแนะนําให้เอนทิตี <area> มีองค์ประกอบ <polygon> หรือ <geocode> ซึ่งระบุสถานที่ที่คุณคาดว่าจะมีผลกระทบจากลมแรง ฝนตกหนัก หรือภัยคุกคามอื่นๆ จากพายุ หากพายุยังคงอยู่นอกฝั่ง โปรดอย่าตั้งค่าเอนทิตี <area> ของการแจ้งเตือน CAP เป็นตําแหน่งปัจจุบันของพายุ

ในทํานองเดียวกัน ในกรณีที่เกิดไฟป่า เราขอแนะนําให้ข้อมูลเอนทิตี <area> รวมเมืองหรือสถานที่ที่คุณคาดว่าจะมีผลกระทบจากควันหรือภัยคุกคามอื่นๆ จากไฟไหม้

องค์ประกอบย่อยของเอนทิตี area

ชื่อองค์ประกอบ ตัวเลือก ประเภท CAP และบันทึกและข้อกําหนดของ Google
<areaDesc> ต้องระบุ string

Google อาจใช้องค์ประกอบ <areaDesc> เพื่อสร้างสตริงข้อความที่ใช้ในชื่อการแจ้งเตือนหรือบรรทัดแรก เขียนค่า <areaDesc> ให้สั้น (น้อยกว่า 50 อักขระ)
<polygon> ไม่บังคับ string

ค่าที่จับคู่ในองค์ประกอบ <polygon> จะกําหนดรูปหลายเหลี่ยมที่กําหนดขอบเขตพื้นที่สําหรับแจ้งเตือนในข้อความแจ้งเตือน ขอแนะนําให้แสดงองค์ประกอบ <polygon> ด้วยรายการคู่พิกัด WGS84 ที่คั่นด้วยช่องว่าง

รูปหลายเหลี่ยมต้องเป็นไปตามข้อกําหนดต่อไปนี้:

  • และต้องปิดทําการ
  • แต่ต้องไม่ซ้อนทับกัน
  • รู (เช่น ในรูปหลายเหลี่ยมทรงโดนัท) และทางแยกไม่ได้รับการสนับสนุน
  • ต้องมีคู่พิกัดอย่างน้อยสี่คู่ พิกัดคู่แรกและคู่สุดท้ายต้องเหมือนกัน
<circle> ไม่บังคับ string

องค์ประกอบ <circle> ประกอบด้วยค่าจุดและรัศมีที่จับคู่ซึ่งกําหนดพื้นที่ที่จะแจ้งเตือนในรูปแบบของข้อความแจ้งเตือน เราขอแนะนําให้คุณแทนองค์ประกอบ <circle> ด้วยจุดศูนย์กลาง นั่นคือคู่พิกัด WGS84 ตามหลังด้วยการเว้นวรรคและค่ารัศมีเป็นกิโลเมตร

หมายเหตุ: ถ้าคุณระบุวงกลมที่มีขอบเขตพื้นที่เป็นศูนย์หรือเล็กมาก Google จะไม่สามารถแสดงการแจ้งเตือนแก่ผู้ใช้ของเราได้
<geocode> ไม่บังคับ string

กําหนดองค์ประกอบ <geocode> ด้วยค่าจากชุดข้อมูลที่เข้าถึงได้และแบบเปิดของรูปหลายเหลี่ยม ตัวอย่างในสหรัฐอเมริกา ค่าเหล่านี้มาจากแหล่งข้อมูลต่อไปนี้

  • FIPS6
  • รหัส UGC
  • เหมือนกัน
  • รหัสไปรษณีย์ของสหรัฐอเมริกา

หากคุณใช้พิกัดทางภูมิศาสตร์ โปรดให้รายการแผนที่ที่มีข้อมูลพิกัดทางภูมิศาสตร์เป็นรูปหลายเหลี่ยมและรูปร่างของไฟล์คงที่แก่ Google หากต้องการโพสต์ประกาศเกี่ยวกับการอัปเดตรายการนี้ โปรดใช้ช่องแยกต่างหาก โดยควรเป็นการแจ้งเตือน RSS หรืออีเมล เช่น NOAA ของสหรัฐอเมริกาเผยแพร่การอัปเดตข้อมูลพิกัดทางภูมิศาสตร์แบบสาธารณะ
<altitude> ไม่บังคับ float

ค่าขององค์ประกอบ <altitude> คือความสูงที่เจาะจงหรือขั้นต่ําของพื้นที่ที่ได้รับผลกระทบของข้อความแจ้งเตือน ระบุหน่วยวัดนี้ในหน่วยฟุตด้านบนระดับน้ําทะเลตามมูลฐาน WGS84
<ceiling> มีเงื่อนไข float

ใช้องค์ประกอบ <ceiling> เมื่อเอนทิตี <alert> มีองค์ประกอบ <altitude> เท่านั้น ค่าขององค์ประกอบ <ceiling> คือระดับความสูงสูงสุดของพื้นที่ที่ได้รับผลกระทบของข้อความแจ้งเตือน วัดค่านี้ในหน่วยฟุต ที่สูงกว่าระดับน้ําทะเลตามมูลฐาน WGS84

ตัวอย่าง

<area>
    <areaDesc>Cavite</areaDesc>
    <polygon>14.473860833486,120.9718174024 14.347454023196,121.01386683476
     14.142014336735,121.03024107602 14.063075455227,120.85558468426
     14.221664765773,120.59001887699 14.473860833486,
     120.9718174024</polygon>
    <geocode>
        <valueName>SAME</valueName>
        <value>042100000</value>
    </geocode>
</area>

<area>
    <areaDesc>107 km SouthWest DENPASAR-BALI</areaDesc>
    <circle>-9.63,115.12 300.0</circle>
</area>