الانتقال إلى المحتوى
worldfires
API · v1

واجهة برمجية مفتوحة

كل حرائق هذا الأطلس بصيغ JSON وCSV وGeoJSON. بلا مفتاح ولا تسجيل ولا حد صارم: المحيطات والبؤر والبلديات المتضررة والطقس وخطر الحريق والدخان.

/api/v1 /api/v1/fires /api/v1/countries

كيف تعمل

أمثلة

/api/v1/fires?country=ES&year=2026&min_ha=1000 حرائق إسبانيا سنة 2026 التي تتجاوز 1000 هكتار
/api/v1/fires?bbox=40.0,-5.2,40.6,-4.2&format=geojson ما يقع داخل مستطيل، بصيغة GeoJSON
/api/v1/fires/navaluenga-2026-07 صفحة حريق كاملة
/api/v1/fires/navaluenga-2026-07/geometry المحيط المحترق
/api/v1/fires/navaluenga-2026-07/detections?format=csv بؤرها من VIIRS بصيغة CSV
/api/v1/fires/navaluenga-2026-07/weather الطقس يوماً بيوم ومؤشر FWI
/api/v1/active?hours=72 ما يحترق الآن، آخر 72 ساعة
/api/v1/hotspots?lat=38.99&lon=-1.86&radius_km=50&hours=48 بؤر منفردة ضمن 50 كم من نقطة، آخر 48 ساعة
/api/v1/hotspots?bbox=36,-9.5,44,3.5&format=geojson بؤر آخر 24 ساعة في إسبانيا القارية، بصيغة GeoJSON
/api/v1/countries البلدان المشمولة وسجلها الرسمي
/api/v1/stats?country=PT إجماليات البرتغال بالسنة والشهر
/api/v1/places?country=ES&q=nava البحث عن بلديات

مرشحات ‎/fires

country رمز البلد من حرفين أو ثلاثة (MA, MAR).
year سنة البداية.
from / to مدى التواريخ بصيغة سنة-شهر-يوم.
min_ha / max_ha أصغر وأكبر مساحة بالهكتار.
bbox مستطيل lat_min,lon_min,lat_max,lon_max.
region / place معرّف المنطقة أو البلدية.
active active=true للحرائق المشتعلة فقط.
lat / lon / radius_km دائرة حول نقطة، نصف القطر بالكيلومتر. فقط ‎/hotspots و‎/active.
hours عدد الساعات إلى الوراء لـ ‎/hotspots (1-168) و‎/active (24، 72، 168).
static static=true يُبقي المشاعل والصناعة والبراكين مع وسم static.
q يبحث في الاسم وفي المعرّف.
sort / order الترتيب حسب start أو end أو area؛ وorder=asc أو desc.
limit / offset limit حتى 1000 وoffset للتصفح.
format json (الافتراضي) أو csv أو geojson.
pretty pretty=1 لقراءة مريحة.

شكل الاستجابة

كل شيء يعيد كائناً فيه «meta» و«data». في meta العدد والرخصة والمصادر؛ أما csv وgeojson فتعيد صيغتيهما القياسيتين.

{
  "meta": {
    "count": 2, "total": 1232, "limit": 2, "offset": 0,
    "generated": "2026-10-23T17:33:42+00:00",
    "license": "CC BY 4.0 — cite WorldFires and the original sources",
    "sources": { "perimeters": "EFFIS / Copernicus EMS (CC BY 4.0); GWIS / Copernicus (reconstructed from VIIRS) (CC BY 4.0); MTBS (USGS / USDA Forest Service) (Public domain); …", "hotspots": "NASA FIRMS (VIIRS)" }
  },
  "data": [
    {
      "slug": "navaluenga-2026-07", "country": "ES", "name": "Navaluenga",
      "start": "2026-07-22", "end": "2026-08-09", "days": 19, "active": false,
      "hectares": 63974, "area_source": "effis_perimeter",
      "hotspots": 2841, "frp_max_mw": 1216.5,
      "lat": 40.41, "lon": -4.69, "bbox": [-4.99, 40.26, -4.31, 40.51],
      "municipality": "navaluenga", "region": "avila",
      "url": "https://worldfires.org/en/fire/navaluenga-2026-07"
    }
  ]
}

من أين تأتي البيانات

محيطات EFFIS وGWIS (كوبرنيكوس)، وبؤر VIIRS من NASA FIRMS، والحدود الإدارية من geoBoundaries / OCHA COD-AB، وطقس ERA5 من Open-Meteo مع مؤشر FWI المحسوب هنا، والدخان من نموذج CAMS التابع لكوبرنيكوس.

الاستشهاد المقترح: WorldFires (worldfires.org)، استنادًا إلى EFFIS وGWIS (كوبرنيكوس) وNASA FIRMS.