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

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

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

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

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

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

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

יצירה ידנית

  1. עבוד עם צוות ה-IT שלך כדי להתקין בשרת האינטרנט את אפליקציית האינטרנט בקוד פתוח TMCreator. לחלופין, אתם יכולים ליצור אפליקציית אינטרנט משלכם.
  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 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>
            <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 <event> (או לפעמים ה-<headline>) מופיעה בכותרת של ההתראות. התוספים האלה צריכים להיות קצרים (פחות מ-35 תווים) ותיאור שמספיק לציבור כדי להבין אותם. תוכלו למצוא דרישות מפורטות יותר במאמר <info> אלמנטים ורכיבי משנה במדריך העזר.

תאריכים

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

הוראות

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

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

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

ציון אזורים כפוליגונים

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

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

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

ציון אזורים כאזורים גיאוגרפיים

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

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

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

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

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

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

צילום מסך של מאמת

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

כדי להירשם לקבלת הודעות שגיאה באימייל, לוחצים על הרשמה לתוצאות האימות של הפיד או נכנסים לכתובת http://cap-validator.appspot.com/Subscribe. עליכם לספק את כתובת ה-URL של הפיד ואת כתובת האימייל שלו, לבחור באפשרות Google Public Alerts CAP v1.0 וללחוץ על הרשמה. תקבלו הודעה כשתמצאו בעיות בפיד של CAP.

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

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