نظرة عامة على Weather API

تتيح لك واجهة Weather API طلب بيانات الطقس في الوقت الفعلي على مستوى منطقة محلية صغيرة للمواقع الجغرافية حول العالم من أجل تشغيل لوحات بيانات الطقس المباشرة وتطبيقات تحديث الطقس وتراكبات الطقس على المسارات وأدوات تتبُّع النشاط أو الصحة المستندة إلى الطقس. تشمل معلومات الطقس درجة الحرارة الحالية وهطول الأمطار والرطوبة النسبية وسرعة الرياح ومؤشر الأشعة فوق البنفسجية والمزيد.

بالنسبة إلى موقع جغرافي عند خط عرض وخط طول معيّنين، توفّر واجهة برمجة التطبيقات نقاط نهاية (https://weather.googleapis.com/v1/...) للبيانات الواردة في الجدول التالي.

نظرة سريعة على نقاط نهاية REST

نقطة النهاية لواجهة برمجة التطبيقات عنوان 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).
  • هطول الأمطار: إجمالي هطول الأمطار ونوعها (ثلوج أو أمطار أو جليد أو مزيج من هذه الأنواع)
  • الرياح: برودة الرياح (windChill) واتجاه الرياح (wind.direction) وسرعة الرياح (wind.speed) وهبوب الرياح (wind.gust)
  • سماكة الجليد: سماكة الجليد
  • الرطوبة: نقطة الندى (dewPoint) ومؤشر الحرارة (heatIndex) ودرجة حرارة البصيلة الرطبة (wetBulbTemperature) والرطوبة النسبية (relativeHumidity)
  • مؤشّر الأشعة فوق البنفسجية: مؤشّر الأشعة فوق البنفسجية (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 لا تعرض هذه القيم.

تشمل واجهات برمجة التطبيقات البيئية الأخرى ذات الصلة ما يلي:

  • عدد حبوب اللقاح: Pollen API‏ (https://pollen.googleapis.com/v1/forecast:lookup)
  • الإشعاع الشمسي وإمكانية توليد الطاقة الشمسية على الأسطح: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

الخطوات التالية