מידע

הישות <info> מציינת את פרטי ההתראה. יש צורך בחסימה אחת (<info>) לפחות של התראה. אם יש תמיכה בכמה שפות, מומלץ להשתמש בבלוק אחד של <info> לכל שפה עבור אותה ישות <alert>.

info רכיבי ישות

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

שם האלמנט אופציונליות סוג הערות ודרישות לגבי CAP ו-Google
<language> אופציונלי language

עבור ערך הקוד <language>, מומלץ להשתמש ב-RFC 3066 חוקי.

אם הרכיב <language> לא נמצא, ערך ברירת המחדל הוא en-US.
<category> חובה InfoCategory הקוד <category> מציין את הקטגוריה של האירוע של הודעת ההתראה. כדי לזהות את הקטגוריות המתאימות לאירועים, יש לעיין ברשימת התנאים של אירועי OASIS. סיווג נכון יכול לעזור ל-Google להציג את ההתראה למשתמשים בצורה מדויקת יותר.
<event> חובה string

הרכיב <event> מציין את סוג האירוע של הודעת ההתראה.

אלה הדרישות של Google לגבי הרכיב <event>:

  • האורך צריך להיות פחות מ-35 תווים.
  • יש להגדיר קבוצה של סוגי <event> מוגדרים מראש בקובץ CSV או בגיליון אלקטרוני של Google (בדוגמה זו של Google Sheets).
<responseType> אופציונלי responseType

כדי לציין את סוג הפעולה שמומלצת לקהל הנכון, כשהדבר רלוונטי, מומלץ מאוד להשתמש ברכיב <responseType> יחד עם ערך הרכיב <instruction> שאליו הוא מתייחס.
<urgency> חובה urgency

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

ל-Google חשוב לדעת איך מגדירים את השדה <urgency> ומי מגדיר אותו. עם זאת, המידע הזה לא בטווח של הפרופיל הרשמי.

העדפתו של בעל התוכן הדיגיטלי היא להגדיר את הערך <urgency> על בסיס כל מקרה לגופו ולפעול בהתאם להנחיות ברורות לטריגר. עם זאת, הרכיב <event> עשוי לתקן את הערך של <urgency>, ובכך לצמצם את הגמישות של מחברי ההתראות. לדוגמה, ההגדרה NOAA בארה"ב מגדירה את הדחיפות באופן סטטי על סמך סוג האירוע.
<severity> חובה severity

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

ל-Google חשוב לדעת איך מגדירים את השדה <severity> ומי מגדיר אותו. עם זאת, המידע הזה לא בטווח של הפרופיל הרשמי.

העדפתו של בעל התוכן הדיגיטלי היא להגדיר את הערך <severity> על בסיס כל מקרה לגופו ולפעול בהתאם להנחיות ברורות לטריגר. עם זאת, הרכיב <event> עשוי לתקן את הערך של <severity>, ובכך לצמצם את הגמישות של מחברי ההתראות. לדוגמה, ההגדרה NOAA בארה"ב מגדירה את הדחיפות באופן סטטי על סמך סוג האירוע.
<certainty> חובה certainty

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

ל-Google חשוב לדעת איך מוגדר השדה <certainty> ומי משתמש בו. עם זאת, המידע הזה לא נכלל בהיקף הפרופיל הרשמי.

העדפתו של בעל התוכן הדיגיטלי היא להגדיר את הערך <certainty> על בסיס כל מקרה לגופו ולפעול בהתאם להנחיות ברורות לטריגר. עם זאת, הרכיב <event> עשוי לתקן את הערך של <certainty>, ובכך לצמצם את הגמישות של מחברי ההתראות. לדוגמה, ההגדרה NOAA בארה"ב מגדירה את הדחיפות באופן סטטי על סמך סוג האירוע.
<audience> אופציונלי string הערך של הרכיב <audience> הוא טקסט שמתאר את הקהל של הודעת ההתראה.
<eventCode> אופציונלי string

הרכיב <eventCode> מכיל קוד ספציפי למערכת שמזהה את סוג האירוע של הודעת ההתראה בטופס הבא.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

כאשר:

  • valueName = מחרוזת שהוקצה על ידי המשתמש ומגדירה את הדומיין של הקוד. אם המחרוזות האלה הן ראשי תיבות, יש לייצג אותן באותיות רישיות בלבד ללא נקודות. לדוגמה: SAME, FIPS ו-ZIP.
  • value = מחרוזת שמציינת את הערך של הרכיב <eventCode>.

מופעים מרובים של רכיבי <eventCode> יכולים להתרחש בבלוק <info>.

מומלץ מאוד לקבל את ערכי <eventCode> מרשימת התנאים של אירועי OASIS. אם אתם משתמשים ברשימת האירועים של OASIS, צריך להשתמש ב-OET:v1.0 כשם הערך כפי שמוצג בדוגמה הבאה:

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> אופציונלי dateTime

הערך של הרכיב <effective> הוא הזמן בפועל של המידע בהודעת ההתראה.

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

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

דוגמה:

2002-05-24T16:49:00-07:00 מייצג את 24 במאי 2002 ב-16:49 (שעון החוף המערבי).
<onset> אופציונלי dateTime

