Skip to content

Version 10.9.0

CoPilot Version 10.9.0.1049

Platform Released Release Date
Android CPIK May 2019
Android SDK

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

Platform Released Release Date
Android CPIK March 2019
iOS CPIK
Windows Laptop SDK
Android SDK

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

Platform Released Release Date
Android CPIK February 2019
Android CPIK Xamarin
Windows Laptop SDK

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 WiFi 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

Platform Released Release Date
Android SDK January 2019

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

Platform Released Release Date
Android SDK December 2018
Android CPIK
Android Xamarin CPIK
iOS CPIK
Windows Laptop SDK

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 higher

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
    • Wi-Fi only 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

Platform Released Release Date
Android SDK October 2018
Android CPIK
Android Xamarin CPIK
iOS CPIK

New Features

  • Custom Location and Routing Content: ALK Content Tools, 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 ALK Content Tools 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 ALK Content Tools 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 ALK Content Tools 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 ALK Content Tools 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 behaviour 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 behaviour 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

Deprecated API Replacement API Notes
CopilotMgr.init() Not Applicable This API is no longer required in a CoPilot CPIK Integration and has been deprecated
TruckDimensions
getMapZoomLevel MapDrawer.getZoomLevel
RoutingProfile VehicleRoutingProfile
TruckRoutingProfile VehicleRoutingProfile
RoutingProfileBase VehicleRoutingProfile
RouteMgr.addStop RouteMgr.addStop (AddStopPurpose, Stop, RoutePreviewMode) Same name different structure and now includes AddStopPurpose
RouteMgr.addStops RouteMgr.addStops Same name different structure and now includes AddStopPurpose
RouteMgr.getActiveRoutingProfile getActiveVehicleRoutingProfile
RouteMgr.getActiveTruckRoutingProfile getActiveVehicleRoutingProfile
RouteMgr.setActiveRoutingProfile (RoutingProfile) setActiveVehicleRoutingProfile (VehicleRoutingProfile)
RouteMgr.getActiveProfileType getVehicleRoutingProfiles
RouteMgr.getRoutingProfiles() RouteMgr.getVehicleRoutingProfiles

SDK

Deprecated API Replacement API Notes
VehicleType EVehicleType Extended Enum to cater for increased number of vehicles available within CoPilot
Msg_SendRoutingProfile MSG_IDT_ADDROUTINGPROFILE
Msg_RequestRoutingProfile MSG_IDT_ROUTINGPROFILE_REQUEST
Msg_RoutingProfileGet MSG_IDT_ROUTINGPROFILE_REQUEST
Msg_SendTruckRoutingProfileEx MSG_IDT_ADDROUTINGPROFILE
Msg_RequestTruckRoutingProfileEx MSG_IDT_ROUTINGPROFILE_REQUEST
Msg_TruckRoutingProfileGet MSG_IDT_ROUTINGPROFILE_REQUEST
Msg_TruckRoutingProfileGetEx MSG_IDT_ROUTINGPROFILE_REQUEST