סקירה כללית על Weather API

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

למיקום בקו רוחב ובקו אורך נתונים, ה-API מספק נקודות קצה (https://weather.googleapis.com/v1/...) לנתונים שבטבלה הבאה.

נקודות קצה (endpoints) של REST בקצרה

נקודת הקצה ל-API כתובת URL תיאור פרמטרים מתועדים
התנאים הנוכחיים https://weather.googleapis.com/v1/currentConditions:lookup תנאי מזג האוויר בזמן אמת location.latitude, location.longitude
תחזית שעתית https://weather.googleapis.com/v1/forecast/hours:lookup תחזית של תנאי מזג האוויר עד 240 שעות קדימה location.latitude, location.longitude
תחזית יומית https://weather.googleapis.com/v1/forecast/days:lookup תחזית של תנאי מזג האוויר עד 10 ימים קדימה location.latitude, location.longitude
היסטוריה לפי שעה https://weather.googleapis.com/v1/history/hours:lookup עד 24 שעות של תנאי מזג אוויר קודמים שנשמרו במטמון location.latitude, location.longitude
התרעות על מזג אוויר קיצוני https://weather.googleapis.com/v1/publicAlerts:lookup התרעות על מזג אוויר קיצוני key, location.latitude, location.longitude

תרחישים נפוצים לדוגמה

  • לוחות בקרה של מזג אוויר בזמן אמת ועדכוני מזג אוויר: שליחת שאילתות ל-currentConditions:lookup, ל-forecast/hours:lookup ול-forecast/days:lookup באמצעות קואורדינטות GPS (location.latitude ו-location.longitude) או קואורדינטות של עיר שהומרו לכתובת, כדי להציג עדכונים אוטומטיים של הטמפרטורה, הלחות ומהירות הרוח.
  • שכבות-על של מזג האוויר במסלול: דוגמה לנקודות ציון של קווי רוחב ואורך לאורך קו פוליגוני של מסלול מ-Routes API, וקריאה ל-currentConditions:lookup או ל-forecast/hours:lookup בזמן ההגעה המשוער של כל נקודת ציון כדי להתריע לנהגים על שינויים בתנאי מזג האוויר.
  • מעקב אחר פעילות, שתייה ובריאות על סמך מזג האוויר: אחזור של temperature, feelsLikeTemperature, relativeHumidity, heatIndex וuvIndex מקומיים מ-currentConditions:lookup כדי להתאים את יעדי השתייה היומיים או את ההמלצות לפעילות גופנית בחוץ.

התכונות של Weather API

נתוני Weather API כוללים:

  • תנאי מזג האוויר וסמלים: תיאור וסמל תואם שמציינים את תנאי מזג האוויר הנוכחיים (לדוגמה, "מעונן" או "ממטרי שלג פזורים") ב-weatherCondition.
  • טמפרטורה: הטמפרטורה הנוכחית (temperature), הטמפרטורה המינימלית והמקסימלית (minTemperature ו-maxTemperature בתחזיות היומיות, או בתוך currentConditionsHistory), והטמפרטורה המורגשת (feelsLikeTemperature).
  • ‫Precipitation: כמות המשקעים הכוללת וסוג המשקעים (שלג, גשם, קרח, מעורב).
  • רוח: טמפרטורת הרוח (windChill), כיוון הרוח (wind.direction), מהירות הרוח (wind.speed) ומשב רוח (wind.gust).
  • עובי הקרח: עובי הקרח.
  • לחות: נקודת הטל (dewPoint), אינדקס החום (heatIndex), טמפרטורת התרמומטר הרטוב (wetBulbTemperature), והלחות היחסית (relativeHumidity).
  • מדד קרינת UV: מדד קרינת אולטרה-סגול (UV) (uvIndex).
  • הסבירות לסופת רעמים: הסיכוי באחוזים שתתרחש סופת רעמים.
  • ראות: המרחק שבו אפשר לראות אובייקט בבירור.
  • לחץ אוויר: לחץ האוויר הממוצע בגובה פני הים.
  • אירועי שמש וירח: זריחה, שקיעה, זריחת הירח ושקיעת הירח.
  • כיסוי עננים: אחוז השמיים שמכוסים בעננים.

איך משתמשים ב-Weather API

1 להגדרה מתחילים בהגדרת פרויקט ב-Google Cloud ומשלימים את ההוראות הבאות.
2 קבלת מידע על התנאים הנוכחיים איך בודקים את התנאים הנוכחיים
3 תחזית לפי שעה איך מקבלים תחזית לפי שעה
4 קבלת תחזית יומית איך מקבלים תחזית יומית
5 קבלת היסטוריה לפי שעה איך מקבלים היסטוריה לפי שעה
6 קבלת התראות לגבי מזג האוויר איך מקבלים התראות על מזג האוויר

כדי לקבל את מדד איכות האוויר (AQI) ונתונים על מזהמים חלקיקיים (PM2.5, ‏ PM10), צריך להשתמש ב-Air Quality API‏ (https://airquality.googleapis.com/v1/currentConditions:lookup). ה-Weather API לא מחזיר את הערכים האלה.

ממשקי API סביבתיים קשורים אחרים כוללים:

  • כמות האבקנים: Pollen API‏ (https://pollen.googleapis.com/v1/forecast:lookup)
  • עוצמת הקרינה הסולארית והפוטנציאל של גגות: Solar API‏ (https://solar.googleapis.com/v1/buildingInsights:findClosest)

המאמרים הבאים