קבלת התרעות על מזג האוויר

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

נקודת הקצה מחזירה התראות על מזג אוויר בזמן אמת בקו רוחב ובקו אורך נתונים. אירועי מזג האוויר הנתמכים כוללים:

  • משקעים: גשם, שלג, ברד, בצורת ועוד
  • טמפרטורות קיצוניות: קור, חום, קיפאון, כפור, טמפרטורה מורגשת ולחות
  • אירועי רוח וסערה: סופות שלגים, הוריקנים, טורנדו, סופות טרופיות, סופות רעמים ועוד
  • הפרעות בראות: ערפל, סופות אבק ומשבי שלגים
  • סכנות שקשורות למים: שיטפונות, צונאמי, נחשולי סערה, סכנות באזורי חוף ועוד
  • אירועים גיאופיזיים וגיאולוגיים: רעידות אדמה, מפולות ופעילות וולקנית
  • אירועי שריפה: שריפות בשטח פתוח, מזג אוויר שעלול לגרום לשריפות ועוד

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

ההתראות עשויות לכלול תיאורים מקומיים, בהתאם למה שזמין במקור הנתונים. בגלל מגבלות של מקור הנתונים, המידע מוצג כמו שהוא (תוכן גולמי). מידע נוסף על מקורות של התרעות מזג אוויר זמין בקטע מקורות נתונים.

ה-API מחזיר את המידע הבא לגבי התראת מזג אוויר נתונה:

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

בעזרת APIs Explorer אתם יכולים לשלוח בקשות בזמן אמת כדי להכיר את ה-API ואת האפשרויות שלו:

מידע על בקשות לקבלת התרעות על מזג האוויר

כדי לבקש מידע על התראות מזג אוויר, שולחים בקשת GET של HTTP אל:

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

צריך לכלול את הקואורדינטות של קו הרוחב וקו האורך של המיקום בפרמטרים של כתובת ה-URL בבקשה.

מידע על התגובות להתראות מזג אוויר

ה-Weather API מחזיר את השדות הבאים בגוף התשובה:

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

הערה: זו המחרוזת היחידה שמתורגמת כשפרמטר של קוד שפה נכלל בבקשה.
חובה
eventType טיפוסים בני מנייה (enum) סוג אירוע מזג האוויר שמשויך להתראה.

רשימה מלאה של אירועי מזג האוויר הנתמכים מופיעה בקטע סוגי אירועי מזג אוויר.
חובה
areaName מחרוזת שם האזור הגיאוגרפי שמושפע מההתראה, כולל המיקום המבוקש. חובה
polygon מחרוזת קואורדינטות שמגדירות אזור סגור של ההתראה. אופציונלי
description מחרוזת ביטוי קצר שמסכם את תיאור האירוע בשפה שצוינה (לדוגמה, "אזהרת טורנדו"). אופציונלי
severity טיפוסים בני מנייה (enum) רמת החומרה של ההתראה:
  • קיצוני: סכנה חריגה לנפש או לרכוש
  • חמורה: סכנה משמעותית לנפש או לרכוש
  • בינונית: סכנה אפשרית לנפש או לרכוש
  • מינורית: סכנה מינימלית או לא ידועה לנפש או לרכוש
  • לא ידוע: חומרת הבעיה לא ידועה
אופציונלי
certainty טיפוסים בני מנייה (enum) רמת הסבירות של ההתראה:
  • נצפה: נקבע שהאירוע התרחש או שהוא עדיין מתרחש
  • סבירות גבוהה מאוד: סבירות גבוהה מאוד שהאירוע התרחש או שהוא עדיין מתרחש
  • סביר: סביר (p > ~50%) שהאירוע התרחש או שהוא נמשך
  • אפשרי: אפשרי אבל לא סביר שקרה או שקורה כרגע (p <= ~50%)
  • לא סביר: לא צפוי להתרחש (p ~ 0)
  • לא ידוע: רמת ודאות לא ידועה
אופציונלי
urgency טיפוסים בני מנייה (enum) רמת הדחיפות של ההתראה:
  • מיידי: צריך לבצע פעולה מיידית בתגובה.
  • התגובה הצפויה: צריך לבצע פעולה בקרוב (במהלך השעה הקרובה)
  • בעתיד: צריך לבצע פעולה בעתיד הקרוב
  • בעבר: לא נדרשת יותר פעולה בתגובה
  • לא ידוע: רמת הדחיפות לא ידועה
