מידע

הישות <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 Sheets (ראו דוגמה ל-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.2 בתור שם הערך, כפי שמתואר בדוגמה הבאה:

        <eventCode>
          <valueName>OET:v1.2</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 תווים. (ב-CAP 1.2 מומלץ להשתמש בפחות מ-160 תווים להודעות טקסט). מתחילים את המחרוזת הזו בכמה מילים מתארות שמסבירות את הליבה של ההתראה. דוגמה: "Pontoon bridge closure...."

אין להשתמש בערכים זהים לאלמנטים <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> לכתובת URL תקינה שמספקת מידע נוסף על ההתראה.
<contact> אופציונלי string

השדה <contact> הוא אופציונלי, אבל מומלץ מאוד להוסיף אותו כי הוא מאפשר למשתמשים לשלוח משוב ולהגיב להתראה. לדוגמה, "במקרה חירום, חייגו 100".
<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>