TerraMar Networks (Tracpoint)

Supported technology/Animal Tracking

terramarnetworks.com/fleet-management-system

Direction Data provider
Data Movement data
Platform Gundi v2
Type Pull integration

Setup You, in the portal

Tracpoint sends vehicle tracker positions to EarthRanger through Gundi. Gundi checks your Tracpoint 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 Tracpoint sends. If you know something we're missing, let us know.

Positions Yes, from every vehicle on your Tracpoint account, named after its display name in Tracpoint. Each check sends each vehicle's newest position. Positions without a time or location are skipped. You can set the subject type with Subject Type in the Route settings (truck by default).
Alerts and events No, not by default. With Forward Tracpoint events to Gundi turned on in the Route settings, positions Tracpoint tags with an event (for example speeding or a geofence breach) are also sent as events, with type tracpoint_ plus the event name.
Sensor readings Speed, course, GPS fix, odometer, the road, town, area, county, state, country and postcode Tracpoint reports, and the Tracpoint event name when there is one.
Photos and files No
Past data Yes. Every 2 hours, Gundi fetches each vehicle's full history since the last fetch to fill gaps. The first time, it goes back 24 hours, set with Maximum lookback (hours). If the last fetch is older than 7 days (Stale cursor threshold (days)), it starts again from that limit.

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

Tracpoint

You will need:

  • Tracpoint Account
  • Username, Password, “WSDL URL” (e.g., http://www.terramarnetworks.net/v7/index.php?wsdl), and "Company".

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

1. Gundi Connection Settings

1.1 Login to Gundi.

1.2 Click on Create Route.

1.3 Select Tracpoint.

1.4 Select your Workspace.

1.5 Enter a name for this Route (e.g., “Vehicle Tracker - AccountName”)

1.6 Configure your Tracpoint account details (URL, Company, Username, Password).

1.7 Click Next.

1.8 Click Add destination on the flow map and select a destination. Please consult our guide.

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., "gundi_tracpoint_UUID")

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.

Please refer to EarthRanger's documentation or contact Support.

Data Pull Frequency

Approximately every 2 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