목적지까지 경로 안내 시작하기
목적지까지 경로 안내 시작하기
Usage
navigateTo() 함수를 이용해 카카오내비 앱을 실행시켜 경로안내를 시작할 수 있습니다.
이 함수는 다음과 같이 정의됩니다.
export function navigateTo(params: {
destination: KakaoNaviLocation;
option?: KakaoNaviOption;
viaList?: KakaoNaviLocation[];
openWebInstallUrlIfNaviAppNotAvailable?: boolean;
}): Promise<boolean>
destination: 목적지 정보입니다. 필수값입니다.option: 옵션입니다.viaList: 경유지 리스트입니다.openWebInstallUrlIfNaviAppNotAvailable: 카카오내비 앱을 실행할 수 없다면 자동으로 설치 화면으로 보낼지 여부입니다. 기본값은true입니다.
옵션에 대한 자세한 설명은 공식 문서를 참고해주세요.
정보
Navi는 특별히 설치 과정을 유도하는 옵션이 있기 때문에 앱 실행에 실패해도 Package-KakaoAppNotAvailable 에러 코드가
Promise로 reject되지 않습니다.
대신, resolve되는 결과로 앱이 문제없이 실행이 되었는 지 판단할 수 있습니다.
warning
Web 플랫폼에서는 길 안내가 제공되지 않습니다.
만약 모바일 웹이라면 카카오 내비 실행/설치 안내 스크린으로 브라우저로 이동됩니다.
만약 데스크탑 웹이라면 아무일도 일어나지 않습니다.
카카오의 JavaScript SDK에서의 웹에서의 길 안내 종료 공지입니다.