Skip to main content

Start Route Guidance to Destination

Start Route Guidance to Destination​

Official Documentation

Usage​

Use navigateTo() to launch the Kakao Navigation app and start route guidance to the destination.

It is defined as follows:

export function navigateTo(params: {
  destination: KakaoNaviLocation;
  option?: KakaoNaviOption;
  viaList?: KakaoNaviLocation[];
  openWebInstallUrlIfNaviAppNotAvailable?: boolean;
}): Promise<boolean>
  • destination: Required destination information.
  • option: Options for navigation.
  • viaList: List of via points.
  • openWebInstallUrlIfNaviAppNotAvailable: Whether to automatically redirect to the installation screen if Kakao Navigation app is not available. The default value is true.

For detailed explanations of the options, refer to the Official Documentation.

info

Because Navi has an option to guide app installation, the Promise does not reject with Package-KakaoAppNotAvailable when the app fails to launch.

Check the resolved result to see whether the app launched successfully.

warning

Route guidance is not available on the web platform.

On mobile web, if the Kakao Navigation app is unavailable, the browser redirects to the Kakao Navi launch/installation guide.

On desktop web, the function returns false without requesting app launch.

On mobile web, true indicates a launch request, not confirmation that Kakao Navi is installed or running. The Kakao JS SDK controls its launch/installation fallback; openWebInstallUrlIfNaviAppNotAvailable applies only to native platforms.

The announcement below describes the end of web route guidance support for Kakao Navi in Kakao's JavaScript SDK.

Dev Talk Announcement