API · v1
开放API
本地图集收录的所有火灾,均提供JSON、CSV和GeoJSON格式。无需密钥,无需注册,合理使用不限请求次数:过火范围、热点、受灾地区、天气、火险指数和烟雾数据。
使用说明
- 无需密钥,也无需注册。如需大量下载,请放慢速度并做好缓存。
- 已开放CORS:可直接在浏览器中调用。
- 根据资源不同,响应可缓存5分钟至1小时。
- 数据采用CC BY 4.0许可:使用时请注明WorldFires及原始来源。
- v1版本不会发生不兼容的变更;新字段会添加在末尾。
示例
/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。