Version 10.9

CoPilot Version 10.9.0.1385

Enhancements

• Google Play Update: Updated CoPilot apps in the Google Play store to comply with Google’s requirement that all apps support 64-bit architectures.
• Map Downloads: Updated the Msg_DownloadMap API in the CoPilot SDK so that when a map update is downloaded it will overwrite existing map data for that same region on the device.

Bug Fixes

Fixed an issue where CoPilot was not immediately providing guidance to the next stop after leaving a stop location that includes a Site (geofence).

CoPilot Version 10.9.0.1322

Enhancements

• European tunnel codes can now be set in the CoPilot SDK via the HazType field in Msg_SetRoutingProfileJSON.

Bug Fixes

• Fixed an issue that caused a depot to be added as an extra stop at the end of a route when calculating ETA using our Advanced Optimization API.
• Fixed an issue that could cause certain APIs to generate unexpected results when using the latest SDK and an earlier version of CoPilot.
• Fixed an issue that was causing missing or inconsistent railroad crossing alerts.
• Updated data types in MapInfo parameters in the CoPilot SDK to ensure backwards compatibility with older versions of CoPilot.
• Fixed an issue that was causing the “Now Approaching” popup to persist on the screen when it should automatically disappear 15 seconds after the final stop.
• Fixed the error message to note that the latest map data is already installed if “Check Map Update” is selected on the CoPilot SDK and CoPilot is already using the latest map data.
• Fixed an issue with the CoPilot laptop build that could cause CoPilot to ask for a product key each time it is opened.

CoPilot Version 10.9.0.1268

Enhancements

The Sites feature, which allows you to create a polygonal geofence around an area of interest such as a yard or a distribution center for more precise routing, has been updated.

• Callbacks were added that can notify a partner app when CoPilot identifies the vehicle crossing into or out of a Site, based on the Site boundary. This can be used to flag that a vehicle is “on Site.”

• A new trigger was added for automatic Arrival when crossing into the Site—if and only if there are no Gates defined for that Site, and no intra-Site roads exist.

Our Android SDK is now available with x86_64 library files. This allows CoPilot integrators to comply with the upcoming Google Play store requirement that all new apps and app updates that include native code also provide 64-bit versions.

Bug Fixes

• Fixed an issue that could cause CoPilot to crash on occasion in certain integrations when initiating navigation.
• Fixed an issue that could cause CoPilot to close when passing in each leg of a RouteSync managed route, one at a time.
• Fixed an issue in the Msg_MapActionRequestSpecific API that could cause one downloaded map region to overwrite another.
• Fixed an issue that could cause CoPilot to freeze when an SD card is removed while the app is running.
• Fixed an issue that could cause inconsistent display of railroad alerts.

CoPilot Version 10.9.0.1238

Enhancements

A route preview screen can now be called to the forefront of the CoPilot user interface using UIMgr.showDialog(). This feature can be used, for example, to display a route preview when sending managed routes to a driver’s device via RouteSync.

Bug Fixes

Height and weight restrictions for the Rotherhithe Tunnel in London have been updated so vehicles more than 6 feet, 6 inches high or 2 tons are not routed through it.

Fixed the configuration setting that turns off RouteSync pop-up messages so that it now suppresses all RouteSync messages.

Fixed the map download display so it shows accurate percentages for the progress of a download.

Fixed an issue in the Msg_DownloadMap API that could cause an incorrect error message when downloading a second map region.

CoPilot Version 10.9.0.1180

Enhancements

Three new configuration options were added that allow you to:

• Choose whether to use the side of street provided by the address or by the latitude/longitude coordinates in the event that they provide conflicting information.

• Add a customizable banner to the top of all navigation views. It can display your choice from a wide range of information related to the current trip.

Road restrictions on the map: A new API, setDisplayRoadRestrictionOnMap, was added to the VehicleRoutingProfile. It allows you to disable the display of road restrictions on the map—the same action as the Display road restrictions on map setting in the CoPilot user interface.

Typing hints: The typing hints available when using the CoPilot DLL in Visual Studio were improved.

