Supported technology/Animal Tracking
| Data | Movement data |
| Platform | Gundi v1 |
| Type | Pull integration |
| Direction | Data provider |
Ecotopia (Druid Technology) sends GPS and Argos positions from your animal tags to EarthRanger through Gundi. Gundi checks your Ecotopia account on a schedule, and the positions show up as tracks on the map.
What you'll receive
We add details here as we confirm what Ecotopia sends. If you know something we're missing, let us know.
| Positions | Yes, both GPS and Argos fixes from every device on your Ecotopia account, named after the device's ID in Ecotopia. Fixes with impossible coordinates are skipped, and devices the account isn't allowed to read are skipped. |
| Alerts and events | No |
| Sensor readings | Battery level, temperature, battery voltage, fix quality (HDOP and VDOP), survivor mode and when it started, and whether the fix came from GPS or Argos, plus the other device and environment status values Ecotopia reports. |
| Photos and files | No |
| Past data | Yes. The first time Gundi sees a device, it fetches its latest 250 GPS fixes and latest 250 Argos fixes. After that, each check picks up from the latest position already received. |
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
Ecotopia
You will need:
- Ecotopia account (username and password)
Gundi
You will need:
- Credentials or an authentication token to access the delivery system.
EarthRanger
To send movement data to EarthRanger, you will need:
- A special EarthRanger user (e.g., “Gundi Service Account”) for this integration. Please refer to EarthRanger's documentation or contact Support.
- A long-lived token for authentication assigned to the user created in the previous step. Please refer to EarthRanger's documentation or contact Support.
Configuration
GUIDES
Gundi Connection Settings
Go to Gundi v1
Go to the Inbound Integrations and select Add Integration
Follow these steps to configure the integration.
| Name | Enter a suitable name (e.g., "Sitename - Druid Tech") |
| Owner | Select the integration's owner |
| Type | DruidTech / Ecotopia |
| Provider Key | Leave empty. It will automatically give it a name. |
| Default Device Group | Leave empty. Gundi will automatically create a default group. |
| Endpoint | https://www.ecotopiago.com |
| Token | Leave empty |
| Login/Password | Username and password provided by the user |
| State |
{}
Click Save
Configure the Default Device Group to select the destination site.
Troubleshooting
Q1: Why is battery level showing as 0 or not appearing for some Druid tags?
Battery level comes from the status_env.battery_power
field in the Druid API. Some older firmware devices (firmware < 1003) don't report this
value, so it will show as blank. Devices on newer firmware should report a percentage (0–100).
If all devices show 0, it may indicate the integration was running an older version of the
connector — deploying the latest version should resolve it.
Q2: Why are some tags showing temperature data but not battery data (or vice versa)?
Temperature and battery level come from different sub-fields on the device. Temperature is
more broadly supported across firmware versions. Battery percentage requires status_env.battery_power
to be populated by the tag's firmware — not all hardware versions support it.
Q3: What does "Survivor Mode" mean for a Druid tag?
Survivor mode (survivor_number = 1) means the tag has entered a low-power emergency state, typically due to low battery or lack
of recent GPS fixes. The tag reduces transmission frequency to extend battery life. The survivor_time
field shows when survivor mode was activated. Rangers should prioritize checking on animals
whose tags are in survivor mode.
Q4: Why are some tags showing 403 Forbidden errors and no location data?
A 403 means the API account associated with this integration doesn't have permission to
access that specific device's GPS data. This typically happens when a Druid account manages
multiple device groups and some devices belong to a different access tier. The connector will
skip those devices and continue processing the rest — no action needed unless the missing
devices are expected to report.
Q5: Why does a tag show a valid location in the Druid portal but no recent positions in EarthRanger
This can happen when the GPS record has coordinates outside valid bounds (longitude outside ±180 or latitude outside ±90) — the connector filters those out. It can also happen if the tag's last position predates the integration's state window. Check the Druid portal export for that device and compare timestamps with what's visible in EarthRanger.
Data Pull Frequency
Approximately every 5 minutes.
Other Animal Tracking
| Argos | Africa Wildlife Tracking (AWT) | Advanced Telemetry Systems (or ATS) |
| Ceres Wild | digitanimal |
| Back to the integration catalog | Need help setting this up? Contact us |
