DEEPLINKX / app

Mappls

Mappls actions, setup, native platforms, and fallback options.

DeeplinkX 1.5.8 · Source

Platforms and setup

Native platforms: ios, android.

Public actions

Mappls.open

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

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

ParameterTypeRequiredDefault
fallbackToStoreboolNofalse

Exact source

Mappls.view

static MapplsViewAction 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.

ParameterTypeRequiredDefault
coordinateCoordinateYes—
fallbackToStoreboolNofalse

Exact source

Mappls.directionsWithCoords

static MapplsDirectionsWithCoordsAction directionsWithCoords({ required final Coordinate destination, final String? destinationTitle, final MapplsTravelMode mode = MapplsTravelMode.driving, final bool fallbackToStore = false, })

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

ParameterTypeRequiredDefault
destinationCoordinateYes—
destinationTitleString?No—
modeMapplsTravelModeNoMapplsTravelMode.driving
fallbackToStoreboolNofalse

Exact source

Provider setup and examples

DeeplinkX supports Mappls MapmyIndia links so Flutter apps can open map locations or launch coordinate-based directions in the native app on iOS and Android.

References

Available Actions

Launch Mappls

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

View Map

await deeplinkX.launchAction(
  Mappls.view(
    coordinate: const Coordinate(latitude: 28.6139, longitude: 77.2090),
  ),
);

Directions With Coordinates

await deeplinkX.launchAction(
  Mappls.directionsWithCoords(
    destination: const Coordinate(latitude: 28.6129, longitude: 77.2295),
    destinationTitle: 'India Gate',
    mode: MapplsTravelMode.driving,
  ),
);

Supported modes are driving, trucking, walking, and bicycling.

Platform Configuration

iOS

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

<string>mappls</string>

Android

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

<queries>
  <package android:name="com.mmi.maps" />
</queries>

URL Formats

  • View map: https://www.mappls.com/pom/{latitude},{longitude}
  • Directions: https://mappls.com/navigation?places={latitude},{longitude},{destinationTitle}&isNav=true&mode={mode}

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 the same Mappls web URL.
  4. Set disableFallback: true when calling launchAction to skip both store and web fallbacks.

Fallback Support Matrix

ActionStore FallbackWeb Fallback
Open app✔️✔️ (website)
View map✔️✔️
Directions with coordinates✔️✔️