Low Bridge Warnings Disabled: CoPilot always generates routes that avoid bridges that are too low based on a vehicle’s height. Low bridge warning alert messages, however, have now been disabled by default.

Bug Fixes

• Fixed an issue that could cause the CoPilot sample app to crash when coordinates are entered in an incorrect format.
• Fixed an issue that could cause CoPilot to navigate the driver to perform a U-turn when there is a left turn lane available.
• Fixed an issue that could cause the application to freeze during shutdown.
• Fixed an issue that could prevent a user from re-initiating a data download after it had been paused by disabling Wi-Fi.

CoPilot Version 10.9.0.1098

Enhancements

FleetPortal URL Launch: The URL Launch feature can now be used to set up a device so it can connect to CoPilot FleetPortal.

(Note: FleetPortal was decommissioned on Nov. 8, 2023 and all functionality was migrated to the Account Manager application.)

Error codes have been enhanced for the “Pause” function within Optimization.

Bug Fixes

• Fixed an issue where RouteMgr.IsCoPilotReadyToAddStops was not being triggered properly.
• Fixed a crash that could occur when hitting the back button in the CoPilot SDK sample app.
• Fixed an issue that could cause CoPilot to freeze when resizing a screen.
• Fixed a crash that could occur if an empty string value is passed into the PARTNER_ID configuration setting for FleetPortal.
• Fixed an issue where some files input into CoPilot were not being closed after use, potentially causing memory leaks.

CoPilot Version 10.9.0.1049

Enhancements

Alternate Route Calculations: Integrations with the CoPilot SDK can now be set up to alert a user when an alternate route has finished calculating.

Bug Fixes

• Fixed an issue that caused addresses generated from a geo URI to disappear unexpectedly.
• Fixed an issue that could cause CoPilot to crash when using custom Point of Interest (POI) icons.
• Fixed an issue that could cause incomplete downloads of map data.
• Fixed the appearance of icons during an initial launch of CoPilot.
• Fixed the Vehicle Routing Profile user interface so that entering a new name doesn’t undo previously entered changes to the profile.

CoPilot Version 10.9.0.992

Bug Fixes

• Fixed an issue where the CPIK API RouteMgr.selectAlternateRoute() does not work when the user specifies PREVIEW_TRIP_MAP_NO_WIDGET mode.
• Fixed a threading issue that could cause CoPilot to crash during the map differential request process.

CoPilot Version 10.9.0.958

Enhancements

• Safety Warnings: Added a customer setting to stop the Safety Alerts & Warnings menu from opening when the user taps on the speed limit sign in the navigation screen.

Bug Fixes

• Version Upgrades: Fixed an issue that prevented the installation of a CoPilot version upgrade when the installation files were in external storage.

• Code Optimization: Fixed an issue that was causing error warnings after running ProGuard optimization.

• GPSDevice.sendGPSLocation(): Fixed an issue that caused CoPilot to crash in certain circumstances when calling the GPSDevice.sendGPSLocation() API.

• Map Downloads:

  • Fixed an issue the would prompt users to download map updates over a cellular network after Wi-Fi was disabled and restarted during a download.
  • Map downloads over a cellular network now support switching back and forth from Base to Energy or Energy to Base map data sets.
  • Fixed an issue that was preventing new map differential updates from patching in CoPilot v10.
  • Fixed an issue that was preventing the resumeMapDownload API from working properly.

• SD Cards: Fixed an issue that was causing CoPilot to be unable to find maps stored on an SD card on certain devices.

• Profiles at Startup: Fixed an issue that could cause CoPilot to prompt the user to create a Vehicle Routing Profile upon every launch.

CoPilot Version 10.9.0.906

Bug Fixes

• URL Launch: Fixed an issue that was causing CoPilot to crash when sending addresses via URL launch. This only affected inner-city areas on specific devices.
• Change Device Feature: Fixed an issue that was disabling the Change Device option even when it was enabled via configuration values. By Default this option is hidden and only applicable for Generic license users when deactivating that license from a device.
• Pop-up configuration: Within CoPilot, it is possible to disable pop-up messages via configuration values. It was reported that the menu and zoom buttons were also being disabled. This has been corrected to ensure only pop-up messages are disabled.