הערך של הרכיב <onset> הוא הזמן הצפוי שבו מתחיל אירוע הנושא של הודעת ההתראה. צריך לכלול את השדות של אזור הזמן בכל הערכים של dateTime.

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

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

דוגמה:

2002-05-24T16:49:00-07:00 מייצג את 24 במאי 2002 ב-16:49 (שעון החוף המערבי).
<expires>

חובה*

 dateTime

הערך של הרכיב <expires> הוא זמן התפוגה של אירוע הנושא של הודעת ההתראה. רכיב <expires> חייב לבוא אחרי אלמנט <effective> לפי סדר זמן.

אם לא ניתן להגדיר זמן תפוגה לכל ההתראות, יש לספק ל-Google זמן תפוגה כברירת מחדל לכל ההתראות שלא כוללות רכיב <expires>. לדוגמה, אפשר לקבוע שכברירת מחדל, כל ההתראות מוגדרות לפוג אחרי 48 שעות אם אין רכיב <expires>.

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

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

דוגמה:

2002-05-24T16:49:00-07:00 מייצג את 24 במאי 2002 ב-16:49 (שעון החוף המערבי).
<senderName> אופציונלי string

האלמנט <senderName> הוא אופציונלי, אבל מומלץ מאוד.

כאשר לשולח יש שם קריא (לבני אדם), הקישור <web> יכול להופיע באופן ידידותי למשתמש, בהתאם להעדפות של בעל התוכן הדיגיטלי או של השולח. בנוסף, הרכיב <senderName> מאפשר לצבירת התראות ממספר רשויות לפרסם.
<headline> אופציונלי string

צריך לוודא שאורך מחרוזות הרכיב של <headline> יהיה קצר מ-140 תווים.

מחרוזת <headline> יכולה להיות טקסט פתוח, אבל מומלץ לכלול פחות מ-140 תווים. (גרסה 1.2 מציעה פחות מ-160 להודעות טקסט.) כדאי להתחיל את המחרוזת הזו בכמה מילות תיאור שמסבירות את ליבת ההתראה. לדוגמה: "גשר גשר סגור...."

אין להשתמש באותם ערכים עבור הרכיבים <headline> ו-<description>. יש לספק פרטים נוספים ברכיב <description> מאשר ברכיב <headline>.
<description>

חובה*

 string

הערך של הרכיב <description> הוא טקסט שמתאר את נושא האירוע של הודעת ההתראה.

אנחנו ממליצים על תוכן קריא ואינפורמטיבי שעונה על השאלות הבאות:

  • מה צפוי לקרות או עומד לקרות?
  • איפה זה קורה?
  • עד כמה היא גרועה?

Google משתמשת ברכיב <description> כדי לאכלס את הקטע הודעה בדף, ומשתמשת ברכיב <instruction> כדי לאכלס את הקטע פעולות מומלצות. שני השדות מוצגים למשתמשים.

ניתן להשתמש בתגי Markdown הנתמכים הבאים: <newline>, <b> ו- <a href>.
<instruction> אופציונלי string

הערך של הרכיב <instruction> הוא טקסט שמתאר את הפעולות המומלצות לנמענים של הודעת ההתראה. אנחנו ממליצים על תוכן אינפורמטיבי וקריא למשתמשים.

מומלץ לרשום פעולות שמתאימות לרמת החומרה של ההתראה ואין להן רמת גישה כללית. חשוב להשתמש במשפטים קצרים ותמציתיים, שכוללים טיפים שיעזרו לקוראים לפעול בהתאם לטיפ.

הרכיב <instruction> הוא אופציונלי, אבל מומלץ מאוד להשתמש בו. התכונה 'התראות ציבוריות של Google' משתמשת בשדה <instruction> כדי לאכלס את הקטע פעולות מומלצות בדפי פרטי ההתראות. הערכים בשדה <instruction> ובשדה <description> שונים, כי הם משמשים למטרות שונות.
<web>

חובה*

 string

יש לקשר את הרכיב <web> לעותק של ההתראה המקורית שנגישה בשרת האינטרנט.
<contact> אופציונלי string

השדה <contact> הוא אופציונלי, אבל מומלץ מאוד להציג אותו כי הוא מאפשר למשתמשים לספק משוב ולהגיב על ההתראה. לדוגמה, "למקרי חירום, יש להתקשר למוקד חירום".
<parameter> אופציונלי string

הרכיב <parameter> מכיל נתונים ספציפיים למערכת באופן הבא:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

כאשר:

valueName = מחרוזת שהוקצה על ידי המשתמש ומגדירה את הדומיין של הקוד.

value = ערך מחרוזת.

מופעים מרובים של רכיב <parameter> יכולים להתרחש בתוך בלוק <info>.
<resource> אופציונלי resource

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

חובה*

 area

הרכיב <area> מכיל מידע על האזור ההתרעה של האירוע, ולא את אזור האירוע. בלוקים של <area> חייבים לכלול לפחות רכיב אחד של <circle>, <polygon> או <geocode>.

מומלץ מאוד להשתמש ברכיב <polygon> או ב-<circle> במקום ברכיב <geocode>.

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

דוגמה

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>