ICUServer

Supported technology/Camera Trap

icuserver.com

Direction Data provider
Platform Gundi v2
Type Push integration
Data Events

Setup You, in the portal

ICU Server sends camera trap images, with the AI detections found in them, and periodic camera status reports to EarthRanger through Gundi. Each one arrives as an EarthRanger event.

What you'll receive

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

Positions No
Alerts and events Yes. Camera trap images with their AI detections, and camera status reports, as the event types icu_cameratrap_rep and camera_status_report. See ICU Server Event Types.
Sensor readings No
Photos and files Yes. The camera trap image, attached to its event.
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

ICU Server

You will need:

  • Cameras registered with ICU Server, and a contact at ICU Server to complete the connection on their side.

Gundi

You will need:

  • A Gundi account.
  • A Route using the API provider, with EarthRanger as the destination (steps below).

EarthRanger

You will need:

  • An EarthRanger destination in Gundi for your site.
  • The Camera Trap (icu_cameratrap_rep) and Camera Status Report (camera_status_report) event types — see ICU Server Event Types for their fields and a ready-to-apply spec.

Configuration

1. Create the Route in Gundi

1.1 Log in to Gundi and click Create Route.
1.2 Choose the API provider.
1.3 Select your Workspace and enter a name for this Route (e.g., “ICU Server - SiteName”).
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. Send the API key to ICU Server

2.1 Email the Gundi API key and your EarthRanger site name to ICU Server at info@icuserver.com. They complete the connection on their side.

2.2 ICU Server sends the data to Gundi v2 at https://sensors.api.gundiservice.org/v2/, with the API key in the apikey header. Each request goes to its own endpoint and ends with a slash, because Gundi refuses data posted to the base address alone:

  • Camera status reports: POST /v2/events/ as JSON.
  • Camera trap images: POST /v2/events/ as JSON, then the images with POST /v2/events/{object_id}/attachments/ as multipart.

See the Gundi API Reference for the request formats.

3. EarthRanger Settings

The following configurations are optional:

3.1. Select the data you want to see in the map.

3.1.1 Log in to EarthRanger as an admin (site.pamdas.org/admin).
3.1.2 Go to Source Providers.
3.1.3 Select the Source Provider created for this integration

The “Source Provider” is automatically created after Gundi successfully retrieves data from this integration and pushes it to EarthRanger. If you don't find it, please ensure your Route includes a destination, and review the Route Activity Logs for additional details. You should see some records mentioning that Gundi successfully delivered data to EarthRanger.
Important Note:  The integration might take 5 minutes to run. Please verify your connection after this period.

3.1.4 Click on Subject Details Configuration.
3.1.5 Configure the additional information you would like to see on the map.

3.2 Assign your Subjects to a Subject Group.

3.3 Rename your Subjects

Please refer to EarthRanger's documentation or contact Support.

Other Camera Trap

Sentinel (Conservation X Labs) TrapTagger wpsWatch
TrailGuard
Back to the integration catalog Need help setting this up? Contact us