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.
| Parameter | Type | Required | Default |
|---|---|---|---|
fallbackToStore | bool | No | false |
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.
| Parameter | Type | Required | Default |
|---|---|---|---|
coordinate | Coordinate | Yes | — |
fallbackToStore | bool | No | false |
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.
| Parameter | Type | Required | Default |
|---|---|---|---|
destination | Coordinate | Yes | — |
destinationTitle | String? | No | — |
mode | MapplsTravelMode | No | MapplsTravelMode.driving |
fallbackToStore | bool | No | false |
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
- Mappls app deep-link documentation: https://developer.mappls.com/mappls-apps/ios/
- Mappls App Store listing: https://apps.apple.com/us/app/mappls-mapmyindia-maps/id723492531
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
- DeeplinkX opens the native app when installed.
- If the app is missing and
fallbackToStoreistrue, we redirect to the appropriate store listing. - Otherwise the action falls back to the same Mappls web URL.
- Set
disableFallback: truewhen callinglaunchActionto skip both store and web fallbacks.
Fallback Support Matrix
| Action | Store Fallback | Web Fallback |
|---|---|---|
| Open app | ✔️ | ✔️ (website) |
| View map | ✔️ | ✔️ |
| Directions with coordinates | ✔️ | ✔️ |