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 km από ένα σημείο, τελευταίες 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 | Κωδικός χώρας, δύο ή τριών γραμμάτων (GR, GRC). |
| year | Έτος έναρξης. |
| from / to | Εύρος ημερομηνιών, εεεε-μμ-ηη. |
| min_ha / max_ha | Ελάχιστη και μέγιστη έκταση, σε εκτάρια. |
| bbox | Ορθογώνιο lat_min,lon_min,lat_max,lon_max. |
| region / place | Slug της περιφέρειας ή του δήμου. |
| active | active=true, μόνο όσες καίνε ακόμη. |
| lat / lon / radius_km | Κύκλος γύρω από σημείο, ακτίνα σε 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: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 (Copernicus), εστίες VIIRS της NASA FIRMS, διοικητικά όρια του geoBoundaries / OCHA COD-AB, καιρός ERA5 του Open-Meteo με τον δείκτη FWI υπολογισμένο εδώ, και καπνός από το μοντέλο CAMS του Copernicus.
Προτεινόμενη αναφορά: WorldFires (worldfires.org), με βάση EFFIS και GWIS (Copernicus) και NASA FIRMS.