# HERE WeGo

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

DeeplinkX 1.5.8.

## Platforms and setup

Native platforms: **ios, android**.



## Public actions

### HereWeGo.open


```dart
factory HereWeGo.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/here_wego.dart#L9)

### HereWeGo.view


```dart
static HereWeGoViewAction view({ required final Coordinate coordinate, final String? title, final int zoom = 16, 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 | — |
| `title` | `String?` | No | — |
| `zoom` | `int` | No | `16` |
| `fallbackToStore` | `bool` | No | `false` |

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

### HereWeGo.directionsWithCoords


```dart
static HereWeGoDirectionsWithCoordsAction directionsWithCoords({ required final Coordinate destination, final Coordinate? origin, final String? destinationTitle, final String? originTitle, final HereWeGoTravelMode mode = HereWeGoTravelMode.driving, 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 | — |
| `origin` | `Coordinate?` | No | — |
| `destinationTitle` | `String?` | No | — |
| `originTitle` | `String?` | No | — |
| `mode` | `HereWeGoTravelMode` | No | `HereWeGoTravelMode.driving` |
| `fallbackToStore` | `bool` | No | `false` |

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


## Provider setup and examples
DeeplinkX supports HERE WeGo on iOS and Android through HERE share links for showing locations and planning coordinate routes.

## First-party References

- [HERE Deeplinking API introduction](https://docs.here.com/wego-pro/docs/readme-here-deeplinking-api-developer-guide-dl)
- [HERE URL format and mobile examples](https://docs.here.com/wego-pro/docs/request-format-dl)
- [HERE location sharing](https://docs.here.com/wego-pro/docs/share-location-dl)
- [HERE route sharing](https://docs.here.com/wego-pro/docs/share-route-dl)
- [Google Play listing](https://play.google.com/store/apps/details?id=com.here.app.maps)
- [Apple App Store listing](https://apps.apple.com/us/app/here-wego-maps-navigation/id955837609)

Checked on **2026-10-11**. Although hosted under WeGo Pro, the general HERE Deeplinking API introduction explicitly covers the HERE WeGo mobile app and desktop web. This provider uses only the general location and route contract, not Pro activation, truck settings, or extra waypoint APIs.

## Available Actions

### Launch HERE WeGo

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

### View Map

```dart
await deeplinkX.launchAction(
  HereWeGo.view(
    coordinate: const Coordinate(latitude: 52.5163, longitude: 13.3777),
    title: 'Brandenburg Gate',
    zoom: 15,
  ),
);
```

### Directions With Coordinates

```dart
await deeplinkX.launchAction(
  HereWeGo.directionsWithCoords(
    origin: const Coordinate(latitude: 52.5308, longitude: 13.3847),
    originTitle: 'Berlin Central Station',
    destination: const Coordinate(latitude: 52.5163, longitude: 13.3777),
    destinationTitle: 'Brandenburg Gate',
    mode: HereWeGoTravelMode.transit,
  ),
);
```

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

Omit `origin` to use HERE's `mylocation` waypoint as the start. `originTitle` is ignored without an explicit origin. The requested travel modes are driving (`d`), transit (`pt`), walking (`w`), and bicycling (`b`); availability varies by receiving client. The store listing does not establish that every mode is available in the mobile app.

`zoom` must be between 0 and 20 and defaults to 16. HERE documents that the mobile app ignores zoom; it is retained for the web share link.

## Platform Configuration

### iOS

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

```xml
<string>here-location</string>
```

The legacy `here-location://` scheme is used for installation checks and `open()`. Map and directions actions use HTTPS share links. If scheme detection fails, DeeplinkX follows the selected fallback policy; native-only requests can return `false`.

### Android

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

```xml
<queries>
  <package android:name="com.here.app.maps" />
</queries>
```

## URI Formats

- Legacy iOS app detection/opening scheme : `here-location://`
- View map: `https://share.here.com/l/{latitude},{longitude},{title}?z={zoom}`
- Directions with coordinates: `https://share.here.com/r/{originLatitude},{originLongitude},{originTitle}/{destinationLatitude},{destinationLongitude},{destinationTitle}?m={d|pt|w|b}`
- Directions without an explicit origin: `https://share.here.com/r/mylocation/{destinationLatitude},{destinationLongitude},{destinationTitle}?m={d|pt|w|b}`

Titles are optional and URL-encoded separately from coordinate delimiters. Without a title the extra comma is omitted.

## Fallback Behavior

1. After installation detection succeeds, DeeplinkX sends navigation actions through the HTTPS share link. HERE and the operating system decide whether the native app or web client receives it; native interception is not guaranteed.
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 same HERE share link.
4. Set `disableFallback: true` when calling `launchAction` to skip both store and web fallbacks.

### Fallback Support Matrix

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