المساحة

ننصح بشدة بأن يحدِّد كيان <area> المنطقة الجغرافية التي سيتم إعلامها، وليس منطقة الحادثة.

في حال حدوث عاصفة استوائية، ننصحك بأن يحتوي العنصر <area> على عنصرَي <polygon> أو <geocode> للإشارة إلى الأماكن التي تتوقّع فيها حدوث تأثيرات من الرياح القوية أو الأمطار الغزيرة أو أي تهديدات أخرى من العاصفة. إذا كانت العاصفة لا تزال قبالة الساحل، يجب عدم ضبط <area> لكيان تنبيه CAP على الموقع الجغرافي الحالي للعاصفة.

وبالمثل، في حال اندلاع حريق في الغابة، ننصحك بأن تتضمّن بيانات <area> أيضًا المدن أو الأماكن التي تتوقّع فيها حدوث تأثيرات من الدخان أو غيرها من التهديدات الناتجة عن الحريق.

عناصر area الفرعية للكيان

اسم العنصر الخيار النوع ملاحظات ومتطلّبات CAP وGoogle
<areaDesc> مطلوب string

لإنشاء سلسلة نص الموقع الجغرافي المستخدَمة في عنوان التنبيه أو العنوان الرئيسي، قد تستخدم Google عنصر <areaDesc>. اختصر قيمة <areaDesc> (أقل من 50 حرفًا).

<polygon> اختياري string

تحدِّد نقاط القيمة المقترنة في عنصر <polygon> مضلّعًا يحدّد المنطقة التي سيتم تنبيهك بشأنها في رسالة تنبيه. ننصحك بتمثيل العنصر <polygon> بقائمة مفصولة بمسافات من أزواج إحداثيات WGS84.

يجب أن تستوفي المضلّعات المتطلبات التالية:

  • يجب أن تكون مغلقة.
  • لا يمكن أن تتداخل الخطط مع بعضها.
  • لا يمكن استخدام الفتحات (مثل المضلّعات على شكل دونات) والتقاطعات.
  • يجب إدخال أربعة أزواج من الإحداثيات على الأقل. يجب أن يكون أول زوج من الإحداثيات وآخرهما متطابقَين.
<circle> اختياري string

يتكوّن عنصر <circle> من قيم paired نقطة ونصف قطر تحدّد المنطقة التي سيتم التحذير منها في شكل رسالة تنبيه. ننصح بتمثيل عنصر <circle> بنقطة مركزية: زوج إحداثيات WGS84 متبوعًا بحرف مسافة وقيمة نصف القطر بالكيلومترات.

ملاحظة: إذا حدّدت دائرة بنصف قطر صفري أو نصف قطر صغير جدًا، لن تتمكّن Google من عرض التنبيه للمستخدمين.

<geocode> اختياري string

حدِّد عنصر <geocode> باستخدام قيم من مجموعة بيانات مفتوحة وقابلة للوصول إليها من المضلّعات. على سبيل المثال، في الولايات المتحدة، تأتي هذه القيم من مصادر البيانات التالية:

  • FIPS6
  • رمز المحتوى من إنشاء المستخدمين
  • SAME
  • الرمز البريدي في الولايات المتحدة

إذا كنت تستخدِم ترميزات المواقع الجغرافية، عليك تزويد Google بقائمة ثابتة من تعيينات ترميزات المواقع الجغرافية إلى المضلّعات وملفات Shapefile. لنشر إشعارات بشأن التعديلات على هذه القائمة، استخدِم قناة منفصلة، ويُفضّل أن تكون من خلال تنبيهات RSS أو البريد الإلكتروني. على سبيل المثال، تنشر إدارة المحيطات والغلاف الجوي الأمريكية علنيًا تعديلات الرموز الجغرافية.

<altitude> اختياري float

قيمة عنصر <altitude> هي الحد الأدنى أو الحد الأقصى للارتفاع في المنطقة المتأثرة برسالة التنبيه. قدِّم هذا القياس بالأقدام فوق متوسط مستوى سطح البحر وفقًا لنظام مرجع WGS84.

<ceiling> CONDITIONAL 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>