אופציונלי
instruction מחרוזת תיאור של הוראות לפעולות תגובה לקהל היעד. אופציונלי
safetyRecommendations מחרוזת המלצות בטיחות שמבוססות על קודים של רשויות ציבוריות. כולל הנחיות ברמה העליונה וטקסט משני עם מידע נוסף. אופציונלי
timezoneOffset מחרוזת ההפרש בין אזור הזמן של האירוע לבין שעון UTC, בפורמט ‎+/-HH:MM. חובה
startTime DateTime התאריך והשעה בפועל (לפי שעון UTC) של המידע בהודעת ההתראה. אופציונלי
expirationTime DateTime התאריך והשעה של Epoch (זמן UTC) שבהם ההתראה צפויה להסתיים. הערך יכול להיות null באירועים ארוכים ללא הגבלת זמן, ובמקרה כזה הכותרת תציין שהאירוע "בתוקף". אופציונלי
dataSource טיפוסים בני מנייה (enum) פרטי הרשות, כולל המוציא לאור, השם וכתובת ה-URL. חובה
regionCode טיפוסים בני מנייה (enum) קוד האזור של המיקום שביקשתם. אופציונלי

מקורות נתונים

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

הספקים שנכללים בפיד פועלים לפי ההנחיות של Google Public Alerts. ‫Google עשויה לעדכן את רשימת הספקים בכל שלב.

