AngelTrack can pull vehicle data from your RoscoVision / RoscoLive fleet management account, providing live vehicle geolocations for AngelTrack's use.
RoscoLive is a brand of vehicle-tracking devices and associated software platform. It has an API by which AngelTrack can poll for live vehicle GPS positions.
Configuration
To configure the AngelTrack-RoscoLive integration, follow these steps:
- You must have a active RoscoLive account.
- You must have an active AngelTrack add-on license for the "AVL Integrations" feature bundle.
- In AngelTrack, go to Settings, and click on the AVL Integration item.
- Input your RoscoLive email and password for RoscoLive into AngelTrack, and click "Save".
- Review all your vehicle records in AngelTrack to verify their VINs are present and correct. You can check them all quickly by exporting the grid from the Vehicles List page and finding the "VIN" column.
- Review all your vehicle records in RoscoLive and likewise verify their VINS are present and correct.
That's all there is to it!
AngelTrack will begin polling RoscoLive for your vehicle data within 40 minutes of completing the authentication steps above.
How It Works
When the RoscoLive integration is active, AngelTrack polls RoscoLive about once per minute for the positions of your entire fleet. This data comes from the RoscoVision devices installed in the vehicles.
For every vehicle that returns a valid position which is less than 20 minutes old, AngelTrack stores the new position in its own record for that vehicle. This matchup of RoscoLive's fleet records with AngelTrack's vehicle records is done using VINs.
The position data then informs many other features in AngelTrack, including but not limited to:
- The "distance away" column on the Dispatch Assignment page;
- The mini-maps on the Dispatch Create, Dispatch Assign, and Dispatch Divert pages;
- The estimator arrows on the dispatch board;
- Crew member pins on the Live Map;
- Vertex's mid-day solves and suggester;
- Vertex's self-drive mode; and
- The vehicle locator mini-map in the Vehicle Edit page.
To learn more about crew and vehicle GPS tracking in AngelTrack, please visit the GPS Tracking Guide.
Fuel level and odometer information is not available from RoscoLive.
Monitoring
You can review each vehicle's position and latest-ping time by visiting its Vehicle Edit page, from your Vehicles List. The time of its latest ping is shown, and it will appear as a pin on the mini-map.
You can review all of your vehicles at once by visiting the GPS Beacon Status page, available from Supervisor Home.
If any problem occurs with the RoscoLive integration, its error message will appear on the AVL Configuration page, available under Settings. AngelTrack's RoscoLive downloader will automatically back-off for 4, 8, or 12 hours if an error occurs or if no data is returned, then automatically retry afterward.