Platforms and setup
Native platforms: ios, android.
Public actions
KakaoMap.open
factory KakaoMap.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 |
KakaoMap.view
static KakaoMapViewAction 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 |
KakaoMap.directionsWithCoords
static KakaoMapDirectionsWithCoordsAction directionsWithCoords({ required final Coordinate destination, final Coordinate? origin, 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 | — |
fallbackToStore | bool | No | false |
Provider setup and examples
DeeplinkX supports KakaoMap's kakaomap URI scheme so Flutter apps can open map locations or launch coordinate-based directions in the native KakaoMap app on iOS and Android.
References
- KakaoMap official URL-scheme guide: https://apis.map.kakao.com/android_v2/docs/api-guide/urlscheme/
- KakaoMap Google Play listing: https://play.google.com/store/apps/details?id=net.daum.android.map
- KakaoMap App Store listing: https://apps.apple.com/us/app/kakaomap-korea-no-1-map/id304608425
Sources checked on 2026-09-09. The official guide documents the look and route actions and latitude/longitude coordinate ordering. No physical-device launch was performed; installed-app behavior, including current-location handling when origin is omitted, still requires device validation. This API leaves travel-mode selection to KakaoMap and does not expose waypoints.
Available Actions
Launch KakaoMap
final deeplinkX = DeeplinkX();
await deeplinkX.launchApp(KakaoMap.open());
View Map
await deeplinkX.launchAction(
KakaoMap.view(
coordinate: const Coordinate(latitude: 37.5665, longitude: 126.9780),
),
);
Directions With Coordinates
await deeplinkX.launchAction(
KakaoMap.directionsWithCoords(
origin: const Coordinate(latitude: 37.5665, longitude: 126.9780),
destination: const Coordinate(latitude: 37.5547, longitude: 126.9706),
),
);
Omitting origin leaves the route's sp parameter unset so KakaoMap handles the starting location.
Platform Configuration
iOS
Add the KakaoMap scheme to the LSApplicationQueriesSchemes array in ios/Runner/Info.plist:
<string>kakaomap</string>
Android
Allow querying the package in android/app/src/main/AndroidManifest.xml:
<queries>
<package android:name="net.daum.android.map" />
</queries>
URI Formats
- View map:
kakaomap://look?p={latitude},{longitude} - Directions:
kakaomap://route?sp={originLatitude},{originLongitude}&ep={destinationLatitude},{destinationLongitude}
Fallback Behavior
- DeeplinkX attempts to open 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
https://map.kakao.com/. This homepage fallback does not preserve the requested coordinate or route. - 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 | ✔️ | ✔️ |