Global Forest Watch (GFW)

Website: https://www.globalforestwatch.org/ 

Tags: Remote Imagery, Fire Alerts, Deforestation, Pull Integration, Events, Data Provider

Prerequisites

Data Fetch

  • GFW username and password
  • GFW area of interest (URL)
    • Warning Note: Multipolygon areas are not supported by Gundi yet. 

Data Delivery

  • Configurations required on the destination system (e.g., event types in EarthRanger, data model in SMART Connect).

Configuration in Gundi

Click on Create Connection.

Select “Global Forest Watch”

Configure your GFW credentials under “Email” and “Password”

Configure the area of interest under “Global Forest Watch AOI Share Link”

Fire Alerts

  •   Configure the number of lookback days.
  •   Configure the lowest confidence level you wish to receive in your EarthRanger site or SMART Connect server.

Integrated Deforestation Alerts

  •   Configure the number of lookback days.
  •   Configure the lowest confidence level you wish to receive in your EarthRanger site or SMART Connect server.

Select your Organization

Write a name for this connection under “Connection Name”

Click Next

Select a Destination. Please consult our guides.

Data Delivery

The time it takes for data to appear in your destination system depends on multiple factors, including latency introduced by the original source, network conditions, and intermediary systems. While these factors may vary, Gundi typically checks for available data on a scheduled interval of approximately 10 minutes.

If your data is not available in EarthRanger or SMART Connect after this interval, kindly refer to the GFW Dashboard to review the availability of data. Alternatively, please contact our Support team for further assistance.

EarthRanger

For this integration to create events on your site, you will need the following:

  • Create the event types gfwgladalert and gfwfirealert in an Event Category that the Gundi Service Account user has access to.
    • You may need to change the default legacy GFW event type values (e.g. from gfw_activefire_alert to gfwfirealert) for data to be received via Gundi.
  • Create an Extended Auth Token using the Gundi permission set.
  • Please ensure that following permissions are set in the Gundi permission set:
    • Can create analyzer_event reports
    • Can update analyzer_event reports
    • Can read analyzer_event reports
    • Can delete analyzer_event reports

Event Types Schema: Integrated Deforestation Alerts

  • Display: GFW Integrated Deforestation Alert
  • Value: gfwgladalert
  • Category: Analyzer Event
  • Schema:
{
 "schema": {
   "$schema": "http://json-schema.org/draft-04/schema#",
   "title": "Auto-generated schema, from incoming data.",
   "type": "object",
   "properties": {
     "confidence": {
       "type": "number",
       "title": "Confidence"
     }
   }
 },
 "definition": [
   "confidence"
 ]
}

 

Event Types Schema: Fire Alerts

  • Display: GFW Fire Alert
  • Value: gfwfirealert
  • Category: Analyzer Event
  • Schema:


{
 "schema": {
   "$schema": "http://json-schema.org/draft-04/schema#",
   "title": "Auto-generated schema, from incoming data.",
   "type": "object",
   "properties": {
     "confidence": {
       "type": "string",
       "title": "Confidence"
     },
     "alert_time": {
       "type": "string",
       "title": "Alert Time"
     }
   }
 },
 "definition": [
   "alert_time",
   "confidence"
 ]
}

Other Notes:

  • Consider configuring auto-resolve to 2 days or so. Ask the user for confirmation.
 
 

SMART Connect

For this integration to create independent incidents in your SMART CA, you will need the following:

Create the categories gfwgladalert and gfwfirealert in your data model. Consult this guide.

 
 

Need Help?

Contact Support

If you need help with Gundi, here are some resources to try. 

Contact the Gundi team 

Send an email to support@earthranger.com with your questions or a description of the issue you have been experiencing.

Help Us Improve Gundi 

If you have comments, corrections or suggestions regarding our guides, website, or the Gundi portal, please email them to support@earthranger.com.

Feel free to explore our website for more contact information.

 

 

 

Last Update: Feb 28, 2025

Was this article helpful?