יצירת התראות בפורמט CAP

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

יש 2 דרכים ליצור התראות:

  1. יצירה אוטומטית: מגדירים את המערכת כך שתתבצע פורמטציה דינמית של פרטי מסד הנתונים לפי פיד CAP, והיא תישלח אוטומטית אל Google.
  2. יצירה ידנית: יוצרים את תוכן ההתראות ומגישים אותו באופן ידני לפי הצורך באמצעות אפליקציה מבוססת-אינטרנט.

יצירה אוטומטית

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

צוות Google יכול לספק תמיכה במהלך ההטמעה. אפשר לפנות לצוות Google או לשלוח אימייל לכתובת google-public-alerts@google.com.

יצירה ידנית

  1. עובדים עם צוות ה-IT כדי להתקין את אפליקציית האינטרנט בקוד פתוח של CAPCreator™ בשרת אינטרנט. לחלופין, אפשר ליצור אפליקציית אינטרנט משלכם.
  2. כשאירועים מתרחשים, נכנסים לכתובת ה-URL של האפליקציה ומשתמשים בממשק כדי ליצור התראות בפורמט CAP.
  3. האפליקציה מפרסמת פיד במיקום באינטרנט, ואז Google שולפת את המידע הזה מהפיד שפורסם.

רכיבי התראות

המבנה של התראה

ההתראה צריכה לענות על השאלות הבאות:

  1. מה קורה?
  2. מתי זה יקרה?
  3. מה אנשים צריכים לעשות?
  4. לאן נשלחות ההתראות?

דוגמה פשוטה להתראה:

    <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</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>
            <instruction>
                Do not 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>

מומלץ לעיין בדוגמאות להתראות CAP כדי לקבל דוגמאות מפורטות יותר להתראות שפועלות ועשויות להיות דומות להתראות שלכם.

אירוע

מחרוזת ה-CAP <event> (או לפעמים <headline>) מופיעה בכותרת ההתראות שלנו. השמות צריכים להיות קצרים (פחות מ-35 תווים) ותיאוריים מספיק כדי שהציבור יוכל להבין אותם. דרישות מפורטות יותר מפורטות בקטע רכיבים ורכיבי משנה של <info> במדריך העזרה.

תאריכי

שדות של אזורי זמן חייבים להיכלל בכל ערכי התאריך/השעה (כמו <effective>,‏ <expires> ו-<onset>). אם המיקום שצוין בבלוק <area> נמצא באזור זמן אחד, השדה <effective> צריך לציין את השעה באזור הזה, כולל התאמה לשעון קיץ במקרים הרלוונטיים. כשתוכן ההודעה רלוונטי למספר אזורי זמן, היוצר של ההודעה צריך להשתמש בשעון UTC במקום בשעון המקומי.

הוראות ל-

השדה <instruction> של התראת ה-CAP מופיע בדפי הפרטים של ההתראות בתור 'הפעולה המומלצת'. חשוב לזכור שהתוכן של האלמנט הזה לא צריך להיות זהה לתוכן של <description>, שמתאים יותר לסיכום של אופי ההתראה, עוצמתה והאזור המושפע.

אזור ההתראות של

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

ציון אזורים כמצולעים

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

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

אם אתם משתמשים בפוליגונים, מומלץ לכלול לא יותר מ-5-6 ספרות עשרוניות של דיוק בקואורדינטות ה-lat/long. (הדבר מאפשר לקבל רזולוציה גבוהה יותר מזו שרוב מערכות ההתראות יכולות לטרגט). בנוסף, חשוב לוודא שהפוליגונים תקינים. לדוגמה, אסור שהם יכילו קצוות מצטלבים.

ציון אזורים כקואורדינטות

אם אתם חייבים לציין את <area> ככתובת גיאוגרפית או כקבוצה של כמה כתובות גיאוגרפיות, השתמשו בכתובות גיאוגרפיות ברמת הפירוט הגבוהה ביותר האפשרית, והוסיפו את השמות של הערים, היישובים וכו' הספציפיים שצפויים להיות מושפעים, ברכיב <description>. תצטרכו לשתף את קובצי ה-shapefile הבסיסיים בפורמט של shapefile.

תמיכה בכמה שפות

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

לפרטים נוספים ולדוגמה להתראה בכמה שפות, ראו דוגמה לכמה שפות.

אימות התראות CAP

מומלץ להשתמש בכלי CAP Validator של Google בקוד פתוח כדי לאמת את ההתראות של CAP. אפשר גם להירשם לקבלת התראות באימייל על שגיאות באמצעות הכלי הזה. המאמת מציע כמה אפשרויות ואיורים לאימות CAP:

צילום מסך של כלי התיקוף

בוחרים באפשרות Google Public Alerts CAP v1.0 כדי לבצע אימות בהתאם לדרישות הספציפיות של Google לפידים מסוג CAP.

כדי להירשם לקבלת התראות באימייל על שגיאות, לוחצים על Subscribe to feed validation results (הרשמה לקבלת תוצאות של אימות פיד) או עוברים לכתובת http://cap-validator.appspot.com/subscribe. צריך לספק את כתובת ה-URL של הפיד ואת כתובת האימייל, לבחור באפשרות Google Public Alerts CAP v1.0 ולחזור על Subscribe. תקבלו התראה כשהמערכת תזהה בעיות בפיד ה-CAP.

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

השלב הבא: שולחים ל-Google את הפיד של ההתראות