이 문서는 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()
를 호출합니다. 필수 파라미터로 목적지 이름과 좌표를 전달해야 합니다.
요청 성공 시, 카카오내비 앱이 실행되어 공유한 목적지를 보여줍니다.
이름 | 타입 | 설명 | 필수 |
---|---|---|---|
name | String |
목적지 이름 | O |
x | Number |
목적지 x 좌표(경도), wgs84 또는 katec 좌표계 값 | O |
y | Number |
목적지 y 좌표(위도), wgs84 또는 katec 좌표계 값 | O |
coordType | String |
좌표 타입, wgs84 또는 katec | X |
Kakao.Navi.share({
name: '현대백화점 판교점',
x: 127.11205203011632,
y: 37.39279717586919,
coordType: 'wgs84',
});