Telonics

Supported technology/Animal Tracking

telonics.com

Direction Data provider
Data Movement data, Events
Platform Gundi v2
Type Push integration

Setup You, in the portal

Telonics sends GPS collar positions and immobility alerts to EarthRanger through Gundi. Positions show up as tracks on the map, and alerts arrive as EarthRanger reports.

What you'll receive

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

Positions Yes. Telonics only sends locations it rates as accurate (“Resolved QFP”), so some fixes never reach Gundi. See Troubleshooting below.
Alerts and events Yes. Immobility alerts and their all-clear, as the event types immobility and immobility_all_clear. See Telonics Event Types.
Sensor readings Not documented yet
Photos and files No
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

Telonics

You will need:

  • Telonics account.

EarthRanger

To send event 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 our Support team.
  • A long-lived token for authentication assigned to the user created in the previous step. 
    Please refer to EarthRanger's documentation or contact our Support team.
  • Confirm that the required event types and schemas are configured in EarthRanger.

Integration Process Summary

  1. Contact Telonics to connect your devices to their system.
  2. Set up a Route in Gundi. Contact our team if you need assistance.
  3. Share your Route API key with your Telonics contact.
  4. Allow your devices to send data through Telonics Gundi EarthRanger.
  5. Verify the integration and reach out for support as needed.

Configuration Steps

1. Gundi Connection Settings

1.1 Visit our portal. 

1.2 On the Routes page, click Create Route.

1.3 Under What would you like to connect?, search for your technology, select it and click Next.

1.4 Under Route details, enter a Route Name (e.g., “TechnologyName - AreaName”).

1.5 Choose the Route Workspace.

1.6 Click Create Route. Gundi creates the Route and opens its flow map.

1.7 Click Add destination on the flow map and select a destination. Please consult our guides.

1.8 Click the data provider node on the flow map and open Connect → Push API key. Under API key, click the copy icon. Only workspace admins can see and copy the key.

1.9 Under Send data to this Route, choose what the provider will send (Observations, Events or Events with attachments) and copy the Endpoint. Send the API key, the endpoint and your account identifier to your contact at the data provider, and ask them to set up an integration with Gundi. If you have access to their system, you can enter these settings there yourself.

Suggested Contacts:

2. EarthRanger Settings

The following configurations are optional:

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

2.1.1 Log in to EarthRanger as an admin (site.pamdas.org/admin).
2.1.2 Go to Source Providers.
2.1.3 Select the Source Provider created for this integration (e.g., "telonics")

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.

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

2.2 Assign your Subjects to a Subject Group.

2.3 Rename your Subjects

Please refer to EarthRanger's documentation or contact Support.

Additional Resources

Troubleshooting

Important Note: Some locations are not sent to Gundi

Not all locations are forwarded to Gundi because some are considered insufficiently accurate. This decision was made by Telonics out of concern that low-confidence locations might be sent to EarthRanger, potentially prompting conservation teams to act on misleading data before thoroughly evaluating its quality.

This is the information shared with us: 

Telonics apply stricter criteria for location accuracy before sending data to EarthRanger. Specifically, they only send locations marked as “Resolved QFP” and exclude those labeled “Resolved QFP (Uncertain)” or “Unresolved QFP.” The two most important quality metrics they rely on are Satellite Count and DOP (Dilution of Precision).

QFP performs best when the collar has an unobstructed view of the sky. In areas with limited sky visibility, traditional GPS fixes (which take longer but work with as few as 4–5 satellites) are often more reliable.

With their newer “-5” models, the improvements in battery life are substantial enough that switching to traditional GPS fixes is a viable option—even preferable in some cases. Additionally, regular GPS fixes use less bandwidth, which could lower monthly Iridium transmission costs.

 
 

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