المساحة

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

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

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

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

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

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

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

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

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

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

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

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

  • FIPS6
  • رمز المحتوى الذي ينشئه المستخدمون
  • مماثلة
  • الرمز البريدي في الولايات المتحدة

إذا كنت تستخدم الرموز الجغرافية، قدِّم إلى 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>