Supported technology/Vehicle Trackers
| Direction | Data provider |
| Data | Movement data |
| Platform | Gundi v2 |
| Type | Pull integration |
Baytrac sends vehicle positions to EarthRanger through Gundi. Gundi checks your Baytrac account every minute, and the positions show up as tracks on the map.
What you'll receive
We add details here as we confirm what Baytrac sends. If you know something we're missing, let us know.
| Positions | Yes, from every device on your Baytrac account, named after the device in Baytrac. Positions without a valid GPS fix are skipped by default; turn off Filter Invalid Gps in the Route settings to keep them. |
| Alerts and events | No |
| Sensor readings | Speed, heading, altitude and odometer, plus the device model and VIN, as Baytrac reports them. Points from the hourly catch-up carry speed, heading and altitude only. |
| Photos and files | No |
| Past data | Yes, the last hour. Every hour Gundi also fetches the past hour of route points for every device, to fill gaps between checks. To fetch older data, run Pull Historical Observations with Hours set from 1 to 48; End Hours Ago moves the window further back. |
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
Baytrac
You will need:
- Integration endpoint (e.g., https://advantage.baytrac.co.za/api/api.php)
- Integration token
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 Log in to Gundi.
1.2 Click Create Route.
1.3 Select Baytrac.
1.4 Select your Workspace.
1.5 Enter a Route Name (e.g., Vehicle Tracker - Account name).
1.7 Use the default values for all other configurations, and adjust them later as needed.
1.10 Click Next.
1.11 Click Add destination on the flow map and select a destination. Please consult our guides.
Integration Actions
Pull Observations (runs every minute) — Fetches current device positions. Can also be triggered manually.
Pull Historical Observations (runs every hour) — Backfills the last hour of route data for all devices.
Key Considerations
loc_valid filtering
Baytrac's loc_valid field reflects whether the device had a valid GPS fix at the time of the
last known position. The live action filters these out by default (Filter Invalid GPS toggle).
The historical backfill does not filter, because historical route points don't carry this flag,
only the current device state does.
Other Vehicle Trackers
| Avis Pulse | BIDTRACK | CarTrack |
| Gesfrota | LoneStar Tracking |
| Back to the integration catalog | Need help setting this up? Contact us |
