واجهة الطقس

التنبؤ#

المعاملات

الاستجابة

{
  "latitude": 48.85,
  "longitude": 2.35,
  "timezone": "Europe/Paris",
  "grid": {
    "latitude": 48.85, "longitude": 2.35,
    "distance_km": 0.42, "resolution_km": 1.3
  },
  "elevation": {
    "applied": true,
    "model_elevation_m": 91.0,
    "location_elevation_m": 113,
    "temperature_offset_c": -0.14
  },
  "source": {
    "model": "mf_arome",
    "model_run": "20260801T00Z",
    "reference_time": "2026-08-01T00:00:00+00:00",
    "data_age_hours": 3.95,
    "stale": false,
    "attribution": "Data: Météo-France (etalab-2.0)"
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+02:00", "..."],
    "temperature_2m": [18.1, 17.9, 17.6, "..."],
    "apparent_temperature": [17.4, "..."],
    "weather_code": [0, 1, 2, "..."]
  },
  "daily": {
    "date": ["2026-08-01", "..."],
    "temperature_2m_max": [26.6, "..."],
    "temperature_2m_min": [16.2, "..."],
    "precipitation_sum": [0.0, "..."],
    "uv_index_max": [7.6, "..."],
    "sunrise": ["2026-08-01T06:24:00+02:00", "..."],
    "sunset": ["2026-08-01T21:24:00+02:00", "..."],
    "daylight_hours": [15.0, "..."]
  }
}

تقليص الحمولة

الكتلة الساعية الكاملة لخمسة عشر يومًا نحو 32 حقلًا × 360 ساعة. فإن كنت ترسم ثلاثة منها فاطلب ثلاثة:

GET /v1/forecast?lat=48.85&lon=2.35&days=3
    &hourly=temperature_2m,precipitation,weather_code
    &include_daily=false

السعر نفسه — فالتكلفة في قراءة الأرشيف لا في التسلسل — لكن البايتات عُشر ما كانت، والتحليل على الهاتف أسرع بوضوح.

التنبؤ حسب المدينة#

فضّل هذا على الإحداثيات الخام حيثما أمكن. فالكتالوج يقدّم شيئين لا تقدمهما إحداثية: ارتفاع المدينة الحقيقي، فيسري تصحيح التضاريس دون أن تعطيه أنت، ومنطقتها الزمنية، فتُقطَّع التجميعات اليومية على اليوم المحلي الصحيح.

GET /v1/forecast/city/dz/alger      # slug فرنسي
GET /v1/forecast/city/dz/algiers    # slug إنجليزي — المدينة نفسها
GET /v1/forecast/city/fr/paris

country رمز ISO-3166-1 alpha-2 بحروف صغيرة. وslug لا يتأثر بعلامات التشكيل: فـ bejaia تجد بجاية. وslug مجهول يعيد 404 city_not_found مع مصفوفة suggestions — اعرضها بدل طريق مسدود.

وتبقى كل معاملات الاستعلام في /v1/forecast سارية عدا lat وlon وelevation التي يوفرها الكتالوج. وتمرير timezone يتجاوز منطقة المدينة نفسها، وهو ما لا تريده في الغالب الأعم.

الأحوال الراهنة#

تُستكمَل الحرارة والرطوبة والرياح والضغط استكمالًا خطيًا إلى اللحظة الراهنة، بين خطوتَي النموذج المحيطتين بها.

استعمل هذا لعرض «الآن». أما كل ما ستقارنه عبر الزمن فاستعمل له /v1/forecast واقرأ الساعة التي تريد: فالسلسلة مستقرة، بينما الآن يتحرك تحتك بين ندائين.

مرجع الحقول#

الحقول الساعية

يعود 21 منها افتراضيًا. والباقي لك متى طلبته — سمِّها في hourly= مفصولة بفواصل — وهي محجوزة للتكلفة لا للشك: فكل حقل مخزَّن قراءة مضغوطة مستقلة، واستجابة افتراضية تحمل الـ 45 كلها كانت ستجعل الجميع يدفع ثمن قلّة يريدون عمق الثلج.

GET /v1/forecast?lat=45.19&lon=5.72&hourly=temperature_2m,snow_line_altitude,soil_temperature_8cm

