Version 10.19

CoPilot 10.19.4.348

New Features

Set a profile and activate CoPilot with URL launch

Two new features have been added to CoPilot’s URL launch capabilities. You can now:

• Select a Vehicle Routing Profile by name.
• Activate CoPilot on a device using a product licensing key.

URL launch parameters and settings are also no longer case sensitive.

Removed Features

The requirement that CoPilot ask the user to enable permission for location services to run in the background on a device has been removed. Only permission to run in the foreground is required.

Enhanced Features

The minimum Android API level has been raised to 24 and the target level has been raised to 32 (Android 12) for apps that integrate navigation using the CPIK Libraries. As a result, this and future versions of CoPilot require devices that are running Android 7 or later. Read more about this change.

The pop-up message that asks a driver if they are OK with using cellular data to download maps is now disabled by default. The pop-up is controlled by the following config setting:

[CellDataUsage]
DisableCellUsagePrompt=1 //1 is disable; 0 is enable

Bug Fixes

Fixed an issue that could cause the CoPilot SDK to freeze during license activation.

Fixed an issue that could prevent the download of maps via automatic updates.

Fixed an issue that caused CoPilot to announce the coordinates of a location upon arrival, rather than the location’s name.

Fixed a missing space between the address and postal code in the MAP screen.

CoPilot 10.19.3.48

New Features

Integrate with Trip Management

CoPilot integrations using the SDK App or CPIK Libraries can now receive trips created in the back office via our Trip Management service. With Trip Management, CoPilot sends back GPS pings and stop status updates so a fleet administrator can monitor a trip’s progress. CoPilot also displays notifications for the driver when a trip has been received, modified, or canceled by the back office.

Share Data with Technical Support

The Trimble Maps technical support team can now remotely retrieve log files and config files to help troubleshoot CoPilot on a specific device. This feature can speed the process of identifying and resolving questions related to the CoPilot application and the routes it generates.

Enhanced Features

Updated React Native Sample App - The CPIK Libraries React Native (iOS and Android) sample apps have been updated to include more of the available APIs. CoPilot sample apps allow you to view the features available within CoPilot alongside the APIs required to control them.

Fewer Pop-up Messages - CoPilot no longer displays, by default, pop-up messages from FleetPortal and MapExact at startup. These messages include things such as “A fleet admin has updated your custom places.” To turn this feature back on, add the following lines to the product.cfg file:

[Fleet Portal]
"ShowIntegrationPopup"=1

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

Improved traffic Messages - The messages CoPilot displays related to the availability of ActiveTraffic have been updated:

• If CoPilot cannot connect to traffic servers, the navigation screen will display, “Traffic Currently Unavailable.”
• If CoPilot can connect to traffic servers, but there is no traffic data coverage for your entire route:
  • No banner will be shown on the navigation screen.
  • The traffic bar will remain gray, but when the user taps on the traffic bar to bring up the Traffic Map screen, CoPilot will show a popup stating “Traffic information is not available for this trip” with an “OK” button. Tapping OK will allow the user to pan through the Traffic Map and see traffic data coverage in other areas.

Improved Account Manager IDs - The slash character “/” can now be used in Asset IDs in Account Manager for use in CoPilot. Account Manager uses Asset IDs to identify devices that have been assigned licenses to run CoPilot.

Environmental Zone Warnings - Callbacks are now available for CPIK integrations to warn when a stop is located in a London congestion zone, environmental zone or ULEZ (Ultra Low Emission Zone) or when a route passes through one of those zones.

Updated Translations - Incorrect or missing translations were added or updated.

Updated CoPilot EULA - CoPilot’s EULA (End User License Agreement) has been updated.

Updated Planning Screen - The Optimize Stops and Load Trip options are now inaccessible from the MAP planning screen when the current trip is sent from the Trip Management service.

Removed Features

The “Enable Trip data sharing for Support” option was removed from the Account Manager and FleetPortal web tools. Instead, if the RouteReporter route compliance add-on web tool is enabled for your account, CoPilot will automatically share trip data.

Deprecated settings and APIs in this version include:

• The ShowCompliancePopup config has been deprecated to prevent drivers from choosing whether or not a trip should be logged for route compliance.

• The 53FootRouting setting (North America only) in Vehicle Routing Profiles has been deprecated because it generates the same routes as the NationalNetwork setting.

Bug Fixes

Fixed an issue that prevented CoPilot from replacing the current trip with a new trip sent via URL launch.

Fixed an issue that caused CoPilot to take a long time to load on startup when an account had a lot of Route Modifiers (avoids, favors, closures).

Fixed an issue that prevented CoPilot from accepting a route from a partner application when it does not have a GPS fix.

