Telonics

Website: https://www.telonics.com/ 

This integration requires assistance from Telonics for setup and configuration. Please get in touch with our Support Team at support@earthranger.com and we’ll guide you through the process to ensure everything is set up correctly.

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.

Integration Process Summary

  1. Contact Telonics to connect your devices to their system.
  2. Set up a Connection in Gundi. Contact our team if you need assistance.
  3. Share your Connection 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 Click on Create Connection.

1.3 Select your technology.

1.4 Select your Workspace.

1.5 Enter a name for this Connection (e.g., “Trackers - AreaName”)

1.6 Click Next.

1.7 Select a Destination. Please consult our guides.

1.8 Visit the Connection you created during this process, and copy the API key. To do this, go to the Connection's Provider tab, find the API key field, and click the copy icon. 

1.9 Send the API key and your account identifier to your contact at the data source provider, asking them to set up an integration with Gundi (URL: https://sensors.api.gundiservice.org/v2/observations/). Alternatively, configure the API key directly in their system if you have access to those settings.

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 Connection includes a Destination, and review the Connection 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.

Note on Latency

The time it takes for data to appear in your destination system depends on several factors, such as latency introduced by the source, network conditions, and intermediary systems. While these factors may vary, Gundi typically checks for available data at scheduled intervals (approximately every 5 minutes).

If data is not available in your system after this interval, please check the source of the data for its availability. If the issue persists, contact our Support team for assistance.

 

Characteristics

This is a "Push" type integration, meaning your data provider sends data to Gundi on their own schedule (for example, immediately or every 5 minutes), and Gundi then forwards it right away to the destination specified in your Connection.

Only fresh data will be processed by Gundi, but a request can be made to the data provider for historic data.

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.

 
 

 

 

Data Provider,  Animal Tracking, Movement Data, Push Integration, Events
Sep 4, 2025