התראה

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

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

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

מאפיינים

טבלה 1 מתארת את ערך המאפיין עבור הישות <alert>:

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

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

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

דוגמה:

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

Elements

טבלה 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>.
  • הרכיב UPDATE או הרכיב CANCEL <msgType> חייבים לחול על התראה שהתוקף שלה לא פג. לכן, צריך להתייחס לכל ההודעות הקשורות והתראות שהתוקף שלהן לא פג כשמנפיקים הודעות UPDATE או CANCEL <msgType>.

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

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

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

אם ההתראה מכילה אחד מערכי הרכיב הבאים, יש לציין את הרכיב <note>:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> משפטי 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>