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
andgfwfirealert
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
togfwfirealert
) for data to be received via Gundi.
- You may need to change the default legacy GFW event type values (e.g. from
- 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