RouteSync is a licensed add-on feature that sends routes planned on back-office systems directly to CoPilot navigation on a driver’s device. It helps ensure drivers follow prescribed routes in situations where route compliance and consistency are essential.
RouteSync passes a long series of latitude/longitude coordinates of the planned route into CoPilot. CoPilot then generates a route that follows those prescribed coordinates, and it provides feedback with “out-of-route” notifications for drivers and fleet administrators.
RouteSync can be integrated with CoPilot using CoPilot SDK or CPIK, which include APIs that receive predefined locations in a JSON format that includes a string of coordinates as well as other route information and settings.
The managed route information sent to CoPilot can be created using:
Your existing back-office systems to send a list of coordinates
Trimble MAPS RouteSync Web APIs to create a JSON
PC*MILER Connect, our DLL for desktop applications, to create a JSON
Typical Uses of RouteSync #
RouteSync is designed for routes that require a specific route path to be followed between each stop—whether or not that path matches standard CoPilot routing. Common uses include:
Long-haul or local trucking routes, where the origin, destination and intermediate stops for pickups and deliveries are set—with limited changes after dispatch—and you want to make sure the driver follows specific roads between the stops.
School bus routes, where the pick-ups or drop-offs are set, and you want the driver to follow a specific planned route between those points.
Municipal or utility routes that often involve circling around the same block or doubling back along the same road—with what is a seemingly very inefficient route between a very small number of stops. (Might require special configurations for the best user experience.)
How Does RouteSync Work? #
Generating the Route #
When CoPilot receives a RouteSync input list for the roads you wish the driver to follow, it generates a route that:
- Ensures all input locations are successfully passed.
- Adheres to any road restrictions for the vehicle routing profile.
During the Trip #
A level of route compliance can be sent with the managed route to CoPilot. It indicates how strictly CoPilot should try to return to the original (sent) route in the event that the driver is out-of-route. The three possible compliance levels are:
Strict: CoPilot will try to navigate back to the original route at all costs, even if it means the driver needs to turn around and drive back to re-join the prescribed route.
Moderate: CoPilot will try to navigate back to the original route but will take into account the driver’s current position; i.e. CoPilot will try to rejoin the prescribed route as it navigates towards the destination, but along a route that is more reasonable than the Strict compliance level would follow.
Minimal: The original prescribed route is not taken into consideration. The new route planned may still rejoin the original route, but its first objective is to navigate to the destination from the driver’s current position. If the driver does re-join the original route, CoPilot will continue as previously planned.
What Does the Driver See? #
Once the RouteSync file has been sent to CoPilot, CoPilot will provide a pop-up notification informing the driver that a route has been received. When the file has been downloaded and processing has been completed, a second pop-up will appear. This pop-up will allow the user to accept the route and also to view the details.
Out-of-Route Notifications #
If the driver doesn’t follow the prescribed route and deviates onto another road, CoPilot will provide a notification to the client application that the driver is no longer on the planned route. The notification includes latitude, longitude, UTC time and UTC date as well as city, state or country.
Once the driver returns to the route, another notification will be provided, including the distance the user has driven since leaving the route. Notifications will also be provided each time the driver leaves and rejoins the planned route. Once the driver reaches the final destination, a notification for total distance out of route will be provided.
The SDK and CPIK APIs make it possible to set a distance off the planned route the driver is allowed to deviate before a notification alert is generated. The default value within CoPilot is 0.2 miles.
Managed and Unmanaged Route Options #
There may be instances when you only wish to have part of the route managed. For example, a situation where navigating from the current location is not important but once the driver reaches the city, it is very important to use specific roads to reach the destination. In this instance, it is possible to have a partially managed route.
With each route that is passed into CoPilot, if the first location is greater than 5 miles from the current GPS position, CoPilot will navigate the user to the first location not under managed conditions. Therefore, if the driver is to leave this initial part of the route:
- There will be no notification as out of route.
- The route guidance will not follow any strict route recalculations to return until the beginning of the managed route section.
Routes on Restricted Roads #
What happens when the pre-planned route drives via a road CoPilot believes is restricted? (e.g. A height restriction that conflicts with the vehicle size.)
CoPilot will generate the route requested ignoring the road restrictions. But once navigation begins CoPilot would provide its normal notifications and warnings, as necessary. These alerts are available on screen to the driver and via the SDK or CPIK API calls.
If the route planned takes the driver onto a road CoPilot believes is unsafe to provide guidance—for instance, the height-restricted road when the vehicle dimensions are greater —CoPilot will stop all audio and visual guidance for the duration of the restricted road. This is how CoPilot behaves in standard routing situations.
Read more about RouteSync:
- Web API Documentation
- CoPilot Feature Guide
- CoPilot SDK Libraries API Documentation
- CoPilot SDK App API Documentation
Share this article: