Supported technology/Vehicle Trackers
| Direction | Data provider |
| Data | Movement data |
| Platform | Gundi v2 |
| Type | Pull integration |
Ctrack Crystal sends vehicle positions to EarthRanger through Gundi. Gundi checks your Ctrack Crystal account every 10 minutes for new trips, and the positions along each trip show up as tracks on the map.
What you'll receive
We add details here as we confirm what Ctrack Crystal sends. If you know something we're missing, let us know.
| Positions | Yes, from every vehicle on your Ctrack Crystal account, named after the vehicle's display name. Positions come from recorded trips, so a parked vehicle sends nothing new until its next trip. Trips Gundi already sent are not sent again. |
| Alerts and events | No |
| Sensor readings | Speed, heading and compass direction, distance travelled, and the event text Ctrack Crystal attaches to each point. |
| Photos and files | No |
| Past data | Yes. The first time Gundi sees a vehicle, it fetches its trips from the start of the previous day. If checks stop for a while, Gundi catches up on up to the last 3 days. |
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.
This integration requires assistance from CTrack Crystal. Please get in touch with our Support Team at support@earthranger.com if you need help at any point during this process.
Prerequisites
CTrack Crystal
You will need:
- Subscription Key, also called “Primary Key”
- Username and Password associated to the Key.
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.
Integration Process Summary
- Contact CTrack Crystal to start the integration process.
-
Request the following API credentials for the EarthRanger/Gundi integration:
- Primary Key
- Username
- Password
-
Contact the EarthRanger Support Team (support@earthranger.com) to:
- Request access to the Gundi Portal, or
- Ask us to configure the CTrack Crystal connection for you.
Configuration
GUIDES
1. Gundi Connection Settings
1.1 Login to Gundi.
1.2 Click Create Route.
1.3 Select CTrack Crystal.
1.4 Select your Workspace.
1.5 Enter a name for this Route under Route Name (e.g, Ctrack Crystal - AreaName)
1.6 Configure your subscription key, username, and 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.,
"ctrackcrystal")
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.
Data Pull Frequency
Approximately every 10 minutes.
Other Vehicle Trackers
| Avis Pulse | Baytrac | BIDTRACK |
| CarTrack | Gesfrota |
| Back to the integration catalog | Need help setting this up? Contact us |
