# Sygic Truck

Canonical HTML: https://p-hatan.com/deeplink-x/apps/sygic-truck/

DeeplinkX 1.5.8.

## Platforms and setup

Native platforms: **ios, android**.

- iOS shares com.sygic.aura with regular Sygic; scheme availability cannot distinguish the apps.
- Store and website fallbacks open a listing or homepage without route coordinates. Configure truck dimensions and preferences in Sygic Truck.

## Public actions

### SygicTruck.open


```dart
factory SygicTruck.open({final bool fallbackToStore = false})
```

Launch with `DeeplinkX.launchApp`. Native platforms: **ios, android**. Action web fallback: **available**. Store-fallback flag: **supported; opt in explicitly**.

| Parameter | Type | Required | Default |
| --- | --- | --- | --- |
| `fallbackToStore` | `bool` | No | `false` |

[Exact source](https://github.com/DeepLinkX/DeeplinkX/blob/00d9d2c7c1affe4e2ee459a01afeba82a1480eac/lib/src/apps/downloadable_apps/sygic_truck.dart#L11)

### SygicTruck.view


```dart
static SygicTruckViewAction view({ required final Coordinate coordinate, final bool fallbackToStore = false, })
```

Launch with `DeeplinkX.launchAction`. Native platforms: **ios, android**. Action web fallback: **available**. Store-fallback flag: **supported; opt in explicitly**.

| Parameter | Type | Required | Default |
| --- | --- | --- | --- |
| `coordinate` | `Coordinate` | Yes | — |
| `fallbackToStore` | `bool` | No | `false` |

[Exact source](https://github.com/DeepLinkX/DeeplinkX/blob/00d9d2c7c1affe4e2ee459a01afeba82a1480eac/lib/src/apps/downloadable_apps/sygic_truck.dart#L45)

### SygicTruck.directionsWithCoords


```dart
static SygicTruckDirectionsWithCoordsAction directionsWithCoords({ required final Coordinate destination, final bool fallbackToStore = false, })
```

Launch with `DeeplinkX.launchAction`. Native platforms: **ios, android**. Action web fallback: **available**. Store-fallback flag: **supported; opt in explicitly**.

| Parameter | Type | Required | Default |
| --- | --- | --- | --- |
| `destination` | `Coordinate` | Yes | — |
| `fallbackToStore` | `bool` | No | `false` |

[Exact source](https://github.com/DeepLinkX/DeeplinkX/blob/00d9d2c7c1affe4e2ee459a01afeba82a1480eac/lib/src/apps/downloadable_apps/sygic_truck.dart#L55)


## Provider setup and examples
DeeplinkX exposes Sygic Truck & RV Navigation actions for opening the app, showing a coordinate, and starting coordinate navigation. Configure platform visibility and note the shared iOS scheme below.

## References

- [Official Google Play listing](https://play.google.com/store/apps/details?id=com.sygic.truck): Android package `com.sygic.truck`.
- [Official App Store listing](https://apps.apple.com/us/app/sygic-truck-rv-navigation/id992127700): iOS store ID `992127700`.
- [Sygic Android SDK reference](https://developers.sygic.com/reference/java3d/html/classcom_1_1sygic_1_1sdk_1_1remoteapi_1_1_api.html): identifies the consumer Truck package separately from regular Sygic; this does not establish the URL contract.

Sources checked on 2026-09-15. The legacy Sygic custom-URL documentation returned HTTP 403 and could not be verified. Store listings establish app identity, not supported URL actions.

## Validation Status

The URI formats below describe the current implementation, not a device-verified provider contract. No physical-device checks have been performed for this integration.

- Android intents target `com.sygic.truck` with `show` and `drive` commands.
- iOS uses `com.sygic.aura`, shared with regular Sygic. Scheme detection cannot distinguish the two apps.
- Truck dimensions, restrictions, and route preferences remain configured in Sygic Truck; these actions do not set them.

## Available Actions

### Launch Sygic Truck

```dart
final deeplinkX = DeeplinkX();
await deeplinkX.launchApp(SygicTruck.open());
```

### View Map

```dart
await deeplinkX.launchAction(
  SygicTruck.view(
    coordinate: const Coordinate(latitude: 48.1486, longitude: 17.1077),
  ),
);
```

### Directions With Coordinates

```dart
await deeplinkX.launchAction(
  SygicTruck.directionsWithCoords(
    destination: const Coordinate(latitude: 48.1486, longitude: 17.1077),
  ),
);
```

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

## Platform Configuration

### iOS

The proposed iOS integration queries the following shared scheme in `LSApplicationQueriesSchemes` in `ios/Runner/Info.plist`. Add it only once if regular Sygic is also configured; the shared-scheme behavior above still applies:

```xml
<string>com.sygic.aura</string>
```

### Android

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

```xml
<queries>
  <package android:name="com.sygic.truck" />
</queries>
```

## URI Formats

- View: `com.sygic.aura://coordinate|{longitude}|{latitude}|show`
- Directions with coordinates: `com.sygic.aura://coordinate|{longitude}|{latitude}|drive`

## Fallback Behavior

1. DeeplinkX attempts a native launch when availability checks succeed, subject to the shared iOS scheme limitation above.
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 Sygic Truck website.
4. Set `disableFallback: true` when calling `launchAction` to skip both store and web fallbacks.

Store and website fallbacks do not preserve the requested coordinates or start a route.

### Fallback Support Matrix

| Action                        | Store Fallback | Web Fallback |
| ----------------------------- | -------------- | ------------ |
| Open app                      | Yes            | Yes          |
| View map                      | Yes            | Yes          |
| Directions with coordinates   | Yes            | Yes          |