والحقل الذي لا ينشره نموذج ما يعود null في المقطع الذي يغطيه ذلك النموذج من التنبؤ، بدل أن يختفي من الاستجابة — فسلسلة تبدأ على AROME وتستمر على ICON-EU تعيد visibility من أولها إلى آخرها، فارغة في الساعات الـ 51 الأولى. أما اسم حقل مجهول فهو 400 unknown_field، مع اقتراح أقرب تطابق؛ وقد كان يُتجاهل صامتًا في السابق.

الحقول اليومية

date وtemperature_2m_max وtemperature_2m_min وtemperature_2m_mean وprecipitation_sum وwind_speed_max وwind_gust_max وshortwave_radiation_sum (م.ج/م²) وuv_index_max وsunrise وsunset وdaylight_hours وweather_code.

وتُجمَّع على أيام تقويمية محلية، لا على التوقيت العالمي. أما اليوم الناقص عند أي طرف من المجال فيُحذف بدل أن يُبلَّغ عنه بحد أقصى مضلِّل — أي أن طلبًا لسبعة أيام قد يعيد عن حق ستة صفوف يومية.

النماذج والاستبانة#

نقدّم أدقّ نموذج يغطي نقطتك و مداك الزمني معًا. ولا تختار أنت النموذج أبدًا؛ بل يُبلَّغ عن الاختيار في source.model لتعرف دائمًا أيّها أجاب.

والنماذج عالية الاستبانة كلها قصيرة المدى — فعند 1 كم يصير الجو فوضويًا خلال يومين، فيغدو التنبؤ لأبعد من ذلك بلا معنى — ولذلك تتدرج الاستبانة نزولًا كلما تقدم التنبؤ:

يوم 0 ─────── يوم 2 ─────── يوم 5 ───────────────── يوم 15
  AROME 1.3 كم (فرنسا)
  ICON-D2 2.2 كم (ألمانيا والألب والبنلوكس)
  HRRR 3 كم (الولايات المتحدة وجنوب كندا)
              ICON-EU 6.5 كم (أوروبا)
                          ICON 13 كم · ECMWF 28 كم (عالمي)
                                              AIFS (اتجاه فقط)

والانتقالات عبر حافة نطاق النموذج تُمزَج مزجًا متدرجًا، فلا تختلف بلدتان على جانبَي حد اختلافًا قفزيًا أبدًا.

/v1/models لا يحتاج مفتاحًا، وهو ما يجعله الشيء الصحيح لاستطلاعه من صفحة حالة أو للتحقق منه قبل الشراء: فهو يذكر أحدث تشغيل لكل نموذج وعمره، فيغدو سؤال «هل البيانات طازجة» قابلًا للإجابة دون إنفاق رصيد.

احتمالات المجموعات#

التنبؤ المفرد يقول 22 °م يوم الخميس. وذلك تخمين يُقدَّم كأنه حقيقة. أما نقطة النهاية هذه فتجيب عن السؤال الذي تقرر بناءً عليه فعلًا: ما مقدار اليقين، وما احتمال المطر الذي يستحق التخطيط له.

وتُحسب من مجموعة ECMWF الاحتمالية — النموذج نفسه مُشغَّلًا 50 مرة من شروط ابتدائية مختلفة اختلافًا طفيفًا. فحيث تتفق التشغيلات يكون التنبؤ واثقًا. وحيث تتبعثر يكون الجو نفسه غير مؤكد، ولا نموذج مهما بلغ جودةً يستطيع أن يخبرك بأكثر.

{
  "members": 50,
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "temperature_2m_p10": [26.4],
    "temperature_2m_p50": [26.78],
    "temperature_2m_p90": [27.3],
    "temperature_2m_spread": [0.4],
    "precipitation_probability_0_1mm": [10.0],
    "precipitation_probability_1_0mm": [0.0],
    "precipitation_probability_5_0mm": [0.0],
    "precipitation_probability_10_0mm": [0.0],
    "precipitation_p90": [0.1]
  }
}

كيف تقرؤها

p10 وp90 يحصران 80 % الوسطى من الأعضاء: واحد من كل عشرة يتوقع أبرد من p10، وواحد من كل عشرة أدفأ من p90. وspread يساوي 0.4 °م حالة مستقرة يمكنك الوثوق بها؛ أما 3 °م فتعني أن النماذج مختلفة وينبغي أن تقول ذلك لمستخدميك بدل أن تختار واحدًا.

