CoPilot 11 Integration Guide

This guide is for fleet customers and Trimble partners preparing to upgrade to CoPilot 11 for Android, the latest generation of Trimble’s GPS navigation for commercial vehicles. It covers integrations using CPIK Libraries, or the combination of the SDK App and Standalone CoPilot App. Please review all of the requirements listed below to help ensure a smooth integration process.

If you have questions specific to your deployment, contact us for assistance.

CoPilot 11 availability

Pre-requisites

Device requirements

CoPilot 11 is available only for Android devices and must meet the following requirements:

Storage requirements

• At least 400 MB of free disk space is needed during installation (CoPilot requires 200 MB; double is needed for unpacking).
• Additional storage is required for map data:
  • Single European country or North America region: 300–700 MB
  • Complete European maps: ~4 GB
  • All of North America (Canada + USA): 2.8 GB
  • In North America, smaller regions can be created using the Map Sets feature in Account Manager.

Minimum hardware requirements

• CPU: ARM processor (1.5 GHz or faster recommended). x86 is supported—contact us for details.
• RAM: Minimum 2 GB (3–4 GB recommended for best performance).
• Screen: Minimum resolution 480 × 800 pixels. Higher resolutions recommended. Non-touch screen devices are not supported.
• Operating System: Android 7 or later. While the minimum version is 7, CoPilot Android builds target API level 35 (Android 15).

Licensing

In CoPilot 11, all app licensing is done via the Account Manager web tool. Product key licensing is no longer available. If you do not already have access to Account Manager, please contact your Trimble sales representative.

Deprecated Licensing APIs

As a result of the new licensing, the following APIs and listeners are deprecated in CoPilot 11:

Maps

CoPilot 11 uses a new mapping platform that provides greater detail, making it easier for drivers to understand their route and surroundings. With this change, the maximum zoom level is now 18 (previously 20).

This affects the following CPIK APIs:

• MapDrawer.MapZoomLevel
• MapZoomLevel (React Native)

Map updates

CoPilot 11 also introduces a new map update feature that downloads and installs only the differences between the existing map data on a device and the latest available data. (Previous versions of CoPilot replace all of the old map data with new map data.) This new feature not only increases the speed of updates, but it also reduces the size of downloads by 75 to 90 percent.

This improved mapping may require additional memory on the device:

• CoPilot 11 installs a new styles.db in order to render features such as satellite maps. It requires an additional 25 MB of memory.
• Customers in Europe need at least 4 GB of disk space to download and store full European maps.

Required API updates for larger map downloads

In order to support 4 GB+ map downloads, the following APIs may need updates to support larger data types.

CPIK Libraries

React Native

• The MapInfo object’s fileSize must be

  unsigned long

  .

iOS .NET

• The MapInfo object’s fileSize and downloadedSize return data type must be

  ulong

  .

Affected APIs

• List getInstalledMaps()
• MapInfo checkMapUpdate(MapRegion mapRegion, int year, int quarter)
• MapInfo checkMapUpdate(MapRegion mapRegion)
• MapDataListener > onMapdataUpdate(MapInfo mapSet, DownloadStatus status)

SDK APIs

MapActionRequestCB - m_uCurrent and m_uTotalSize

• JAVA - set to

  long

• C# - set to

  UInt64

Important note for SDK users

The CoPilot 11 SDK has two components. The Standalone CoPilot App and the SDK app, which controls CoPilot via APIs. When upgrading to CoPilot 11, it’s important that you update both components, which are available in the CoPilot partner portal.