אזור

אנחנו ממליצים מאוד לישות <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
  • קוד תוכן שנוצר על ידי המשתמש
  • אותו אדם
  • מיקוד בארה"ב

אם משתמשים בקואורדינטות גיאוגרפיות, יש לספק ל-Google רשימה קבועה של מפות קואורדינטות פוליגוניות של קידוד פוליגון. כדי לפרסם הודעות על עדכונים לרשימה זו, יש להשתמש בערוץ נפרד, עדיף כהתראות RSS או אימייל. לדוגמה, US 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>