CoPilot

Platforms and setup

Native platforms: ios, android.

• Provider documentation restricts URL launch to the Truck-licensed application.

Public actions

• Copilot.open
• Copilot.view
• Copilot.directionsWithCoords

factory Copilot.open({final bool fallbackToStore = false})

static CopilotViewAction view({ required final Coordinate coordinate, final String? title, final bool fallbackToStore = false, })

static CopilotDirectionsWithCoordsAction directionsWithCoords({ required final Coordinate destination, final String? destinationTitle, final bool fallbackToStore = false, })

Provider setup and examples

DeeplinkX supports CoPilot GPS Navigation on iOS and Android for opening the app, showing a coordinate, and starting coordinate navigation. Trimble's URL launch guide says URL launch is supported only by its Truck-licensed application; availability and features depend on the installed CoPilot license.

References

• Trimble CoPilot URL launch documentation: URI format, supported platforms, VIEW and GOTO actions, coordinate parameters, and Truck-license limitation.
• Official Google Play listing: Android package com.alk.copilot.mapviewer.
• Official App Store listing: iOS store ID 504677517.

Available Actions

Launch CoPilot

final deeplinkX = DeeplinkX();
await deeplinkX.launchApp(Copilot.open());

View Map

await deeplinkX.launchAction(
  Copilot.view(
    coordinate: const Coordinate(latitude: 52.5163, longitude: 13.3777),
    title: 'Fleet Yard',
  ),
);

Directions With Coordinates

await deeplinkX.launchAction(
  Copilot.directionsWithCoords(
    destination: const Coordinate(latitude: 52.5163, longitude: 13.3777),
    destinationTitle: 'Warehouse',
  ),
);

CoPilot route links are coordinate based, so DeeplinkX does not expose a text-only directions action for this app.

Platform Configuration

iOS

Add the CoPilot scheme to the LSApplicationQueriesSchemes array in ios/Runner/Info.plist:

<string>copilot</string>

Android

Allow querying the package in android/app/src/main/AndroidManifest.xml:

<queries>
  <package android:name="com.alk.copilot.mapviewer" />
</queries>

URI Formats

• View: copilot://mydestination?type=LOCATION&action=VIEW&lat={latitude}&long={longitude}&name={title}
• Directions with coordinates: copilot://mydestination?type=LOCATION&action=GOTO&name={destinationTitle}&lat={latitude}&long={longitude}

Fallback Behavior

1. DeeplinkX opens the native app when installed.
2. If the app is missing and fallbackToStore is true, we redirect to the appropriate store listing.
3. Otherwise each action falls back to the CoPilot website.
4. Set disableFallback: true when calling launchAction to skip both store and web fallbacks.

Fallback Support Matrix