카카오내비

JavaScript

이 문서는 Kakao SDK for JavaScript(이하 JavaScript SDK)를 사용한 카카오내비 API 구현 방법을 안내합니다.

JavaScript SDK는 Kakao.Navi의 API를 통해 카카오내비 네이티브(Native) 애플리케이션(이하 앱)에서 목적지 공유 및 길 안내 기능을 실행합니다. 카카오내비 앱이 설치돼 있다면 앱, 그렇지 않다면 설치 페이지를 엽니다.

이 문서에 포함된 기능들은 [도구] > [JS 데모]를 통해 JavaScript 예제 및 실제 동작을 확인할 수 있습니다.

권한	사전 설정	카카오 로그인	사용자 동의	레퍼런스
-	플랫폼 등록	-	-	`start()`

Kakao.Navi.start()를 호출합니다. 필수 파라미터로 목적지 이름과 좌표를 전달해야 합니다. 이밖에 특정 차종이나 도로를 우선하는 등 길 안내 조건을 설정하기 위한 선택 파라미터들을 사용할 수 있습니다.

요청 성공 시, 카카오내비 앱이 실행되어 공유한 목적지를 보여줍니다.

이름	타입	설명	필수
name	`String`	목적지 이름	O
x	`Number`	목적지 x 좌표(경도), wgs84 또는 katec 좌표계 값	O
y	`Number`	목적지 y 좌표(위도), wgs84 또는 katec 좌표계 값	O
coordType	`Number`	좌표 타입, wgs84 또는 katec	X
vehicleType	`Number`	차종 1: 1종(승용차/소형승합차/소형화물화) 2: 2종(중형승합차/중형화물차) 3: 3종(대형승합차/2축 대형화물차) 4: 4종(3축 대형화물차) 5: 5종(4축이상 특수화물차) 6: 6종(경차) 7: 7종(이륜차) (기본값: 카카오내비 앱에 설정된 차종)	X
rpOption	`Number`	경로 옵션 1: 가장 빠른 경로 2: 무료 도로 3: 가장 짧은 경로 4: 자동 전용 도로 제외 5: 큰길 우선 6: 고속도로 우선 8: 일반 도로 우선 100: 추천 경로	X
routeInfo	`Boolean`	전체 경로 보기 여부	X
sX	`Number`	시작 좌표 x	X
sY	`Number`	시작 좌표 y	X
sAngle	`Number`	시작 앵글(0~359)	X
returnUri	`String`	길 안내 종료(전체 경로 보기) 후 호출할 URI	X
viaPoints	`Object[]`	경유지 정보, 최대 3개	X

Kakao.Navi.start({
  name: '현대백화점 판교점',
  x: 127.11205203011632,
  y: 37.39279717586919,
  coordType: 'wgs84',
});

웹 길 안내 제공 종료

JavaScript SDK 1.41.0 버전부터 길 안내 시 카카오내비 앱이 설치돼 있지 않다면 설치 페이지로 이동되며, 웹 페이지를 통해 길 안내를 실행하는 기능을 제공하지 않습니다. 자세한 내용은 데브톡 공지사항을 참고합니다.

권한	사전 설정	카카오 로그인	사용자 동의	레퍼런스
-	플랫폼 등록	-	-	`share()`

Kakao.Navi.share()를 호출합니다. 필수 파라미터로 목적지 이름과 좌표를 전달해야 합니다.

요청 성공 시, 카카오내비 앱이 실행되어 공유한 목적지를 보여줍니다.

Kakao.Navi.share({
  name: '현대백화점 판교점',
  x: 127.11205203011632,
  y: 37.39279717586919,
  coordType: 'wgs84',
});