AddaxAI Connect is a camera trap management platform that runs wildlife images through AI classification and sends the results on to other systems. Through Gundi it delivers two kinds of events to EarthRanger: detections (species, count, confidence, camera and site, plus the annotated image) and camera alerts (battery, SD card, silence, rejected files and theft-watch). Each event links back to the full record in Connect.
AddaxAI maintains the step-by-step instructions, including the two EarthRanger event type schemas to import.
Prerequisites
AddaxAI Connect
You will need:
- Project administrator access to your AddaxAI Connect project.
Gundi
You will need:
- A Gundi account.
- A Route using the API provider, with EarthRanger as the destination (steps below).
EarthRanger
You will need:
- Administrator access to your EarthRanger site.
- A service account and token for Gundi. Please refer to EarthRanger's documentation or contact Support.
- The two AddaxAI event types (below). The Gundi user must have permission on their event category, otherwise Gundi accepts the event but EarthRanger refuses it.
| Event type | Value | Used for |
|---|---|---|
| AddaxAI detection | addaxai_connect_detection |
Species detections: species, scientific name, category, count, confidence, camera ID, site name, link to the record, plus the annotated image as an attachment. |
| AddaxAI camera alert | addaxai_connect_camera_alert |
Camera health: battery, SD card, silence, rejected files and theft-watch alerts, with camera ID, site name and a link to the record. |
The full field schemas for both event types are provided in the AddaxAI Connect docs.
Configuration
1. Create the Route in Gundi
1.1 Log in to Gundi and create a Route.
1.2 Choose the API provider.
1.3 Select your Workspace and enter a name for this Route (e.g., AddaxAI - ProjectName).
1.4 Click Add destination on the flow map and select your EarthRanger site. Please consult our guide.
1.5 Save the Route, then select the data provider node and copy the API key shown under Connect → API key.
2. Prepare the EarthRanger site
2.1 Log in to EarthRanger as an admin (site.pamdas.org/admin).
2.2 Go to Activity → Event Types and add the two event types from the table above, using the schemas from the AddaxAI Connect docs.
2.3 Make sure the Gundi user has permission on the event category you assigned them to.
3. Connect the project in AddaxAI Connect
3.1 In AddaxAI Connect, open Integrations → EarthRanger.
3.2 Paste the Gundi API key from step 1.5 and save.
4. Choose what to send
4.1 In AddaxAI Connect, create rules for which detections and which camera alerts should be sent to EarthRanger. Events are posted once and are not updated afterwards.
5. Verify
5.1 Trigger or wait for a detection in AddaxAI Connect.
5.2 Check the Route's Activity Logs in Gundi and confirm the event appears in EarthRanger.