Fixed an issue that caused CoPilot to generate routes using roads that are marked as “Avoids” in ContentTools.

Fixed an issue that prevented clickable URL launch links that start with “http” or “https” from working in Android 12. Any existing implementations using the http://www.copilotlive.com/copilot/android? format, need to instead use https://copilotgps.com/copilotgps? as the base URL.

Fixed an issue that prevented a governor speed value passed into CoPilot via the Msg_SetRoutingProfileJSON API from getting applied properly in CoPilot.

Fixed the CPIK StopBuilder API so that ArrivalTimeWindowInfo uses local time rather than GMT time.

Fixed an issue that caused CoPilot to calculate Time Window Optimization ETAs when an empty stop list was passed.

Fixed an issue that caused CoPilot to display unknown addresses as “City Center” rather than “Unnamed Road.”

Fixed the equals() method in the CPIK ConfigurationSetting class so it can properly check whether two config settings have the same value when values are passed as strings.

Fixed an incorrect drop in the speed limit to 50 mph on the M20 motorway in England.

Fixed an issue that prevented the 2D and 3D split screen views from displaying full route directions for more than 1 minute on some devices.

Fixed an issue that caused CoPilot to stall on startup when a custom place was deleted in ContentTools but never existed on CoPilot’s local places database.

Fixed an issue that caused multiple different trips to be assigned the same tripID.

Fixed an issue in CPIK React Native where RouteMgr.getVehicleRoutingProfiles() wasn’t returning the profile set in RouteMgr.setActiveVehicleRoutingProfile().

Fixed an issue that would prevent CoPilot from launching on Windows laptop devices.

Fixed multiple customer-reported issues related to RouteReporter route compliance.

Fixed an issue that caused CoPilot to display “No Maps Found” on every startup when using classic data.

Fixed an issue that prevented access to the navigation screen without relaunching CoPilot after the initial map download.

CoPilot 10.19.0.1716 - 10.19.0.1771

Enhanced Features

Default truck routing safety feature - If you are licensed for truck or school bus routing, CoPilot is now set by default to only generate routes that are safe and legal for these larger vehicles. This change was made to ensure CoPilot’s vehicle routing profile is not inadvertently set for automobiles or vans when a driver is operating a truck. If you have a truck license but still need to use automobile routing, please contact us at for help on how to switch between truck and auto routing.

Use Less Data with Traffic - Traffic data is now compressed before it is sent to CoPilot in order to reduce data consumption on a device. This compression reduces data usage to a range of 58 MB to 96 MB per month, depending on factors such as the length, time of day, and location of routes. This compression is compatible with CoPilot 10.14 and higher. No changes are required for CoPilot users.

Better Routings Within Sites - Routing has been improved for situations in which a trip begins within the same Site where the first stop is located.

Updated Light Duty Profile - The minimum weight for the Light Duty (LCV) Vehicle Routing Profile in Europe has been lowered to 2 tons. This change improves the speed limit information provided by CoPilot.

Map Update Popup - CoPilot will display a popup on startup and in the My Maps screen if there is a new map version available. (Requires Account Manager licensing and the My Maps screen must be enabled.)

Speed Limit Warnings - The OnOverSpeedLimitEvent callback, which is called when there is a warning for traveling over the speed limit, is now fired even when CoPilot is set to a map only view, without any of the standard menu widgets. Customers integrating CoPilot can use this callback to provide their own speed warnings or to log speeding incidents.

New Geo URI Format with Stop Labels - You can now pass stops into CoPilot using the following Geo URI format: geo:0,0?q=lat,long(label). The label is the name of the stop that will be displayed in CoPilot.

Bug Fixes

Fixed an issue that was preventing an Avoid created via a geofence from being removed.

Extended the character limit for an Asset ID used to log in to 320 characters to avoid login errors.

Fixed an issue preventing CoPilot from displaying the correct mute button setting that was set via SpeechMgr.setMuteState().

Fixed an issue in iOS builds that caused widgets to be displayed even when CoPilot is set to “no widgets” mode.

Fixed an issue in which the OnMapDataUpdate callback doesn’t fire back continuously if the user initiates a map download from the My Maps screen in CoPilot.

Fixed an issue in the CPIK libraries that could cause isCopilotReadyToAddStops() to wrongly return false.

CoPilot 10.19.0.1528

Removed Features

In CoPilot’s user interface, the Axles setting has been removed from Vehicle Dimensions in Vehicle Routing Profiles because it is not used by CoPilot. (Axles is used in other Trimble Maps applications for toll cost calculations.)

CoPilot no longer automatically switches to 2D view when entering a Site. Instead, it remains with the current view (either 2D or 3D).

Bug Fixes

