API · v1
API แบบเปิด
ไฟป่าทุกครั้งในแผนที่นี้ในรูปแบบ JSON, CSV และ GeoJSON ไม่ต้องใช้คีย์ ไม่ต้องลงทะเบียน และไม่มีการจำกัดจำนวนคำขอแบบเข้มงวด ทั้งแนวขอบเขต จุดความร้อน อำเภอที่ได้รับผลกระทบ สภาพอากาศ ระดับความเสี่ยงไฟ และหมอกควัน
วิธีใช้งาน
- ไม่ต้องใช้คีย์และไม่ต้องลงทะเบียน หากดึงข้อมูลจำนวนมาก โปรดดึงอย่างช้า ๆ และเก็บแคชไว้
- เปิด CORS ไว้ เรียกใช้จากเบราว์เซอร์ได้โดยตรง
- ผลลัพธ์เก็บแคชได้ตั้งแต่ห้านาทีถึงหนึ่งชั่วโมง ขึ้นอยู่กับทรัพยากร
- ข้อมูลอยู่ภายใต้สัญญาอนุญาต CC BY 4.0 ใช้ได้โดยอ้างอิง WorldFires และแหล่งข้อมูลต้นทาง
- เวอร์ชัน v1 จะไม่เปลี่ยนแปลงในลักษณะที่ทำให้ใช้งานร่วมกันไม่ได้ ฟิลด์ใหม่จะเพิ่มต่อท้าย
ตัวอย่าง
/api/v1/fires?country=ES&year=2026&min_ha=1000
ไฟป่าในสเปนปี 2026 ที่ใหญ่กว่า 1,000 เฮกตาร์
/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 | รหัสประเทศ สองหรือสามตัวอักษร (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 ได้สูงสุด 1,000 และใช้ 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:33+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 (Copernicus) จุดความร้อน VIIRS จาก NASA FIRMS เขตการปกครองจาก geoBoundaries / OCHA COD-AB สภาพอากาศ ERA5 จาก Open-Meteo พร้อมดัชนีสภาพอากาศเสี่ยงไฟที่คำนวณที่นี่ และหมอกควันจากแบบจำลอง CAMS ของ Copernicus
การอ้างอิงที่แนะนำ: WorldFires (worldfires.org) โดยใช้ข้อมูลจาก EFFIS และ GWIS (Copernicus) และ NASA FIRMS