אם אתה צריך להוסיף מידע על מזג האוויר שלךלאתר או לאפליקציה שאתה מפתח, הדבר הראשון שאתה צריך הוא מקור אמין לנתוני מזג אוויר. אבל זה לא הכל, אתה צריך גם שיטה להביא את הנתונים האלה. האם זה לא היה נהדר אם היה כלי שמאפשר לך להביא בקלות סוגים שונים של נתוני מזג אוויר ולכלול אותם באפליקציה או באתר שלך? ובכן, יש. זה נקרא API של Weatherstack והוא נבנה כדי לעשות בדיוק את זה. אנו בוחנים לעומק את ממשק ה- API הזה, מה הוא יכול לעשות בשבילך ואיך אתה יכול להשתמש בו.
על נתוני מזג אוויר
כפי שהוגדר על ידי ויקיפדיה, "המטאורולוגיה היא ענףשל המדעים האטמוספריים הכוללים כימיה אטמוספרית ופיזיקה אטמוספרית, עם דגש עיקרי על חיזוי מזג האוויר. "ואף על פי שיש יותר מחיזוי מזג אוויר למדע זה, הוא הענף העיקרי שלו. כל עוד היינו, תמיד רצינו - ולעיתים קרובות היינו צריכים - לחזות איך מזג האוויר הולך להיות. במשך כל מאות השנים המדע הזה - כמו כל האחרים - התפתח באופן משמעותי למדע מדויק יחסית שהוא עכשיו. כמובן שחיזוי מזג האוויר הוא שדה שנוטה לטעות וכולנו נתפסנו במקלחת לא צפויה בשלב זה או אחר.
כיום, מספר סוכנויות לאומיות או פרטיותארגונים מספקים שירותי חיזוי ותצפית על מזג אוויר המכסים כמעט את כל העולם כולו. ובעוד שהמידע המדויק שכל קבוצה מספקת וכיצד הוא מעוצב יכול להשתנות, הוא נוטה להיות אחיד יותר ויותר, מה שמקל על ארגונים בינלאומיים לקבל נתונים דומים על מיקומים שונים.
הוספת נתוני מזג אוויר לאתר או לאפליקציה שלך
ישנן סיבות רבות לכך שרוציםלשלב נתוני מזג אוויר באפליקציה שלהם או באתר האינטרנט שלהם. הסיבה הבסיסית ביותר תהיה שמישהו יבנה אפליקציה או אתר מזג אוויר. ובעזרת כלי דוגמת ה- API של Weatherstack, אתה יכול להביא בקלות נתוני מזג אוויר כמעט לכל מקום בעולם ולהציג אותם בכל דרך שהם רוצים. כל שעליך לעשות הוא לקבוע איזה מידע אתה רוצה להציג למשתמשים שלך וכיצד ברצונך להציג אותו. שני יישומים או אתרים שונים יכולים להביא את אותם נתונים מ- Weatherstack ובכל זאת להציג אותם בצורה שונה לחלוטין.
אבל בניית אפליקציות מזג אוויר לאתרים איננההשתמש רק לנתוני מזג אוויר. תאר לעצמך שאתה מנהל לינה וארוחת בוקר נחמדה בחוף הים. האם לא יהיה נחמד אם תוכל לכלול את מזג האוויר הנוכחי ואת התחזית שם בדף הבית שלך? ובכן, ספק נתוני מזג אוויר כמו Weatherstack יאפשר לך לעשות בדיוק את זה. אפילו טוב יותר, זה יעשה זאת אוטומטית עבורך. כל מה שאתה צריך זה להוסיף את הקוד המתאים לאתר שלך ול- voilà! יש לך את תחזית מזג האוויר באתר שלך.
נוכל בקלות לחשוב על שלל שימושים דומיםלכל מי שרוצה להוסיף כל סוג של נתוני מזג אוויר לאפליקציה או לאתר שלו. אם אתה מפעיל, למשל, כל סוג של פעילות בחוץ, ייתכן שתרצה לספק ללקוחות שלך נתוני מזג אוויר עדכניים או תחזית צפויה.
נוכל להמשיך לנצח עם דוגמאות טובות לבאמצעות נתוני מזג אוויר באתר שלך באפליקציה. האמת היא שהגבול היחיד למה שניתן לעשות איתו הוא רק הדמיון של האדם. ראיתי אתרים שלא היו קשורים למזג האוויר אך עדיין כללו נתונים על מזג האוויר.
מבט ראשון בממשק ה- API של Weatherstack
ה ממשק API של Weatherstack הוא למעשה די פשוט. זהו שירות מבוסס אינטרנט בו תוכל להשתמש כדי להביא נתוני מזג אוויר כמעט על כל מיקום. ברגע שיש לך את הנתונים, מה שאתה עושה איתם תלוי בך. מה שממשק ה- API מספק הוא רק מקור לנתוני מזג אוויר בינלאומיים חיים ומעודכנים. הכלי פשוט להפליא לשימוש ומודל התמחור שלו מאפשר לך לשלם עבור כל מה שאתה צריך.
ה ממשק API של Weatherstack מספק הן בזמן אמת, היסטורי ועתיד(תחזית) מידע על מזג האוויר. קהל היעד העיקרי שלה הוא ארגונים גדולים וקטנים, כמו גם מפתחים, פרילנסרים ואנשים פרטיים. זהו אחד מספקי ה- API של REST API הפופולריים ביותר בשוק בגלל קלות היישום ועקביות הנתונים.
Weatherstack הוא שירות מאת Apilayer, חברת תוכנה שממוקמת בלונדון, בריטניה ווינה, אוסטריה. זה עומד מאחורי כמה ממוצרי ה- API וה- SaaS הפופולריים ביותר ברחבי העולם. אלה כוללים דברים כמו Ipstack, שובר מטבעות, באופן חיובי, ו Eversign. ממשק ה- API משתמש בנתוני מזג אוויר מורשים מ-כמה מתחנות מזג האוויר הגדולות וספקי נתוני מזג האוויר בעולם. יתר על כן, כל מקורות הנתונים מנוטרים מקרוב אחר עקביות ודיוק הנתונים מסביב לשעון. אתה תמיד מקבל את הרמה הגבוהה ביותר של אמינות, עקביות ודיוק.
למרות שהתדירות המרעננת של נתוני מזג האוויר שונה ממקור למקור, כל הנתונים שהוחזרו על ידי ה- ממשק API של Weatherstack- הנוכחי, העבר והעתיד - הוא תמיד הכימידע עדכני זמין בנקודת הזמן הנוכחית. נתוני מזג האוויר מתעדכנים תמיד בזמן אמת. אתה יכול להשתמש בו בביטחון ובביטחון שזה הנתונים העדכניים ביותר שקיימים.
זה דבר אחד שיש נתונים עדכניים, אך חשוב גם להיות מסוגלים להביא נתונים אלה בכל פעם שתזדקק להם. ובחזית ההיא, ממשק API של Weatherstack לא משאיר דבר רצוי. יש לו שיא uptime מדהים ולמרות שהחברה מפרסמת זמן uptime של 99.9%, הנתונים הסטטיסטיים האחרונים מראים כי השירות לא ירד פעם אחת בשלושים הימים האחרונים. אבל זה לא רק זמין, אלא שהוא גם מתפקד היטב. כל נתוני מזג האוויר מוחזרים בפורמט JSON שמאפשר תגובה מהירה. זמן התגובה לשאילתה לעיתים רחוקות עולה על חצי שנייה ובדרך כלל קצר בהרבה. כמובן שהניסיון שלך עשוי להשתנות ונושאים שונים מחוץ לשליטת הספק עשויים להאט את התהליך.
ה ממשק API של Weatherstack ניתן גם להרחבה. הוא מגובה על ידי תשתית ענן שנבנתה ומתוחזקת על ידי Apilayer המסוגלת לטפל במיליארדי פניות ביום. ואם האבטחה חשובה לכם - כפי שהיא ככל הנראה - את השאילתות והתגובות ניתן לאבטח באמצעות קידוד 256 סיביות HTTPS (SSL) בתעשייה. זוהי אותה רמת הצפנה שאתה מקבל באתרי בנקאות.
ומכיוון שכל מוצר - ובמיוחד ממשק API - הוא טוב כמו התיעוד שלו, תעריך את התיעוד המקיף המסופק עם ממשק API של Weatherstack. תמצא מסמך קל להבנה עבורוכמעט כל מקרה אפשרי לשימוש. יתר על כן, סדרה של דוגמאות קוד אינטראקטיביות במספר שפות. במקרים רבים השימוש בממשק ה- API יהיה עניין פשוט של העתקת קוד מהדוגמאות ליישום שלך. זה בקושי יכול היה להיות קל יותר.
התכונות העיקריות של ה- API של Weatherstack
מערך התכונות של ממשק API של Weatherstack הוא מרשים. זה משתנה בהתאם לתכנית שתבחר וכמובן למחיר שאתה משלם. (מידע נוסף על תמחור בהמשך). בואו נסתכל לעומק על מה שקיים בפועל מבחינת התכונות.
מזג אוויר בזמן אמת האם ה ממשק API של Weatherstackהתכונה הבסיסית ביותר והיחידה שהיאכלול בכל התוכניות, אפילו זו החינמית. מה שזה נותן לך הוא גישה מיידית לנתוני מזג אוויר עדכניים עבור מיליוני מיקומים גלובליים. זה כמובן מופעל על ידי מקורות נתונים סולידיים ומרענן בזמן אמת.
ה בדיקת מיקום והשלמה אוטומטית המודול זמין רק עם תוכניות בתשלום. הוא מספק נקודת קצה ממשק API גמישה לחיפוש ולמילוי אוטומטי, שיכולים לעזור לך לאתר בקלות כל עיר או אזור שבחרת. אתה יכול לחפש לפי שם, לפי מיקוד, לפי קואורדינטות גיאוגרפיות או אפילו לפי כתובת IP. תכונה אחרונה זו יכולה להיות שימושית מאוד אם ברצונך לכלול נתוני מזג אוויר מקומיים למבקרים באתר שלך. הוא משתמש בטכניקות מיקום גיאוגרפיות כדי לאתר את המיקום הפיזי של המבקרים שלך על סמך כתובת ה- IP שלהם.
ה אסטרונומיה ונתוני ירח מודול - זמין בכל התוכניות בתשלום - מאפשר ל- ממשק API של Weatherstack לספק סדרה של נקודות נתונים יקרות ערך באסטרונומיה. אלה כוללים מידע כמו עליית השמש והירח וזמנים קבועים, שלב הירח ורמות תאורת הירח.
ה ממשק API של Weatherstack גם מספק נתונים לפי שעה על כל התוכניות בתשלום. תקבל נתונים מדויקים בזמן אמת מאוד וגם נתוני מזג אוויר היסטוריים המחולקים לשעה ביממה האחרונה, כולל טמפרטורה, רוח, לחות, גשם והרבה יותר.
ואם אתה רוצה לקבל נתונים עתיקים יותר, כל התוכניות בתשלום כוללות נתוני מזג אוויר היסטוריים המאפשרת לך מידע מלא ומפורט על מזג אוויר היסטורי ברחבי העולם עד לשנת 2008. תכונה זו כלולה גם בכל התוכניות בתשלום.
בכל אופן כשמדובר במזג האוויר, לעתים קרובות אנו מתעניינים יותר במה שהעתיד צופה בנו ולא במה שהיה בעבר. זה המקום איפה נתוני תחזית מזג אוויר המודול שימושי. הוא יספק נתונים אמינים של תחזית מזג אוויר למשך 7 עד 14 יום בעתיד (תלוי בתוכנית שלך), המתעדכנים בזמן אמת וסביב השעון.
לא כולם דוברי אנגלית ומייצרי ה- ממשק API של Weatherstack יודע ש. זו הסיבה שממשק ה- API זמין בארבעים שפות שונות עם ה- מקצועי ו עסקים תוכניות. השפות הזמינות כוללות אנגלית (כמובן), סינית, ערבית, צרפתית, ספרדית וגרמנית, רק כדי להזכיר כמה.
עכשיו אם אתה צריך להביא הרבה נתוני מזג אוויר, הפעלת מספר שאילתות נפרדות יכולה להיות מסובכת, מסורבלת ואיטית למדי. למרבה המזל, ממשק API של Weatherstack מגיע עם ממשק API גורף תכונה. שאילתות בכמות גדולה מאפשרות לך לחפש נתוני מזג אוויר בזמן אמת, היסטוריים או עתידיים עבור מספר מיקומים גלובליים בבקשת API יחידה.
באמצעות Weatherstack
בואו נראה כיצד ניתן להשתמש ב- ממשק API של Weatherstack. המטרה שלנו היא לא לספק לך עומקניתן להשתמש במדריך - התיעוד הנהדר הקיים באתר ה- API של Weathersrack לשם כך - אלא כדי לתת לך סקירה כללית כמה קל להשתמש בשירות ואיך נראים הנתונים שהוחזרו.
קורא את ממשק API של Weatherstack זה פשוט כמו שליחת בקשת קבל ל- api.weatherstack.com. כתובת האתר הזו מורחבת כדי לציין את סוג הבקשה. לפיכך, תשתמש ב api.weatherstack.com/current, api.weatherstack.com/historical או api.weatherstack / תחזית, אם אתה זקוק להצפנה, פשוט קידם את השיחה באמצעות https: // במקום http: //.
אתה צריך, כמובן, לשלוח כמה פרמטריםעם בקשתך. הראשון - והחשוב ביותר - הוא מפתח ה- API שלך. זהו מפתח ייחודי המוקצה לך כשאתה נרשם לשירות. פרמטר חובה נוסף נקרא "שאילתה". זו השאילתה בפועל שתרצה להריץ. זה המיקום שעבורו ברצונך לאחזר נתונים. זה יכול להיות מיקום בודד כמו "לונדון, בריטניה", אבל זה יכול להיות גם מספר מיקומים המופרדים באמצעות נקודה-פסיק כמו "לונדון, מדריד, ניו יורק". מנוע החיפוש מספיק חכם שלא תצטרך להיכנס יותר מסתם שם העיר לרוב המיקומים הידועים ביותר. זה אלא אם כן, כמובן, אתה זקוק למשהו ספציפי כמו מזג האוויר בלונדון, אונטריו, קנדה.
ישנם גם קומץ פרמטרים אופציונלייםהמאפשרות למשתמשים לציין פרמטרים כמו מספר הימים שצפו בהם, יחידות המדידה של השפה. ומכיוון שהתגובה בפורמט JSON, ניתן לציין גם פונקציית התקשרות חזרה של JSONP שתטפל בתגובה. זה מאוד עוצמתי.
לאחר ששלחת את בקשתך, הנה סקירה כללית של התגובה שתגיע לך:
{
"request": {
"type": "City",
"query": "New York, United States of America",
"language": "en",
"unit": "m"
},
"location": {
"name": "New York",
"country": "United States of America",
"region": "New York",
"lat": "40.714",
"lon": "-74.006",
"timezone_id": "America/New_York",
"localtime": "2019-09-07 11:38",
"localtime_epoch": 1567856280,
"utc_offset": "-4.0"
},
"current": {
"observation_time": "03:38 PM",
"temperature": 18,
"weather_code": 113,
"weather_icons": [
"https://assets.weatherstack.com/images/wsymbols01_png_64/wsymbol_0001_sunny.png"
],
"weather_descriptions": [
"Sunny"
],
"wind_speed": 0,
"wind_degree": 345,
"wind_dir": "NNW",
"pressure": 1011,
"precip": 0,
"humidity": 58,
"cloudcover": 0,
"feelslike": 18,
"uv_index": 5,
"visibility": 16
},
"forecast": {
"2019-09-07": {
"date": "2019-09-07",
"date_epoch": 1567814400,
"astro": {
"sunrise": "06:28 AM",
"sunset": "07:19 PM",
"moonrise": "03:33 PM",
"moonset": "12:17 AM",
"moon_phase": "First Quarter",
"moon_illumination": 54
},
"mintemp": 17,
"maxtemp": 25,
"avgtemp": 21,
"totalsnow": 0,
"sunhour": 10.3,
"uv_index": 5,
"hourly": [
{
"time": "0",
"temperature": 18,
"wind_speed": 28,
"wind_degree": 15,
"wind_dir": "NNE",
"weather_code": 122,
"weather_icons": [
"https://assets.weatherstack.com/images/wsymbols01_png_64/wsymbol_0004_black_low_cloud.png"
],
"weather_descriptions": [
"Overcast"
],
"precip": 0,
"humidity": 68,
"visibility": 10,
"pressure": 1008,
"cloudcover": 75,
"heatindex": 18,
"dewpoint": 12,
"windchill": 18,
"windgust": 35,
"feelslike": 18,
"chanceofrain": 0,
"chanceofremdry": 87,
"chanceofwindy": 0,
"chanceofovercast": 90,
"chanceofsunshine": 15,
"chanceoffrost": 0,
"chanceofhightemp": 0,
"chanceoffog": 0,
"chanceofsnow": 0,
"chanceofthunder": 0,
"uv_index": 0
},
{ "time": 300, ... },
{ "time": 600, ... },
// 6 more items
]
}
}
}כפי שאתה יכול לראות, זה הרבה מידע. אתה מקבל נתוני מזג אוויר נוכחיים כגון טמפרטורה, כיוון הרוח ומהירות, לחות, לחץ ברומטרי ומדד UV, בין היתר. קטע התחזית מפורט באותה מידה וכולל, למשל, את הסיכוי לשקעים באחוזים, מדד חום, גורם צינת רוח ונקודת טל. דבר אחרון שראוי לציין הוא שהתגובה כוללת גם כתובות URL לסמלים שבהם תוכלו להשתמש כדי להוסיף עניין חזותי לנתוני מזג האוויר שלכם.
יכולנו להקדיש לא מעט זמן לעבור על כל האפשרויות וקטעי הנתונים השונים הכלולים בתגובות השאילתה. עם זאת, מאז ממשק API של Weatherstack באתר יש תיעוד כה מפורט, אנושיערתי שזה לא הכרחי. ואם אתה זקוק לדוגמאות קונקרטיות כיצד להשתמש בממשק ה- API של Weatherstack עם שפת התכנות שבחרת, התיעוד המקוון כולל מספר דוגמאות של קוד ב- PHP, Python, Nodejs, jQuery, Go and Ruby.
מידע בנוגע למחיר
ה ממשק API של Weatherstack זמין תחת כמה תוכניות שונות. כפי שראינו, התוכניות משתנות במספר הפיצ'רים שהן מציעות, אך הן משתנות גם במספר שיחות ה- API המרבי שתוכל לבצע בכל חודש.
התוכנית הבסיסית ביותר היא חינם תכנית. זה לא עולה כלום וכרטיס אשראי אפילו לא נדרש להירשם לתכנית זו. עם זאת, היא מוגבלת מאוד בכך שהיא תאפשר רק עד אלף שיחות API בחודש. השימוש העיקרי בו הוא למטרות בדיקה.
הבא הוא ה- סטנדרט תכנן עם הרבה יותר תכונות - הוא חסר רקמודול התחזית ומספר השפות - והקצאה חודשית של עד חמישים אלף שיחות. תוכנית זו זמינה במחיר של $ 9.99 לחודש או $ 7.99 לחודש אם אתה משלם מדי שנה.
התוכנית לטווח הבינוני - וגם הפופולרי ביותר - היא התוכנית מקצועי תכנית. ברמה זו אתה מקבל את מערך התכונות המלא והתמיכה הרב-לשונית, כמו גם הקצאה מורחבת של עד שלוש מאות אלף שיחה בחודש. מחיר זה עומד על 49.99 $ או 39.99 $ אם הוא מחויב מדי שנה.
התוכנית העליונה - המכונה עסקים תוכנית - מציעה את אותה התכונה המלאה כמו התוכניתמקצועי אך בהעלאות להקצאה חודשית למיליון שיחות בחודש. זו כמובן התוכנית היקרה במחיר של 99.99 $ לחודש או 79.99 $ עם תשלומים שנתיים.
ואם נראה כי אף אחת מהתכניות הללו לא תואמת את צרכיך, תוכל ליצור קשר Apilayer ולארגן התאמה אישית ארגוני תכנית. זה יכלול את התכונות הדרושות לך ואת ההקצאה החודשית שאתה צריך. רמה זו כוללת גם תמיכה ייעודית כמו גם אפשרות לפתרונות מותאמים אישית המתאימים לצרכים הספציפיים שלך.
שורה תחתונה
אם אתה צריך להוסיף נתוני מזג אוויר לאתר או לאפליקציה שאתה מפתח, ממשק API של Weatherstack יכול לספק לך בדיוק את מה שאתה צריך בכל פעםמחיר סביר מאוד. המוצר קל לשימוש והוא ישתלב בקלות בסביבה הקיימת שלך. השירות מהיר ויעיל, זמינותו מהממת ואיכותו ללא תחרות. עם תוכנית חינמית זמינה, נסה זאת ובדוק בעצמך כיצד כלי זה יכול לעזור לך להשיג את יעדיך.
הערות