Global Nature Watch (GNW)

Supported technology/Remote Imagery

globalnaturewatch.org

Platform Gundi v2
Type Pull integration
Data Events
Direction Data provider

Setup You, in the portal

Global Nature Watch sends fire and deforestation alerts for your area to EarthRanger through Gundi. Gundi checks GNW for new data on a schedule, and each alert shows up as an event on the map.

What you'll receive

We add details here as we confirm what Global Nature Watch sends. If you know something we're missing, let us know.

Positions No
Alerts and events Yes. Fire alerts become gfwfirealert events and integrated deforestation alerts become gfwgladalert events, for the area in your GNW share link and at or above the lowest confidence you choose (fire: high, deforestation: highest by default). Events are created, not updated. See Global Nature Watch Event Types.
Sensor readings No. Each event carries the alert's confidence level; fire alerts also carry the alert time.
Photos and files No
Past data Yes. Each check looks back 5 days for fire alerts (1 to 10, Fire alerts lookback days) and 15 days for deforestation alerts (1 to 30, Integrated deforestation alerts lookback days) in the Route settings. Gundi only queries again once GNW has published new data.

How this integration works

This is a pull integration. Gundi checks the data provider for new data on a schedule, using the account details you enter in the Route, and passes what it finds on to your destination.

Who's involved

  • You create the Route in Gundi and enter your provider account details, or give them to Gundi support when the setup badge says so.
  • The data provider keeps your account and devices active.
  • Your destination, for example EarthRanger, is where the data shows up.
  • Gundi support helps only when the setup badge at the top of this page says so.

Historical data

When you first connect, Gundi fetches a limited amount of past data. How far back it goes depends on the integration and is shown under "Past data" above.

When data doesn't show up

Check your Route Activity Logs first: wrong account details and provider outages show up there. Then check with the provider that your devices are reporting.

How often data arrives

Gundi checks on a schedule. Where we know how often, it's shown under "Data Pull Frequency" on this page. New data arrives after the next check, plus the time the device takes to upload it to the provider.

Prerequisites

Please make sure to have this ready for your integration:

GNW

You will need:

  • GNW Account (username and password)
  • GNW single-polygon area saved into your “My GNW” list.  

Read more: Save an area and subscribe to receive forest change notifications | External Link (globalnaturewatch.org) 

EarthRanger

You will need:

  • An EarthRanger user for this integration (e.g., “Gundi Service Account”) for this integration, with permission to create event types in the chosen event category. Please refer to EarthRanger's documentation or contact Support.
  • An authentication token for the integration.  Please refer to EarthRanger's documentation or contact Support.
  • An event type for this integration. 

Contact us if you need assistance.

Event Type

This integration needs two EarthRanger event types. Their values, fields and a ready-to-apply spec are in Global Nature Watch Event Types.

Configuration

GUIDES

1. Login to Gundi.

2. Click on Create Route.

3. Select Global Nature Watch.

4. Select your Workspace.

5. Enter a name for this Route (e.g., “GNW - Area Name”)

6. Configure your GNW credentials.

7. Global Nature Watch AOI Share Link

  • Configure the area of interest provided by Global Nature Watch AOI “Share Link”.

8. Select one or more alert types:

8.1. Include fire alerts

  • Configure the number of lookback days. 
  • Configure the lowest confidence level you wish to receive.

8.2. Include integrated deforestation alert

  • Configure the number of lookback days.
  • Configure the lowest confidence level you wish to receive.

9. Force fetch (Optional) 

Click to Expand

You can leave this unchecked. Our Support team may use it to resolve certain issues. “Force Fetch” is used to fetch data as soon as possible, rather than waiting for the automatic schedule, which can be 4 to 12 hours after the last pull for this account.

 
 

10. Click Next.

12. Click Add destination on the flow map and select a destination. Please consult our guide.

Considerations

How the Lookback Days setting affects alert delivery                                                                                         

The Lookback Days setting controls how far back in time the integration queries for alerts. It is based on the alert's original detection date — the date the first alert system detected potential deforestation — not the date the alert reached a higher confidence level.                                     

GNW alerts are progressively confirmed over time: an alert may be detected by one system on March 1st, but not reach Highest confidence (confirmed by multiple systems) until weeks later. When the integration runs after that confidence upgrade, it queries GNW for alerts whose detection date falls within the lookback window. If the original detection date is older than the lookback window, the alert will not be retrieved. 

Example: With a 30-day lookback running on April 2nd, the integration queries for alerts detected between March 3rd and April 2nd. An alert first detected on March 1st falls outside this window and will not be sent to EarthRanger.                                                                     
                                                                                                                                                          
 Recommendations                                                                                                                                          
 
 - If your area of interest has alerts that typically take several weeks to reach your configured confidence level, consider increasing the Lookback Days to cover the full expected delay.       
 - The maximum supported lookback is 30 days. If alerts in your area routinely take longer than 30 days to consolidate confidence, consider switching the minimum confidence to High (confirmed twice by a single system) instead of Highest, since High confidence is typically reached sooner after initial detection.  

   Limitations

  • Multipolygon areas are not supported by Gundi yet. 
  • This integration creates events - it does not update them.

Next Steps

EarthRanger

Consider configuring “auto-resolve” in EarthRanger using a number of hours.

If the amount of data is undesired or not helpful, consider updating the "Integrated deforestation alerts lowest confidence" or "Fire alerts lowest confidence" parameter in Gundi. 

Note on Latency

The time it takes for data to appear in your destination system depends on several factors, such as latency introduced by the source, network conditions, and intermediary systems. 

Deforestation Alerts

There are two main sources of delay between a deforestation event occurring on the ground and an alert appearing in EarthRanger.                              
                                                                                                                                                          
 1. GNW confidence consolidation                                                                                                                          
GNW alerts are detected by multiple independent satellite systems. An initial detection may appear within days of the event, but reaching High or Highest confidence (where the alert is confirmed by additional systems) can take several weeks. The integration only sends alerts that meet your configured minimum confidence level, so alerts configured for Highest confidence will arrive later than those configured for High.                                  
                                                                                                                                                          
 2. Integration polling frequency                                                                                                                         
Once GNW publishes new data, the integration picks it up on its next scheduled check, which runs approximately every 4–12 hours.

For areas configured to receive Highest confidence alerts, it is normal to see alerts arrive in EarthRanger several weeks after the event first occurred on the ground.

External Resources

Save an area and subscribe to receive forest change notifications | External Link (globalnaturewatch.org) 

Other Remote Imagery

OroraTech
Back to the integration catalog Need help setting this up? Contact us