CoPilot Version 10.9.0.857

Enhancements

• Activation: The CoPilot Integration Kit (CPIK) now supports offline activation.
• Time-Based Truck Restrictions: CoPilot routing now supports time-based truck restrictions, such as those set under the London Lorry Control Scheme.
• Location Services Warning: A new configuration setting was added that allows you to disable the “Location Services are currently turned OFF” pop-up warning message.
• CPIK Fragment Sample Application: The app was updated to provide support for Android 8.1 and Later

Bug Fixes

• Translation: Corrected the language translation of details such as current location, stops and waypoints in the user interface.
• CPIK Improvements
  • Fixed a crash that could occur in the CPIK Xamarin Fragment sample app when trying to run optimization batch files
  • The POI search function was updated to only include results from the categories requested
• Trip Preview: Fixed an issue that could cause the active trip to be deleted when closing a Trip Preview
• Custom Buttons: Fixed an issue that could cause user-created custom buttons to disappear from the CoPilot user interface
• School Bus Routing: School bus RouteSync blobs now support the AutoSetStopDirection and WrongSideOfStreetCostX1000 configuration settings
• RouteSync v2 Binary Format:
  • Fixed an issue with format compatibility when sending and receiving RouteSync blobs (affects PC*Miler 32, CoPilot 10.7, and CoPilot 10.9)
  • Fixed an issue with v2 binary RouteSync not supporting updated road class types
• Over-the-Air (OTA) Downloads
  • Fixed an issue that caused CoPilot to restart instantly when downloading map data on the first run
  • Fixed the DLSucceeded return code when using the SDK API for map downloads
  • Fixed other issues the could cause crashes when a user tries to pause, cancel or resume downloads via APIs
  • WiFiOnly configuration option no longer affects the use of Traffic or Single Search features
• URL Launch: Fixed a crash on route calculation with URL Launch

CoPilot Version 10.9.0.754

New Features

• Custom Location and Routing Content: ContentTools, a web tool where you can create and manage custom location and routing content, includes multiple new features that can be shared with CoPilot to generate precise first- and last-mile guidance and provide drivers with the information needed for on-time deliveries. (Currently only available in North America) New features include:

  • Sites: Sites improve routing accuracy and driver guidance by defining exact entrance and exit points as well as how the driver should approach and depart a location. You can also improve customer service by communicating important location-specific information to a driver—right at the point of arrival. (Requires ContentTools to create and manage Sites and CoPilot FleetPortal for delivery to the device)
  • Place ID Search: Drivers can add stops to their trip by searching for a unique Place ID rather than waiting for dispatches. A Place ID, for example, can be created to match an existing Customer Code, Location ID, Store ID, etc. (Requires ContentTools to create Places and related Place IDs)
  • Custom Places - Multiple Sets Support: Custom Places can be grouped together in custom sets (e.g. customers, terminals, rest stops, etc.). These sets not only make searching for Places easier, but also can help avoid confusion—you can limit drivers to only seeing sets that apply to them. (North America only. Requires ContentTools to create and manage custom Place sets, and CoPilot FleetPortal to assign those sets to vehicle groups)
  • Custom Route Modifiers - Multiple Sets Support: Similar to Places, custom Route Modifiers (roads to avoid, favor or close) can be grouped in sets to improve route results by applying the appropriate set to each vehicle group. (Requires ContentTools to create and manage Route Modifier sets, and CoPilot FleetPortal to assign those sets to vehicle groups.)
  • Custom Places - Differential and Performance Updates: A new, more efficient method of synchronizing custom Places with CoPilot reduces data consumption. Performance has been improved when processing updates to large custom Place sets (e.g. 10,000+ Places).

• Driver Map Feedback: Drivers can provide direct feedback from within CoPilot to improve our map data and reduce errors in stop locations received through dispatch integration with CoPilot. (North America only)

• School Bus Vehicle Routing Profiles: Two new Vehicle Routing Profiles have been added for school buses—Conventional School Bus (48-foot) and Small School Bus (29-feet, 6 inches.) These profiles also include new settings to prohibit U-turns and ensure the route strongly adheres to the side of street needed for student pickups and dropoffs. (North America only, applicable license required)

