CarTrack

Website: https://www.cartrack.co.za/ 

Prerequisites

CarTrack

You will need:

  1. CarTrack account username.

  2. CarTrack API Password: Refer to CarTrack’s documentation for instructions on how to generate it (section titled “Generating an Administrator Password for the API”)

  3. CarTrack API endpoint (e.g., https://fleetapi-zw.cartrack.com/rest/ or https://fleetapi-za.cartrack.com/rest/ )

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 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

Integration Requires Assistance

Self-Service integration not available yet, please contact our Support Team.

This integration requires assistance from our support team for setup and configuration. Please contact our support team at support@earthranger.com and we’ll guide you through the process to ensure everything is set up correctly.

We are actively working to make this integration self-service in the future. Stay tuned for updates!

Go to Gundi v1.

Go to the Inbound Integrations and select Add Integration.

Follow the steps below to configure the integration:

Name: Enter a suitable name (e.g., "Sitename - CarTrack")

Owner:  Select the integration's owner

Type: CarTrack

Provider Key:  Leave empty. It will automatically give it a name.

Default Device Group: Leave empty. Gundi will automatically create a default group.

Endpoint:  Endpoint provided by the user (e.g., https://fleetapi-zw.cartrack.com/rest, or https://fleetapi-mz.cartrack.com/rest, or https://fleetapi-za.cartrack.com/rest)

Token:  Leave empty

Login/Password:  CarTrack Username and "API Password" provided by the user

State:   

{}

Click Save

Configure the Default Device Group to select the destination site. 

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_rumi_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 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.

Please refer to EarthRanger's documentation or contact Support.

Data Pull Frequency

Approximately every 10 minutes.

Characteristics

  • This integration retrieves data including latitude, longitude, timestamp, speed, odometer reading, ignition status, event location, and device ID. Some of this data isn't available when sending data to Movebank.
  • Currently, the integration only retrieves data from the last 45 minutes. Historical data backfill is not yet available.

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.

Data Provider,  Vehicle Tracking, Movement Data, Gundi v1, Pull Integration
May 18, 2026