Supported technology/Vehicle Trackers
| Direction | Data provider |
| Data | Movement data |
| Platform | Gundi v2 |
| Type | Pull integration |
Bluetrax sends vehicle positions to EarthRanger through Gundi. Gundi checks your Bluetrax account every 5 minutes, and each vehicle's latest position shows up on the map.
What you'll receive
We add details here as we confirm what Bluetrax sends. If you know something we're missing, let us know.
| Positions | Yes, the latest position of every vehicle on your Bluetrax account, named after its registration number. |
| Alerts and events | No |
| Sensor readings | Speed, heading and the street address Bluetrax gives for each position, plus the device's time zone and unit ID. |
| Photos and files | No |
| Past data | No. Each check sends the latest position of each vehicle, so movement between checks is not sent. |
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
Data Source
You will need:
- Bluetrax username.
- Bluetrax API key.
Data Delivery
EarthRanger
To send 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 in Gundi
Login to Gundi.
Click Create Route.
Select Bluetrax.
Configure your Bluetrax username and API key.
Select your Workspace.
Enter a name for this Route under Route Name (e.g, Bluetrax - AccountName)
Click Next.
Click Add destination on the flow map and select a destination. Please consult our guide.
Next Steps
EarthRanger
The following configurations are optional:
1. Select the data you want to see in the map.
1.1. Log in to EarthRanger as an admin.
1.2. Go to
Source providers.
1.3. Click on
Subject Details Configuration.
1.4. Configure the additional
information you would like to see on the map.
2. Rename your Subjects.
3. Assign your Subjects to a Subject Group.
Please refer to EarthRanger's documentation or contact Support.
Data Pull Frequency
Approximately every 5 minutes.
Limitations
Bluetrax's Free Plan includes:
- Fleet & Asset Location Endpoint: 15,000 API calls per month
- Historical Data Endpoint: 1,000 h_calls per vehicle per month (each h_call represents approximately one hour of data)
Please note that these limits are set by Bluetrax, not by Gundi.
Additional Resources
Troubleshooting
If the Route is not bringing new data and the credentials appear to be invalid, please consult the section “Limitations” and confirm whether the Connection has run out of available requests.
Other Vehicle Trackers
| Avis Pulse | Baytrac | BIDTRACK |
| CarTrack | Gesfrota |
| Back to the integration catalog | Need help setting this up? Contact us |