Fixed an issue preventing certain routes run in CoPilot from being displayed in RouteReporter.

Fixed an issue that could cause the keyboard to disappear when CoPilot is sent to the background and brought back to the foreground when switching between apps on a device.

Fixed an issue allowing drivers to edit Vehicle Routing Profiles created by a company administrator in FleetPortal.

Raised the minimum Android API support level to 19 (Android 4.4) to fix an issue preventing some customers from upgrading to CoPilot 10.19.

Fixed an issue that could cause CoPilot to crash after completing a leg of a RouteSync prescribed route.

Fixed an issue that could cause the Skeleton App for Android to crash when downloading maps.

CoPilot 10.19.0.1405

New Features

Encourage Driver Safety with Slowdown Alerts

CoPilot now provides voice and popup message warning alerts for trucks when a sudden traffic slowdown is detected ahead on the route. The alert is issued up to 5 miles (8 km) before the traffic incident to give the driver time to slow down and potentially avoid an accident. (This feature requires an ActiveTraffic license and works with truck and school bus Vehicle Routing Profiles only).

A demo of the voice and pop-up message alerts

Display Trip Messages

The SDK App can now display messages from the Trip Management Web Service if you are using Trip Management to send trips to a driver’s device. (May require additional licensing)

Automate Downloads of CoPilot Updates

The Android and Android Xamarin versions of CPIK libraries can now be downloaded via public, cloud-based repositories.

Enhanced Features

Licensing Support for Partners - The Licensing APIs in CPIK libraries have been updated to support partners who are using the fields External Acct ID, Partner ID, and Asset ID, to assign and track CoPilot licenses in Account Manager.

Improved Sites Routing - The Sites feature has been enhanced for Sites that do not have a mapped internal road network. Improvements include:

• General verbal instructions to the exit of a Site (i.e. “Head West To Exit”).

• Better routing when a driver is parked within a Site and the first stop of the next trip is also within that same Site.

More RouteSync Feedback - The range of error codes returned by the onRouteSyncError callback has been expanded to provide more details.

Automatic State + National Network Routing - (North America Only) State+National Network routing will automatically be enabled in FleetPortal and CoPilot when custom Vehicle Dimensions are set to a Total Length above 48 feet or Maximum Width above 96 inches.

Better Speed Limit Data - The posted road speed limit feature in CoPilot has been improved to:

• Provide better speed limit coverage for roads throughout the world.
• Better avoid displaying ramp speeds when passing by ramps on a highway.

Removed Features

The following APIs have been deprecated as they are not currently in use:

• SDK App: MSG_ID_MapSureGetOverrideRequest, MSG_ID_MapSureResetAndDeleteOverrideRequest
• CPIK libraries: MapDataMgr.getMapSureOverride(boolean inc), MapDataMgr. resetAndDeleteMapSureOverride() for CPIK

Bug Fixes

• Fixed an issue that could cause CoPilot to fail to generate a route when maps are downloaded to an SD card and then transferred to the device’s memory.
• Fixed an issue that could cause CoPilot to show a black screen when toggling among CoPilot screens in integrations using React Native.
• Fixed an issue that could cause CoPilot to run an Auto Vehicle Routing Profile on first install and launch on iOS devices running a companion ELD app.

CoPilot 10.19.0.1360

Enhanced Features

Add address labels - If a GEO URI includes an address in addition to the GPS coordinates of a stop, the address will now be used as the stop name label shown in CoPilot.

Replace pedestrian icons - A configuration setting was added that allows you to override the use of the pedestrian icon on map screens when a stop is located on a road that is restricted to only pedestrians or bicycles. A numbered stop icon appears instead. The setting is:

[User Settings]
"OverridePedestrianStopIcons"=0 (default value is 0, we will not override)

[User Settings]
"OverridePedestrianStopIcons"=1 (the icons will be ignored and instead shown like regular stops on the map screens)

Larger speed limit signs - The speed limit sign on the navigation screen has been enlarged by 15% for better visibility.

Bug Fixes

• Fixed the popup that appears when crossing an international border to properly display the units of measure in that country.
• Fixed an issue that caused the CoPilot login screen to retain incorrectly entered login credentials, forcing the user to uninstall and re-install CoPilot.
• Fixed an incorrect German text-to-speech pronunciation for “A1” Motorway.
• Fixed an issue that could cause CoPilot to go to the background after hitting the button to begin navigation.
• Fixed an issue that could cause CoPilot to crash when entering certain destinations.

CoPilot 10.19.0

Note: To better clarify our integration formats, CoPilot’s Software Developer Kits (SDKs) have been renamed. CoPilot CPIK is now called CoPilot CPIK libraries and CoPilot SDK is now called CoPilot SDK App. This naming change has no impact on integrations.