• Canadian Postal Code Search: Canadian postal codes can now be entered to search for cities when entering stops for a route.

• CPIK Logging and APIs: The CoPilot Integration Kit (CPIK) includes a new logging feature that can help to better identify issues that arise when calling APIs. Multiple APIs have also been added or updated in CPIK, including:

  • Motion Lock Modes: Customize Motion Lock, a safety feature that locks the navigation screen when a vehicle is in motion, to allow access to more or less of the user interface when it is enabled.
  • Single Search: Take advantage of a single search web service to improve searches for Place names and addresses in the CoPilot map data. (Internet connection required)
  • Add or Delete Stops: Insert a stop into or delete a stop from CoPilot’s active route, and set the plan trip screen to show stops with no widgets.
  • Nearest Street: Find the nearest street names by passing a location to CoPilot.
  • Chevron Display: Customize the chevron display, a widget containing text related to your current trip, depending on the type of information you would like displayed for drivers.
  • Routing Profile: Create a detailed Vehicle Routing Profile—including new settings for governor speed and elevation limits (North America) only—and set it as the current profile in CoPilot.
  • Road Speeds: Road speeds, which are used to calculate ETA, have been removed from the Vehicle Routing Profile and can now be set via APIs based on jurisdiction (state/country), vehicle type, road class and more.
  • Governor Speed: Set a maximum speed for your vehicles.

• Sample Applications: Two sample applications can help you more easily learn how to integrate CoPilot into your application—Skeleton, a quick start application; and Fragment, which includes a more comprehensive overview of the API offered.

• Display and Alerts: Several new features have been added to enhance the CoPilot display and the alerts provided for drivers.

  • Differentiated Route Lines: CoPilot can provide visual differentiation between managed route paths (e.g. RouteSync, first/final mile for Sites) and CoPilot-generated route paths.
  • Low Bridge Warning: CoPilot will provide an audible and visible warning up to 2,000 feet in advance of a height restriction (based on the user’s routing profile) when there are no safe alternative routes—whether or not there is an active trip.
  • Tunnel Code Icons: The navigation screen can now show the tunnel category for hazardous materials on the map. (Europe only)
  • Map Toggle: A new button on the trip planning map allows you to toggle among a full route view; a zoomed in view of the origin; and a zoomed in viewed of the destination.

• Advanced Optimization: CoPilot’s Advanced Optimization, a premium add-on feature that allows you to optimize a delivery manifest into an efficient and achievable route, has been enhanced with new options, including:

  • Unique ID for Optimization Clustering: Create unique IDs for stops that should be clustered together when optimization is performed. (Applicable license required for Advanced Optimization)
  • Historical Traffic: Take historical traffic into consideration when calculating optimized routes. (Applicable license required)

Enhancements

• Build consolidation: Licensing improvements have been made to CoPilot removing the need to have a different build based upon the licensing type that is being used. Enterprise keys and single use keys can be used in the same build. This will result in a slightly different behavior which is captured under the Licensing feature guide.

Note: If upgrading to 10.9 and using Enterprise licensing CoPilot will show a Product Key entry screen on first launch. This is expected behavior due to the build consolidation. Please wait for the relevant licensing callbacks and activated CoPilot via API.

• Routing and ETA: Routing and Estimated Time of Arrival (ETA) enhancements are an important part of every CoPilot release. Highlights in CoPilot 10.9 include:

  • Side-of-Street Settings: CoPilot’s adherence to side-of-street routing—routes that put the driver on the same side of the road as a stop location—can now be set for each individual stop on a route, rather than just globally for the entire route.
  • Stop Information: Additional information can be displayed for each stop on a route to help drivers keep on schedule, including: the planned duration of the stop (dwell time), driver notes specific to that stop, and a custom icon for that stop. (Applicable license required for Advanced Optimization or Advanced ETA.)
  • ETA Alerts: Drivers can receive API callbacks to help them quickly see whether they are early, on time, at risk of being late, or late for a delivery window. (Applicable license required for Advanced Optimization or Advanced ETA.)
  • Map Routing Views: Routing lines on the map show different colors to help drivers differentiate between the route to the next stop and the route to all the stops thereafter.
  • Improved Truck Preferred and Hazmat Preferred Routing: Truck routing was altered to better reflect the intent of a town’s road regulations, allowing for better Truck and Hazmat routing when source data is less than perfect. (European truck routes only)
  • Restricted Ramp Routing (Austria and other areas of Europe): CoPilot will no longer avoid motorway ramps that are truck restricted, but allow deliveries, if a vehicle is making a delivery stop in that local area.

