목적지까지 경로 안내 시작하기

사용법

navigateTo() 함수로 카카오내비 앱을 실행해 경로 안내를 시작할 수 있습니다.

이 함수는 다음과 같이 정의됩니다.

export function navigateTo(params: {
  destination: KakaoNaviLocation;
  option?: KakaoNaviOption;
  viaList?: KakaoNaviLocation[];
  openWebInstallUrlIfNaviAppNotAvailable?: boolean;
}): Promise<boolean>

destination: 목적지 정보입니다. 필수값입니다.
option: 옵션입니다.
viaList: 경유지 목록입니다.
openWebInstallUrlIfNaviAppNotAvailable: 카카오내비 앱을 실행할 수 없을 때 자동으로 설치 화면으로 이동할지 여부입니다. 기본값은 true입니다.

옵션에 대한 자세한 설명은 공식 문서를 참고하세요.

정보

Navi에는 설치를 안내하는 옵션이 있으므로 앱 실행에 실패해도 Promise가 Package-KakaoAppNotAvailable 에러 코드로 reject되지 않습니다.

대신 resolve된 결과로 앱 실행에 성공했는지 확인할 수 있습니다.

경고

웹 플랫폼에서는 길 안내가 제공되지 않습니다.

모바일 웹에서는 브라우저가 카카오 내비 실행/설치 안내 화면으로 이동합니다.

데스크톱 웹에서는 앱 실행을 요청하지 않고 false를 반환합니다.

모바일 웹에서 true는 앱 실행을 요청했다는 뜻이며, 카카오내비의 설치 여부나 실행 성공 여부를 확인한 결과는 아닙니다. 실행과 설치 안내는 카카오 JavaScript SDK가 처리하며, openWebInstallUrlIfNaviAppNotAvailable은 네이티브 플랫폼에만 적용됩니다.

카카오 JavaScript SDK의 웹 길 안내 지원 종료 공지입니다.

데브톡 공지사항

목적지까지 경로 안내 시작하기​

사용법​

목적지까지 경로 안내 시작하기

사용법