מדינה סוכנות שפות נתמכות
אוסטרליה ACT Emergency Services Agency‏ (ACT ESA) en-US
New South Wales Rural Fire Service‏ (NSW RFS) en-AU
‫South Australian Country Fire Service‏ (שירות כיבוי האש הכפרי של דרום אוסטרליה, SA CFS) en-AU
‫Tasmania Fire Service‏ (שירותי האש של טסמניה, TFS) en-US
Queensland Fire and Emergency Services‏ (QFES) en-AU
אוסטריה ‫GeoSphere Austria דרך MeteoAlarm de-DE, en-GB
בלגיה ‫Royal Meteorological Institute of Belgium (המכון המטאורולוגי המלכותי של בלגיה) דרך MeteoAlarm en-GB,‏ fr-BE,‏ nl-BE
בוסניה והרצגובינה ‫Federal Hydro-meteorological Institute (המכון ההידרו-מטאורולוגי הפדרלי, FHMZ) דרך MeteoAlarm bs
בולגריה ‫National Institute of Meteorology & Hydrology (המכון הלאומי למטאורולוגיה והידרולוגיה) דרך MeteoAlarm bg, en-GB
ברזיל Centro Nacional de Gerenciamento de Riscos e Desastres‏ (CENAD) pt-BR
Instituto Nacional de Meteorologia‏ (INMET) pt-BR
קולומביה Unidad Nacional para la Gestión del Riesgo de Desastres‏ (UNGRD) es
חוף השנהב ‫Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique (החברה לתפעול ופיתוח נמלי תעופה, תעופה ומטאורולוגיה) fr
קרואטיה ‫Croatian Meteorological and Hydrological Service (השירות המטאורולוגי וההידרולוגי של קרואטיה) דרך MeteoAlarm hr-HR, en-GB
קפריסין ‫Department of Meteorology (המחלקה לנושאי מטאורולוגיה) דרך MeteoAlarm el-GR, en-GB
צ'כיה ‫Czech Hydrometeorological Institute (המכון ההידרומטאורולוגי של צ'כיה) דרך MeteoAlarm en-GB, cs
דנמרק ‫Danish Meteorological Institute (המכון המטאורולוגי של דנמרק) דרך MeteoAlarm en-GB, da-DK
אקוודור Instituto Nacional de Meteorología e Hidrología es
אסטוניה ‫Ministry of Climate (המשרד לנושאי אקלים) דרך MeteoAlarm et-EE
פינלנד ‫Finnish Meteorological Institute (המכון המטאורולוגי של פינלנד) דרך MeteoAlarm fi-FI,‏ sv-SE,‏ en-GB
צרפת ‫Météo-France דרך MeteoAlarm en-GB, fr-FR
גרמניה ‫DWD – שירות מזג האוויר של גרמניה de-DE
גאנה Agence Nationale de la Météorologie (השירות המטאורולוגי של צ'אד) fr
יוון ‫Hellenic National Meteorological Service (השירות המטאורולוגי הלאומי ההלני) דרך MeteoAlarm en-GB, el-GR
הונגריה ‫HungaroMet Nonprofit Zrt דרך MeteoAlarm en-GB, hu-HU
איסלנד ‫Icelandic Meteorological Office (המשרד המטאורולוגי של איסלנד) דרך MeteoAlarm en-GB, is-IS
אירלנד ‫Met Eirann דרך MeteoAlarm en-GB
איטליה ‫Italian Meteorological Service (השירות המטאורולוגי האיטלקי) דרך MeteoAlarm it-IT, en-GB
ג'מייקה ‫Meteorological Service of Jamaica (השירות המטאורולוגי של ג'מייקה) en-JM
יפן ‫Japan Meteorological Agency‏ (השירות המטאורולוגי של יפן, JMA) ja
לטביה ‫Latvian Environment, Geology and Meteorology Centre (המרכז לסביבה, גיאולוגיה ומטאורולוגיה של לטביה) דרך MeteoAlarm en-GB, lv
ליטא ‫Lithuanian Hydrometeorological Service (השירות ההידרו-מטאורולוגי של ליטא) דרך MeteoAlarm en-GB, lt-LT
לוקסמבורג ‫MeteoLux דרך MeteoAlarm fr-FR,‏ de-DE,‏ en-GB
מדגסקר Météo Madagascar en, fr
מקסיקו Centro de Instrumentación y Registro Sísmico A.C.‏ (CIRES) es-MX
הולנד ‫Royal Netherlands Meteorological Institute (המכון המטאורולוגי המלכותי של הולנד) דרך MeteoAlarm nl-NL, en-GB
מקדוניה הצפונית ‫National Hydrometeorological Service (השירות ההידרו-מטאורולוגי הלאומי) דרך MeteoAlarm en-GB
נורווגיה ‫Norwegian Meteorological Institute (המכון המטאורולוגי של נורווגיה) דרך MeteoAlarm en-GB, no
ניו זילנד ‫GNS Science‏ (המכון למדעי הגיאולוגיה והגרעין, GeoNet) en-NZ
MetService en-US
הפיליפינים ‫Philippine Atmospheric, Geophysical & Astronomical Services Administration‏ (מנהל השירותים בנושאי אטמוספרה, גאופיזיקה ואסטרונומיה של הפיליפינים, PAGASA) en-US
פולין ‫Institute of Meteorology and Water Management (המכון למטאורולוגיה ולניהול משק המים) דרך MeteoAlarm pl-PL, en-GB
פורטוגל ‫Portuguese Institute for Sea and Atmosphere (המכון הפורטוגזי לים ולאטמוספירה) דרך MeteoAlarm en-GB, pt-PT
רומניה ‫National Meteorological Administration (המינהל המטאורולוגי הלאומי) דרך MeteoAlarm en-GB, ro-RO
סרביה ‫Republic Hydrometeorological Institute of Serbia (המכון ההידרו-מטאורולוגי של סרביה) דרך MeteoAlarm en-GB, sr
סינגפור ‫Meteorological Service Singapore (השירות המטאורולוגי של סינגפור) en-US
סלובקיה Slovak Hydrometeorological Institute (המכון ההידרו-מטאורולוגי של סלובקיה) דרך MeteoAlarm sk, en-GB
סלובניה ‫Hydrometeorological Institute of Slovenia (המכון ההידרו-מטאורולוגי של סלובניה) דרך MeteoAlarm en-GB, sl
איי שלמה ‫Solomon Islands Meteorological Services (השירותים המטאורולוגיים של איי שלמה) en
דרום קוריאה ‫Korea Meteorological Administration (המינהל המטאורולוגי של קוריאה) en-US, ko-KR
ספרד ‫State Meteorological Agency (הסוכנות המטאורולוגית של המדינה) דרך MeteoAlarm en-GB, es-ES
שוודיה ‫Swedish Meteorological and Hydrological Institute (המכון המטאורולוגי וההידרולוגי של שוודיה) דרך MeteoAlarm en-GB, sv-SE
שווייץ ‫Federal Office of Meteorology and Climatology MeteoSwiss (המשרד הפדרלי למטאורולוגיה ולאקלים) דרך MeteoAlarm en, de, fr, it
טאיוואן ‫National Science and Technology Center for Disaster Reduction‏ (המרכז הלאומי המדעי והטכנולוגי לצמצום אסונות, NCDR) zh-TW
תאילנד ‫Thai Meteorological Department (המחלקה המטאורולוגית של תאילנד) th-TH
בריטניה ‫Met Office דרך MeteoAlarm en-GB
‫UK Environment Agency (הסוכנות להגנת הסביבה של בריטניה)
ארצות הברית ‫National Tsunami Warning Center (המרכז הלאומי להתראות על צונאמי) en-US
‫US National Weather Service (שירות מזג האוויר הלאומי של ארה"ב) en-US
וייטנאם ‫National Center for Hydrometeorological Forecasting (המרכז הלאומי לתחזיות הידור-מטאורולוגיות) en-VN, vi-VN

שיוך (Attribution)

בכל המסכים שבהם הנתונים מוצגים, אפליקציית הלקוח חייבת לכלול שיוך למקור המקורי באמצעות השדה dataSource:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

השיוך חייב לכלול את השם המלא של מקור הנתונים (כפי שצוין בשדה name) והיפר-קישור למקור הנתונים באמצעות כתובת ה-URL שצוינה בשדה authorityUri (לדוגמה, "השירות המטאורולוגי הלאומי").

סוגי אירועי מזג אוויר

אלה סוגי אירועי מזג האוויר שנתמכים:

סוגי אירועי מזג אוויר
ACID_RAIN
AVALANCHE
BLIZZARD
BLOWING_SNOW
COASTAL_FLOOD
COASTAL_HAZARD
COLD
CYCLONE
DROUGHT
EXTRATROPICAL_CYCLONE
FIRE_WEATHER
FLASH_FLOOD
FLOOD
FOG
FREEZING
FREEZING_AIR_TEMPERATURE
FREEZING_DRIZZLE
FREEZING_RAIN
FROST
GALE
GLAZE
HAIL
HAZARDOUS_SEAS
HEAT
HUMIDITY
HURRICANE
ICE_STORM
LAKE_EFFECT_SNOW
MONSOON
MUDDY_FLOOD
OUTFLOW
RAIN
RIVER_FLOODING
SEVERE_THUNDERSTORM_WARNING
SNOW
SNOWSQUALL
STORM
STORM_SURGE
THUNDER
THUNDERSTORM
TORNADO
TORNADO_WARNING
TROPICAL_CYCLONE
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES
TROPICAL_DISTURBANCE
TROPICAL_STORM
TYPHOON
WIND
WIND_CHILL
WIND_WAVE
WINTER_STORM
WILDFIRE
BUSHFIRE
FIRE
LANDSLIDE
EARTHQUAKE
DUST_STORM
AFTERSHOCK
TSUNAMI
VOLCANIC_ASH
VOLCANIC_ERUPTION
RADIATION

התנהגות התרגום של התשובה

‫Google מספקת תרגומים לשדה alertTitle בלבד. יכול להיות שגם שדות אחרים, כמו eventType,‏ areaName,‏ instruction ו-safetyRecommendations, יתורגמו, בהתאם לתמיכה בשפות של מקור הנתונים המקורי. עם זאת, Google לא יכולה לספק תרגומים עצמאיים לשדות האלה.

בהתאם לפרמטר languageCode שנכלל בבקשה, אלה ההתנהגויות הצפויות בשדה alertTitle:

  • השפה languageCode נתמכת: אם השפה languageCode שביקשתם צוינה ונתמכת, התשובה תוחזר בשפה המבוקשת.
  • languageCode לא נתמכת: במקרים שבהם אין תמיכה ב-languageCode המבוקשת ואי אפשר למצוא חלופה קרובה, נקודת הקצה מחזירה את התשובה באנגלית כברירת מחדל.
  • לא צוין languageCode: נקודת הקצה מחזירה את התשובה באנגלית כברירת מחדל.

דוגמה לבקשה של התראה בנוגע למזג האוויר

בדוגמה הבאה נשלחת בקשה לקבלת מידע על התראות מזג אוויר בעיירה בצפון קרוליינה:

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

גוף התגובה הוא:

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

רוצה לנסות?

ב-APIs Explorer אתם יכולים לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שהוא מציע.

  1. בצד שמאל של הדף, לוחצים על סמל ה-API api.

  2. אם רוצים, עורכים את הפרמטרים של הבקשה.

  3. לוחצים על הכפתור Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

  4. בחלונית APIs Explorer, לוחצים על סמל המסך המלא fullscreen כדי להרחיב את החלון של APIs Explorer.