# Sygic

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

DeeplinkX 1.5.8.

## Platforms and setup

Native platforms: **ios, android**.



## Public actions

### Sygic.open


```dart
factory Sygic.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.dart#L12)

### Sygic.view


```dart
static SygicViewAction 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.dart#L46)

### Sygic.directionsWithCoords


```dart
static SygicDirectionsWithCoordsAction directionsWithCoords({ required final Coordinate destination, final SygicTransportMode mode = SygicTransportMode.drive, 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 | — |
| `mode` | `SygicTransportMode` | No | `SygicTransportMode.drive` |
| `fallbackToStore` | `bool` | No | `false` |

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


## Provider setup and examples
DeeplinkX supports the custom URI scheme used by [Sygic GPS Navigation](https://www.sygic.com/gps-navigation) so you can open map previews or launch turn-by-turn guidance directly from your Flutter app.

## References

- Sygic developer program overview: <https://www.sygic.com/developers/professional-navigation-sdk/introduction>

## Available Actions

### Launch Sygic

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

### View Map

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

### Directions With Coordinates

```dart
await deeplinkX.launchAction(
  Sygic.directionsWithCoords(
    destination: const Coordinate(latitude: 48.1486, longitude: 17.1077),
    mode: SygicTransportMode.drive, // or .walk
  ),
);
```

## Platform Configuration

### iOS

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

```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.aura" />
</queries>
```

## URI Formats

- View map: `com.sygic.aura://coordinate|{longitude}|{latitude}|show`
- Directions (driving/walking): `com.sygic.aura://coordinate|{longitude}|{latitude}|{drive|walk}`

## 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 the action falls back to `https://www.sygic.com/gps-navigation`.
4. Set `disableFallback: true` when calling `launchAction` to skip both store and web fallbacks.

### Fallback Support Matrix

| Action              | Store Fallback | Web Fallback |
| ------------------- | -------------- | ------------ |
| Open app            | ✔️              | ✔️ (website) |
| View map            | ✔️              | ✔️           |
| Directions with coordinates | ✔️              | ✔️           |