Back to data catalog

Deforestation API

Aggregated deforestation data on a global scale

OpenAPI Spec

Specification of all endpoints available in the deforestation api.

Github

Explore the source code behind the deforestation api.

More info

Data sources

The deforestation data covers the period from 2001 to 2022 and is provided by the Global Land Analysis and Discovery (GLAD) laboratory at the University of Maryland, in partnership with Global Forest Watch (GFW). The data are freely available for use under a Creative Commons Attribution 4.0 International License. River basin polygons data is provided by HydroSHEDS. The basin data are feely available for both non-commercial and commercial use under a licence agreement included in the HydroSHEDS Technical Documentation.

Processing

Using the river basin polygons, the deforestation data are aggregated per basin and year.

Examples

Example 1

Get the total forest cover loss within the queried river basin over the given time period.

1import io.openepi.common.ApiException;
2import io.openepi.deforestation.api.DeforestationApi;
3import io.openepi.deforestation.model.DeforestationBasinGeoJSON;
4import java.math.BigDecimal;
5
6public class Main {
7    public static void main(String[] args) {
8        DeforestationApi api = new DeforestationApi();
9        try {
10            BigDecimal lon = new BigDecimal("30.06");
11            BigDecimal lat = BigDecimal.valueOf(-1.94);
12
13            DeforestationBasinGeoJSON response = api.lossyearBasinGet(lon, lat, null, null, null, null, 2010, 2019);
14            
15            // Get the total forest cover loss within the returned river basin over the time period
16            BigDecimal loss = response.getFeatures().get(0).getProperties().getDaterangeTotTreeloss();
17            System.out.println("Total forest cover loss: " + loss + " km^2");
18        } catch (ApiException e) {
19            System.err.println("Exception when calling DeforestationApi#lossyearBasinGet");
20            e.printStackTrace();
21        }
22    }
23}

1const response = await fetch(
2	"https://api.openepi.io/deforestation/basin?" +
3		new URLSearchParams({
4			lon: "30.0619",
5			lat: "-1.9441",
6			start_year: "2010",
7			end_year: "2019",
8		})
9)
10const data = await response.json()
11
12// Get the total forest cover loss within the returned river basin over the time period
13const loss = json.features[0].properties.daterange_tot_treeloss
14
15console.log(`Total forest cover loss: ${loss} km^2`)
16

1from httpx import Client
2
3with Client() as client:
4    response = client.get(
5        url="https://api.openepi.io/deforestation/basin",
6        params={"lon": 30.0619, "lat": -1.9441, "start_year": 2010, "end_year": 2019},
7    )
8
9    # Get the total forest cover loss within the returned river basin over the time period
10    json = response.json()
11    loss = json["features"][0]["properties"]["daterange_tot_treeloss"]
12
13    print(f"Total forest cover loss: {loss} km^2")
14