نظرة عامة على Weather API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهة برمجة التطبيقات Weather API طلب بيانات الطقس في الوقت الفعلي وبدقة عالية جدًا للمواقع الجغرافية حول العالم. تتضمّن معلومات الطقس درجة الحرارة وهطول الأمطار والرطوبة وغير ذلك.
بالنسبة إلى موقع جغرافي محدّد بخط طول وخط عرض معيّنَين، توفّر واجهة برمجة التطبيقات نقاط نهاية تتيح لك إجراء طلبات بحث عن:
- أحوال الطقس الحالية: هي أحوال الطقس الحالية.
- توقّعات الطقس كل ساعة: تصل إلى 240 ساعة من التوقّعات بشأن جميع العناصر.
- التوقّعات اليومية: تصل إلى 10 أيام من التوقّعات بشأن حالة جميع العناصر.
- السجلّ كل ساعة: يتضمّن هذا السجلّ ما يصل إلى 24 ساعة من الظروف السابقة المخزّنة مؤقتًا لجميع العناصر.
ميزات Weather API
تتضمّن بيانات Weather API ما يلي:
- حالات الطقس والرموز: وصف ورمز مطابقان يشيران إلى حالات الطقس الحالية (مثلاً، "غائم" أو "زخات ثلج متفرقة").
- درجة الحرارة: الحدّ الأدنى والأقصى لدرجات الحرارة ودرجة الحرارة الظاهرية ("المحسوسة")
- هطول الأمطار: إجمالي هطول الأمطار ونوعها (ثلوج وأمطار وجليد ومزيج).
- الرياح: متوسط درجة الحرارة المحسوسة واتجاه الرياح والسرعة القصوى والعاصفة
- سماكة الجليد: سماكة الجليد
- الرطوبة: نقطة الندى ومؤشر الحرارة ودرجة حرارة البصيلة الرطبة والرطوبة النسبية
- مؤشر الأشعة فوق البنفسجية: هو مؤشر للأشعة فوق البنفسجية.
- احتمالية حدوث عواصف رعدية: هي النسبة المئوية لاحتمالية حدوث عواصف رعدية.
- مستوى الرؤية: يشير إلى المسافة التي يمكن عندها رؤية جسم ما بوضوح.
- ضغط الهواء: متوسط ضغط الهواء على مستوى سطح البحر
- أحداث الشمس والقمر: أوقات الشروق والغروب وطلوع القمر وغروبه
- تغطية السحب: النسبة المئوية للسماء المغطاة بالسحب
كيفية استخدام Weather API
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Weather API overview\n\nThe Weather API lets you request real-time, hyperlocal weather data for\nlocations around the world. Weather information includes temperature,\nprecipitation, humidity, and more.\n\nFor a location at a given latitude and longitude, the API provides endpoints\nthat let you query:\n\n- **Current conditions:** The current weather conditions.\n- **Hourly forecast:** Up to 240 hours of forecasted conditions for all elements.\n- **Daily forecast:** Up to 10 days of forecasted conditions for all elements.\n- **Hourly history:** Up to 24 hours of cached past conditions for all elements.\n\nFeatures of the Weather API\n---------------------------\n\nWeather API data includes the following:\n\n- **Weather conditions and icons:** A description and corresponding icon indicating the current weather conditions (for example, \"Cloudy\" or \"Scattered snow showers\").\n- **Temperature:** Minimum, maximum, and apparent (\"feels like\") temperatures.\n- **Precipitation:** Total precipitation and precipitation type (snow, rain, ice, mix).\n- **Wind:** Average windchill, wind direction, maximum speed, and gust.\n- **Ice thickness:** Thickness of ice.\n- **Humidity:** Dew point, heat index, wet-bulb temperature, and relative humidity.\n- **UV index:** Ultraviolet (UV) index.\n- **Thunderstorm probability:** The percent chance of a thunderstorm occurring.\n- **Visibility:** The distance at which an object is clearly visible.\n- **Air pressure:** The average sea level air pressure.\n- **Sun and moon events:** Sunrise, sunset, moonrise, and moonset times.\n- **Cloud cover:** The percentage of the sky covered by clouds.\n\nHow to use the Weather API\n--------------------------\n\n|---|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/weather/cloud-setup) and complete the instructions that follow. |\n| 2 | **Get current conditions** | See [Get current conditions](/maps/documentation/weather/current-conditions). |\n| 3 | **Get hourly forecast** | See [Get hourly forecast](/maps/documentation/weather/hourly-forecast). |\n| 4 | **Get daily forecast** | See [Get daily forecast](/maps/documentation/weather/daily-forecast). |\n| 5 | **Get hourly history** | See [Get hourly history](/maps/documentation/weather/hourly-history). |\n\nWhat's next\n-----------\n\n- [Set up your Google Cloud project](/maps/documentation/weather/cloud-setup)\n- [Get current conditions](/maps/documentation/weather/current-conditions)\n- [Get hourly forecast](/maps/documentation/weather/hourly-forecast)\n- [Get daily forecast](/maps/documentation/weather/daily-forecast)\n- [Get hourly history](/maps/documentation/weather/hourly-history)"]]