New Features

Take Advantage of a New CoPilot Integration Option

Integration partners and fleets can take advantage of a new, streamlined option for integrating CoPilot navigation into an existing workflow. The CoPilot Standalone App allows you to customize and deploy CoPilot with little or no development work. CoPilot can be downloaded from app stores, or installed via a Mobile Device Management (MDM) solution, and enhanced with:

• Cloud-based web tools including FleetPortal to apply Vehicle Routing Profiles and other CoPilot settings for the fleet, and ContentTools to create custom location content.
• A consolidated URL launch command from the partner’s app to identify a CoPilot user for licensing and web tools configuration.
• Web APIs to gather dispatch information from a partner’s telematics app, create a trip and send it to a specific driver’s device for CoPilot navigation.

The Standalone App allows full dispatch integration while using the simplicity of app store distribution for map and software updates. This new, cloud-based integration option is in addition to our existing, app-to-app integration options, CoPilot CPIK libraries and CoPilot SDK App.

CoPilot Integration Options

Download Custom Mapsets

(Available Upon Request) Map downloads can now be planned via FleetPortal. You can assign specific map regions to groups of drivers or vehicles, reducing device storage requirements for maps. Contact to add this feature to your account.

Select from Default Routing Profiles

CoPilot’s default Vehicle Routing Profile options now match the options in PC*MILER, ensuring that routes planned in the back office match those generated by CoPilot. That includes a “Default Rating” profile, which is most often used to generate mileage for rating.

Set Road Preferences

The ability to set Road Preferences has been added to Vehicle Routing Profiles. Road Preferences tell CoPilot whether to avoid or favor certain road classes when generating a route. Road Preferences are visible by default in app store licensed versions of CoPilot but must be added to the user interface in enterprise versions by setting the following configuration value:

[Application]
“ShowRoadPreferencesUI”=1

These values can also be set when creating a Vehicle Routing Profile in FleetPortal.

Generate Better Routes for Local Deliveries

To improve routing, CoPilot now supports two additional local road classes: sub-local roads, which are accessible by vehicles, but not suitable for through routes; and pathways, which are normally accessible only to pedestrians, bicycles, and small, lightweight motorized vehicles. As a result of these new road classes, devices running CoPilot 10.19 need to download a different map set in the CoPilot partner portal.

Enhance URL Launch Capabilities

CoPilot’s URL launch has been enhanced and can now:

• Use an integration partner’s existing account ID for their customer, in addition to the account-unique asset ID (e.g. partner’s driver or vehicle ID), to activate a CoPilot license on a device. In the past, partners were required to use a Trimble Maps assigned company ID.
• Set configurations, identify the driver using the device, and apply licensing credentials with a single URL string.

Enhanced Features

Routing Type Naming Change

ActiveRoutes has been renamed to Fastest routing to better clarify the type of route it prompts CoPilot to generate. (Fastest routing requires an ActiveTraffic license, and it is not recommended for truck profiles.)

Improved Routes Around Traffic

CoPilot is now better able to avoid closed roads when suggesting alternative routes based on traffic incidents.

SpeechMgr for React Native

Our SpeechMgr APIs, which include methods regarding speech, languages, and voices, are now available in our CPIK libraries for React Native.

Support for MapExact Roads

CoPilot now supports new roads created in MapExact, our premium map editing web tool, regardless of where they are placed on a road link.

Improved Routing to Twin Stops

CoPilot’s Advanced Route Optimization premium add-on feature now better organizes twin stops in a more logical order. Twin stops are two or more stops with the same exact lat/long coordinates but different house or apartment numbers.

Get Leg Coordinates

getCoordinates(), a new public method in our CPIK libraries Leg class, allows you to retrieve a list of coordinates that represent the leg.

Bug Fixes

• Fixed the SDK App sample application and updated the documentation to include Fastest as a possible setting for RouteType.
• Fixed an issue that could cause CoPilot to crash when downloading maps under certain circumstances.
• Fixed a spelling error in the code for the OnLicenseMgtLogin callback.
• Fixed an issue that could cause CoPilot to incorrectly return a value of -1 for GPSFixQuality.
• Added Msg_IntegrateCustomPOI and Msg_ImportPOISet APIs to our SDK App sample apps.
• When searching for an exact match via API, only EXACT match results will be shown.
• Removed an error pop-up that was displayed after entering a blank partner ID or device ID when inputting FleetPortal settings via API.
• Fixed an issue that could prevent CoPilot from receiving Account Manager updates when the device was using only cell network data.
• Fixed a missing railroad crossing alert in Racine, Wisconsin.
• Fixed an issue that was preventing CoPilot from properly displaying guidance instructions in Safety Mode in languages other than English.