Kakao Map

Kakao Map is a map and navigation app from Kakao. Protocol Launcher allows you to generate Kakao Map URL Scheme links.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Notes

This module only exposes the Kakao Map actions listed by Kakao's official URL Scheme documentation: open, look, place, search, route, and roadView, plus the documented trend-ranking open URL.

Pass scheme: 'mobileWeb' to generate Kakao's documented MobileWeb equivalent. Kakao documents the trend-ranking MobileWeb URL with HTTPS; the other MobileWeb examples use HTTP.

Open Kakao Map

On-Demand

import { open } from 'protocol-launcher/kakao-map'

const url = open()

Open Kakao Map

Open a Page

On-Demand

import { open } from 'protocol-launcher/kakao-map'

const url = open({
  page: 'placeSearch',
})

Open Place Search

Open a Layer

On-Demand

import { open } from 'protocol-launcher/kakao-map'

const url = open({
  layer: 'skyview',
})

Open Skyview

Trend Ranking

On-Demand

import { trendRanking } from 'protocol-launcher/kakao-map'

const url = trendRanking()

Open Trend Ranking

Look

On-Demand

import { look } from 'protocol-launcher/kakao-map'

const url = look({
  p: '37.3952969470752,127.110449292622',
})

Open Coordinate

Place

On-Demand

import { place } from 'protocol-launcher/kakao-map'

const url = place({
  id: '18577297',
})

Open Place

Search

On-Demand

import { search } from 'protocol-launcher/kakao-map'

const url = search({
  q: '맛집',
  p: '37.3952,127.11044',
})

Search Around Coordinate

Route

On-Demand

import { route } from 'protocol-launcher/kakao-map'

const url = route({
  sp: '37.39529,127.11044',
  ep: '37.49795,127.02763',
  by: 'car',
})

Open Car Route

Route with Waypoint

Kakao documents waypoints as vp, vp2, vp3, vp4, and vp5. Public transit routes do not support waypoints.

On-Demand

import { route } from 'protocol-launcher/kakao-map'

const url = route({
  sp: '37.40205,127.10821',
  vp: '37.39424,127.11030',
  ep: '37.39529,127.11044',
  by: 'foot',
})

Open Walking Route

Road View

On-Demand

import { roadView } from 'protocol-launcher/kakao-map'

const url = roadView({
  p: '37.39529,127.11044',
})

Open Road View

MobileWeb URL

On-Demand

import { look } from 'protocol-launcher/kakao-map'

const url = look({
  p: '37.3952969470752,127.110449292622',
  scheme: 'mobileWeb',
})

Open MobileWeb Coordinate

Official Documentation

• Kakao Map URL Scheme