התראה

כדי להגדיר מידע בסיסי על אירוע נוכחי, משתמשים בישות <alert>.

אם אירוע נמצא ביותר ממיקום אחד בו-זמנית, עדיף לפצל את האירוע למספר אובייקטים מסוג alert. לדוגמה, אם יש שריפה ביערות שמתרחשת בכמה מדינות, אפשר לפצל את ההתראות לכמה התראות, אחת לכל מדינה. כך תוכלו לספק מידע חירום ספציפי לכל מדינה, ולעדכן את מצב השריפה בצורה מדויקת יותר.

אם אירוע משתנה במהירות, כמו הוריקן שנע ממזרח למערב, מומלץ לעדכן את ההתראה מדי פעם. לא מסירים את ההתראה הקיימת מהפיד. במקום זאת, יש להנפיק התראה חדשה שמפנה להתראה הקודמת.

מאפיינים

בטבלה 1 מתוארים ערכי המאפיינים של הישות <alert>:

טבלה 1. מאפיין ישות <alert>

שם האלמנט אופציונליות סוג תיאור
xmlns:cap חובה string

המאפיין xmlns חייב להפנות ל-CAP URN בתור מרחב השמות.

דוגמה:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

רכיבים

בטבלה 2 מתוארים הערכים של רכיבי המשנה של הישות <alert>:

טבלה 2. <alert> רכיבי ישות

שם האלמנט אופציונליות סוג הערות ודרישות של CAP ושל Google
<identifier> חובה string יש לציין את המזהה של ההתראה שמייצגת את האירוע. הערך של הרכיב <identifier> צריך להיות ייחודי בכל האירועים.
<sender> חובה string הרכיב <sender> מזהה את מקור ההתראה. הוא לא יכול לכלול רווחים, פסיקים או תווים מוגבלים.
<sent> חובה dateTime

אם המיקום שצוין בבלוק <area> נמצא באזור זמן אחד, צריך להשתמש ברכיב <sent> כדי לציין את השעה באזור הזה. אם רלוונטי, יש לכלול התאמה לשעון קיץ.

כשתוכן ההודעה רלוונטי למספר אזורי זמן, עדיף להשתמש בשעון UTC במקום בשעון המקומי.
<status> חובה AlertStatus

Google מפרסמת רק התראות שזמינות לכולם, עם ערך של Actual ברכיב <status>.
<msgType> חובה AlertMsgType

רכיב UPDATE או CANCEL <msgType> חייב לכלול לפחות רכיב אחד <references>. תקן ה-CAP מפרט את הפרטים הבאים:

  • כל הודעת התראה שמעדכנת התראה קודמת משתמשת ב-UPDATE ומגדירה את ערכי הרכיב <references> לכל ההודעות הקודמות שעדיין לא הגיעו לתאריך <expires>.
  • הרכיב <msgType> של UPDATE או CANCEL חייב לחול על התראה שעדיין בתוקף. לכן, כשמתקבלת הודעה מסוג UPDATE או CANCEL <msgType>, צריך לציין בה את כל ההודעות הקשורות וההתראות שעדיין בתוקף.

מידע נוסף זמין במאמר שינוי או תפוגה של אירועים.
<source> אופציונלי string הרכיב <source> מציין את המקור הספציפי של ההתראה. דוגמה לכך היא מפעיל או מכשיר ספציפי.
<scope> חובה AlertScope

האלמנט <scope> מציין את ההפצה המיועדת של הודעת ההתראה.
<restriction> CONDITIONAL string אם הערך של הרכיב <scope> הוא Restricted, צריך להוסיף את הרכיב <restriction>. הרכיב הזה מתאר את הכלל להגבלת ההפצה של הודעת ההתראה המוגבלת.
<addresses> CONDITIONAL string אם הערך של רכיב <scope> הוא Private, צריך להוסיף את הרכיב <addresses>. כאן מופיע הנמען המיועד של הודעת ההתראה. אפשר לכלול כמה כתובות שמופרדות ברווחים, אבל צריך לתחום במירכאות כפולות כתובות שכוללות רווחים לבנים.
<code> אופציונלי string

האלמנט <code> מציין טיפול מיוחד בהודעת ההתראה.
<note> CONDITIONAL string

אם ההתראה מכילה את אחד מהערכים הבאים של האלמנט, צריך להוסיף את האלמנט <note>:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CONDITIONAL string

אם הערך של רכיב <msgType> הוא UPDATE או CANCEL, צריך להוסיף את רכיב <references>.

כשהמערכת מפרסמת מחדש תוכן CAP של בעל תוכן דיגיטלי אחר, צריך לכלול את ההתראה המלאה של CAP. כדי לקשר תוכן ערוך למקור המקורי, צריך להשתמש בתג <references>.

אם רוצים להפנות לכמה הודעות, צריך להשתמש במרווחים כמפריד.
<incidents> אופציונלי string הרכיב <incidents> אוסף כמה הודעות שקשורות לאותו אירוע, אבל מתייחסות ליבטים שונים שלו.
<info>

חובה*

 info צריך לכלול לפחות רכיב אחד של <info>. לכל הבלוקים של <info> צריכים להיות אותם ערכים של הרכיבים <category> ו-<event>.

* Google דורשת רכיבים עם האפשרות חובה בכתב מודגש ואדום, אבל הרכיבים האלה הם אופציונליים בתקן CAP.

דוגמה

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>