페이지 이동경로
  • 문서>
  • 카카오내비>
  • JavaScript

카카오내비

JavaScript

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

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

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

길 안내하기

기본 정보

사전 설정 레퍼런스
플랫폼 등록 start()

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

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

Parameter
Name Type Description Required
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

Sample

Kakao.Navi.start({
    name: "현대백화점 판교점",
    x: 127.11205203011632,
    y: 37.39279717586919,
    coordType: 'wgs84'
});
길 안내 예시 화면
웹 길 안내 제공 종료 안내

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

목적지 공유하기

기본 정보

사전 설정 레퍼런스
플랫폼 등록 share()

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

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

Parameter
Name Type Description Required
name String 목적지 이름 O
x Number 목적지 x 좌표(경도), wgs84 또는 katec 좌표계 값 O
y Number 목적지 y 좌표(위도), wgs84 또는 katec 좌표계 값 O
coordType String 좌표 타입, wgs84 또는 katec X

Sample

Kakao.Navi.share({
    name: "현대백화점 판교점",
    x: 127.11205203011632,
    y: 37.39279717586919,
    coordType: 'wgs84'
});
목적지 공유 예시 화면

더보기