• Extended Truck-Specific Speed Limits: The combination of a new data provider plus use of Jurisdiction-wide Rules allows CoPilot to display truck-specific speed limits in areas where truck and automobile speed limits differ. (Available worldwide)

• Improved Guidance Instructions: Guidance instructions, both text and audible, were updated in a number of areas, including:

  • Complex Turns: Instructions for U-turns and complex junctions have been further simplified.
  • Lane Divergence: The logic used for lane divergence instructions (e.g. “Use the X left/right lanes to stay on Y”) was updated to provide this guidance in more situations.
  • Merge: Merge instructions were updated to eliminate occasional, unnecessary instructions, such as “Keep Right” when merging onto a highway from a ramp.
  • Stay on Road: The number of situations where CoPilot will give an instruction, even though the user is just staying on the same road, has been streamlined.
  • Turns vs. Ramps: Instructions have been improved to help avoid situations where CoPilot would refer to a protected turn as a “Ramp.”

• ActiveTraffic Distance Controls: The configuration used to determine the maximum distance ahead to look for traffic information was updated. This will also manage the display distance shown in CoPilot navigation screen. (Applicable license required)

• Extended OTA Map Download Configurations: Further configurations are now available for partners to manage data usage for over-the-air (OTA) map downloads at startup.

• Mute Button on Navigation Screen: Drivers can mute guidance instructions with one touch in high stress situations requiring minimal distraction.

• Increased Contrast for Truck Restricted / Discouraged Roads: Certain map styles made it difficult to easily identify restricted and discouraged road links. This has been resolved.

• Improved Heading from Stop: The logic that determines the best direction of travel when returning to the road from a stop (e.g. driver is in a rest stop parking lot) has been improved.

• Better Non-OpenGL Map Performance: Several minor tweaks have been made to map performance, particularly on lower power Windows devices.

• Alternate Route Creation Display: When calculating alternate routes on lower power devices, CoPilot provides better communication with the driver on the process status.

• Faster Search: The speed in returning typeahead results on address searches, especially when spaces are included in names (e.g. San Francisco), has been improved.

• Support File Download: To ensure the latest language, voice and other support files are present on CoPilot following upgrade to a new version CoPilot will request these support files to download. If CoPilot is closed prior to the download of these files CoPilot will request via a popup to continue with the download. To remove this request and subsequent popup please see the Live configuration values available in the CoPilot Feature Guide

Bug Fixes

• Stability: Many fixes have addressed device-specific and edge case crash and app non-responsive (ANR) triggers.
• Tunnel Mode: Now provides more effective navigation when in a tunnel and no GPS signal is available.
• Localization/Translation: Improved the translation of many driver-facing text strings, and added translations for a few previously missed ones.
• RouteSync Notifications: The RouteSync icon is once again immediately presenting upon receipt of a new RouteSync trip rather than waiting until it has fully processed and become active.
• RouteSync Notifications: Audible notifications are now spoken in the correct order, matching the visual notifications for “New Route Received” and “New Route Now Active.”
• RouteSync Stop Display: CoPilot is now properly displaying address instead of stop lat/long on RouteSync routes.
• Corporate Routing Profiles: Modifying a routing profile defined in CoPilot FleetPortal will no longer cause duplicate corporate routing profiles in CoPilot Truck when its name includes a trailing space.
• RequestUpdate API: This API is now properly returning values for available map data quarter, year.
• Display Units: Value display units (e.g. kph) have been corrected in Android market applications.
• Push Notifications: Push notifications should no longer be received when a user opts out of them.
• Alternate Route Button: The performance of the Alternate Route button has been improved.

Deprecated APIs

CPIK

SDK