אזור

מומלץ מאוד שהישות <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
  • קוד UGC
  • SAME
  • מיקוד בארה"ב

אם אתם משתמשים בקודים גיאוגרפיים, עליכם לספק ל-Google רשימה קבועה של מפות shapefile ומפות של קוד גיאוגרפי לפוליגון. כדי לפרסם הודעות על עדכונים ברשימה הזו, צריך להשתמש בערוץ נפרד, רצוי התראות RSS או אימייל. לדוגמה, עדכוני הגיאוקוד של NOAA בארה"ב מתפרסמים באופן ציבורי.

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