# KakaoMap

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

DeeplinkX 1.5.8.

## Platforms and setup

Native platforms: **ios, android**.



## Public actions

### KakaoMap.open


```dart
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` |

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

### KakaoMap.view


```dart
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` |

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

### KakaoMap.directionsWithCoords


```dart
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` |

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


## 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

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

### View Map

```dart
await deeplinkX.launchAction(
  KakaoMap.view(
    coordinate: const Coordinate(latitude: 37.5665, longitude: 126.9780),
  ),
);
```

### Directions With Coordinates

```dart
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`:

```xml
<string>kakaomap</string>
```

### Android

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

```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

1. DeeplinkX attempts to open 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://map.kakao.com/`. This homepage fallback does not preserve the requested coordinate or route.
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  | ✔️              | ✔️           |