본문으로 건너뛰기

목적지까지 경로 공유하기

목적지까지 경로 공유하기

공식 문서

Usage

shareTo() 함수를 이용해 카카오내비 앱을 실행시켜 경로를 공유할 수 있습니다.

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

export function shareTo(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에서의 웹에서의 길 안내 종료 공지입니다.

데브톡 공지사항