Overview
The Platform is Electronic Logging Device (ELD)/telematics agnostic, allowing you to use any ELD provider you prefer. That said, we also offer a direct integration with Geotab. If you’re utilizing any other ELD/telematics provider please refer to the In-Motion Locking guide and Driver Status API for hours of service (HOS) capabilities.
How It Works
Geotab
The Geotab integration grants users access to several Geotab features such as managing HOS compliance, driver-vehicle inspection reports (DVIRs), and engine maintenance alerts.
IMPORTANT: The direct Geotab integration includes per-driver charges. Consult your Eleos Platform reseller or Eleos Account Executive for more information.
TIP: You can use Geotab without the direct integration by passing HOS information through the Driver Status API instead, eliminating these charges.
Enable the integration within App Manager by configuring the Geotab service account credentials under App Configuration > Service Config > Geotab Configuration. When returning the telematics object in the User Authentication API, the payload requires specific properties:
providerset togeotab-drivehours_of_service_rulesset to the appropriate HOS ruleset for users utilizing the ELD{ "api_token": "ddb56eb8-1b39-11e5-9c63-f9bd05003d3f", "full_name": "John Doe", "telematics": { "provider": "geotab-drive", "hours_of_service_rules": "AmericaShortHaul8DayNo34h" } }
Supplying the telematics object enables the Geotab integration on a per user basis. When users first log into the mobile app, their user account will be connected with a matching account in Geotab's system. If no account for the user exists in Geotab, one will be created. Additionally, if a user is archived or deleted within a Geotab database, the Platform will un-archive or recreate the Geotab user as long as the telematics object remains present in the authentication response. For details regarding account creation and control options, refer to the provider property in the User Authentication API.
A complete solution requires enabling the manage_shipments flag within the telematics object. Systems must mark the current load with the include_in_compliance_report flag to keep roadside inspection reports up-to-date with identical information presented in the mobile app.
NOTE: The DOT and
full_nameproperties are only applied when a Geotab user is first created — they will not update an existing user's properties.
HOS Card Configuration
The HOS dashboard card displays a summary of hours of service information and optionally provides access to an ELD. For users with the integration enabled, the Platform retrieves HOS status directly from the telematics provider and populates the HOS card with Geotab data rather than pulling from the Driver Status API. Users can then access the Geotab Drive app by selecting the HOS card without re-entering credentials. Please refer to our App Manager Help Center article to learn how you can add the HOS dashboard card via App Manager.