พื้นที่

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

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

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

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

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

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

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

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

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

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

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

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

  • FIPS6
  • รหัสเนื้อหาที่ผู้ใช้สร้างขึ้น
  • SAME
  • รหัสไปรษณีย์ของสหรัฐอเมริกา

หากคุณใช้รหัสพิกัดภูมิศาสตร์ ให้ระบุรายการแผนที่ที่แปลงรหัสพิกัดภูมิศาสตร์เป็นรูปหลายเหลี่ยมและ Shapefile ให้กับ 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>