نمای کلی Weather API

با Weather API می‌توانید داده‌های آب‌وهوای محلی هم‌زمان را برای مکان‌های سراسر جهان درخواست کنید تا داشبوردهای آب‌وهوای زنده، برنامه‌های به‌روزرسانی آب‌وهوا، هم‌پوشانی‌های آب‌وهوای مسیر، و ردیاب‌های فعالیت یا سلامت مبتنی بر آب‌وهوا را تقویت کنید. اطلاعات آب‌وهوا شامل دمای فعلی، بارش، رطوبت نسبی، سرعت باد، شاخص فرابنفش، و غیره می‌شود.

برای مکانی در عرض و طول جغرافیایی مشخص، این میانای برنامه‌سازی کاربردی نقاط پایانی (https://weather.googleapis.com/v1/...) را برای داده‌های جدول زیر ارائه می‌دهد.

نقطه‌های پایانی REST در یک نگاه

نقطه پایانی میانای برنامه‌سازی کاربردی نشانی وب شرح پارامترهای مستندشده
شرایط آب‌وهوایی فعلی https://weather.googleapis.com/v1/currentConditions:lookup شرایط آب‌وهوایی زنده location.latitude، location.longitude
پیش‌بینی ساعت‌به‌ساعت https://weather.googleapis.com/v1/forecast/hours:lookup تا ۲۴۰ ساعت شرایط پیش‌بینی‌شده location.latitude، location.longitude
پیش‌بینی روزانه https://weather.googleapis.com/v1/forecast/days:lookup تا ۱۰ روز شرایط پیش‌بینی‌شده location.latitude، location.longitude
سابقه ساعتی https://weather.googleapis.com/v1/history/hours:lookup تا ۲۴ ساعت شرایط گذشته ذخیره‌شده در حافظه نهان 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).
  • بارش: کل بارش و نوع بارش (برف، باران، یخ، ترکیبی).
  • باد: سرمای باد (windChill)، جهت باد (wind.direction)، سرعت باد (wind.speed)، و تندباد (wind.gust).
  • ضخامت یخ: ضخامت یخ.
  • رطوبت: نقطه شبنم (dewPoint)، شاخص گرما (heatIndex)، دمای حباب تر (wetBulbTemperature)، و رطوبت نسبی (relativeHumidity).
  • شاخص فرابنفش: شاخص فرابنفش (uvIndex).
  • احتمال رعدوبرق: درصد احتمال وقوع رعدوبرق.
  • میدان دید: فاصله‌ای که در آن یک شیء به‌وضوح قابل‌مشاهده است.
  • فشار هوا: میانگین فشار هوا در سطح دریا.
  • رویدادهای خورشید و ماه: زمان طلوع و غروب خورشید و طلوع و غروب ماه.
  • پوشش ابری: درصد آسمانی که با ابر پوشانده شده است.

نحوه استفاده از Weather API

۱ راه‌اندازی کردن با راه‌اندازی پروژه Google Cloud شروع کنید و دستورالعمل‌های بعدی را تکمیل کنید.
۲ دریافت شرایط فعلی دریافت شرایط کنونی را ببینید.
3 دریافت پیش‌بینی ساعت‌به‌ساعت به دریافت پیش‌بینی ساعت‌به‌ساعت مراجعه کنید.
۴ دریافت پیش‌بینی روزانه به دریافت پیش‌بینی روزانه مراجعه کنید.
‫۵ دریافت سابقه ساعتی دریافت سابقه ساعتی را ببینید.
‫۶ دریافت هشدارهای آب‌وهوا دریافت هشدارهای آب‌وهوا را ببینید.

برای شاخص کیفیت هوا (AQI) و آلاینده‌های ذرات معلق (PM2.5،‏ PM10)، از Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup) استفاده کنید. Weather API این مقادیر را برنمی‌گرداند.

دیگر میاناهای برنامه‌سازی کاربردی محیطی مرتبط عبارت‌اند از:

  • شمارش گرده: Pollen API‏ (https://pollen.googleapis.com/v1/forecast:lookup)
  • تابش خورشیدی و پتانسیل پشت‌بام: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

قدم بعدی چیست