حوزه

ما قویاً توصیه می‌کنیم که نهاد <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 به دنبال یک کاراکتر فاصله و یک مقدار شعاع بر حسب کیلومتر.

توجه: اگر دایره ای با شعاع صفر یا بسیار کوچک مشخص کنید، گوگل نمی تواند هشدار را به کاربران ما نشان دهد.

<geocode> اختیاری string

عنصر <geocode> را با مقادیر یک مجموعه داده قابل دسترسی و باز از چند ضلعی ها تعریف کنید. به عنوان مثال، در ایالات متحده، این مقادیر از منابع داده زیر آمده است:

  • FIPS 6
  • کد UGC
  • یکسان
  • کد پستی آمریکا

اگر از ژئوکدها استفاده می‌کنید، فهرست ثابتی از نقشه‌های geocode-to-polygon و 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>