Supported technology/Camera Trap
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.
What you'll receive
We add details here as we confirm what AddaxAI Connect sends. If you know something we're missing, let us know.
| Positions | No |
| Alerts and events | Yes. Species detections and camera health alerts (battery, SD card, silence, rejected files and theft-watch), as the event types addaxai_connect_detection and addaxai_connect_camera_alert. See Prerequisites below. |
| Sensor readings | No |
| Photos and files | Yes. The annotated image, attached to each detection. |
| Past data | Not documented yet |
How this integration works
This is a push integration. The data provider sends data to Gundi whenever it has something new, on its own schedule. Gundi passes each piece on to your destination as soon as it arrives.
Who's involved
- You create the Route in Gundi and share its API key with the data provider.
- The data provider turns on sending to Gundi with that key.
- 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
Gundi passes on whatever the provider sends, old or new. Gundi can't ask the provider for past data, so if you need history, ask the provider whether they can send it again.
When data doesn't show up
Gundi doesn't check the provider for new data; it waits for the provider to send it. If nothing arrives, check with the provider first that they are sending, then look at your Route Activity Logs.
How often data arrives
That depends on how often the provider sends it. Some send each reading right away, others in batches every few minutes or hours.
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.
Other Camera Trap
