跳到正文
worldfires
API · v1

开放API

本地图集收录的所有火灾,均提供JSON、CSV和GeoJSON格式。无需密钥,无需注册,合理使用不限请求次数:过火范围、热点、受灾地区、天气、火险指数和烟雾数据。

使用说明

示例

/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/detections?format=csv 该火灾的VIIRS探测记录,CSV格式
/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 葡萄牙逐年逐月合计

/fires的筛选参数

country 国家代码,两个或三个字母(ES、ESP)。
year 起火年份。
from / to 日期范围,格式为yyyy-mm-dd。
min_ha / max_ha 最小和最大面积,单位为公顷。
bbox 矩形范围:lat_min,lon_min,lat_max,lon_max。
region / place 地区或县级行政区的slug。
active active=true表示只返回仍在燃烧的火灾。
lat / lon / radius_km 以某点为中心的圆,半径单位为公里。仅限 /hotspots 和 /active。
hours /hotspots(1-168)和 /active(24、72、168)的回溯小时数。
static static=true 保留火炬、工业和火山热点,并标记为 static。
q 在名称和slug中搜索。
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:41+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(火险天气指数由本站计算),烟雾数据来自哥白尼CAMS模式。

建议引用格式:WorldFires(worldfires.org),数据基于EFFIS和GWIS(哥白尼)以及NASA FIRMS。