وعتبات المطر قرارات لا أرقام مدوَّرة — 0.1 ملم تعني مبتلّ أصلًا، و1 ملم تعني خذ معطفًا، و5 و10 ملم تعنيان هذه مشكلة. وprecipitation_p90 هي الحالة السيئة: فعضو واحد من كل عشرة أمطر منها.

جودة الهواء#

هذه أهم نقطة نهاية في شمال إفريقيا وحوض المتوسط. فموجة غبار ترفع PM10 فوق ألف ميكروغرام في المتر المكعب أيامًا متصلة، وذلك قرار صحي لا مجرد رقم، وتغطيته ضعيفة في الخدمات الاستهلاكية المجانية.

{
  "current": {
    "pm2_5": 38.7,
    "band": "poor",
    "who_guidelines_ug_m3": {"pm2_5": 15.0, "pm10": 45.0,
                             "nitrogen_dioxide": 25.0, "ozone": 100.0}
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "pm2_5": [38.7], "pm10": [85.8], "ozone": [43.4],
    "nitrogen_dioxide": [19.0], "dust_aod_550nm": [0.24]
  },
  "units": {"pm2_5": "ug/m3", "pm10": "ug/m3", "dust_aod_550nm": "1"}
}

وكل التراكيز بوحدة ميكروغرام/م³، وهي الوحدة التي تُذكر بها جودة الهواء في كل مكان. أما dust_aod_550nm فهو عمق بصري بلا وحدة: فوق 0.5 تقريبًا تبدو السماء ضبابية بوضوح، وفوق 1.0 تخفت الشمس.

وتسافر القيم الإرشادية قصيرة المدى لمنظمة الصحة العالمية في كل استجابة ليمكن وضع الرقم في سياقه دون البحث عنه. وband يتبع مؤشر جودة الهواء الأوروبي للجسيمات PM2.5: جيدة، مقبولة، متوسطة، رديئة، رديئة جدًا، رديئة للغاية.

الثلج وخط الثلج#

أربعة حقول، تجيب عن أسئلة مختلفة. snowfall هو مقدار المتساقط؛ وبقيتها تصف ما استقر على الأرض وأين.

اطلبها بالاسم — فهي ليست في الاستجابة الافتراضية:

GET /v1/forecast?lat=45.19&lon=5.72&hourly=snowfall,snow_depth,snow_water_equivalent,snow_line_altitude,freezing_level_altitude

خط الثلج هو ما يستحق القراءة. فعبارة «تمطر عند 800 م وتثلج عند 1200» قرار تستطيع أن تبني عليه محطة تزلج أو إدارة طرق أو سائق؛ أما «3 ملم من الهطول» فلا. وهو مهم في شمال إفريقيا أيضًا — ففي الأطلس مناطق تزلج في الشريعة وتيكجدة، والهضاب العليا في سطيف وباتنة والجلفة تعلو 1000 م.

وتأتي هذه الحقول من نموذج ICON التابع لـ DWD، الذي يغطي العالم عند 13 كم. والبيانات المفتوحة لـ ECMWF تنشر عمق الثلج لا خط الثلج، فهذا أحد المواضع التي يكون فيها النموذج الأخشن أنفع. وsnow_line_altitude منتج إقليمي: ينشره ICON-EU وICON-D2 ولا ينشره ICON العالمي، فتحصل خارج أوروبا على مستوى التجمد والعمق دون الخط نفسه.

البحر — حالة البحر#

{
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "wave_height": [0.32],
    "wave_direction": [264.3],
    "wave_period": [3.79],
    "wave_peak_period": [4.21]
  }
}

ارتفاع الموج هو الارتفاع المُعتدّ به — أي متوسط الثلث الأعلى من الأمواج، وهو تقريبًا ما يبلّغ عنه راصد في البحر. وتبلغ الأمواج المفردة نحو ضعفه، وهو الرقم المهم إن كنت تقرر الإبحار من عدمه. والاتجاه هو الاتجاه الذي تأتي منه الأمواج، كاتجاه الريح.

الأنهار#

يجيب عمّا لا يستطيعه أي نموذج طقس: لا كم من المطر يسقط في الأعالي، بل كم من الماء يصل إلى هنا — وهو رقم آخر، يفصله عن المطر حوضٌ وحالةُ رطوبة تربة ويومٌ أو يومان من زمن الجريان.

{
  "disclaimer": "Information only. Only national and regional authorities
                 are authorised to issue flood warnings.",
  "daily": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "river_discharge": [4.953],
    "soil_wetness_index": [0.448]
  }
}