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

카카오내비

JavaScript

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

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

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

애플리케이션 설정 확인

이 기능을 사용하려면 애플리케이션 설정에 Web 플랫폼 및 도메인 등 정보가 등록되어 있어야 합니다. 자세한 내용은 애플리케이션 등록 가이드를 참고합니다.

길 찾기

Kakao.Navi.start를 호출합니다. 목적지 좌표만 입력해도 되고, 특정 차종이나 도로를 우선하는 등 길 찾기 조건을 설정하기 위한 선택 파라미터들을 사용할 수도 있습니다. 요청 성공 시, 카카오내비 앱 또는 웹 버전이 실행되어 공유한 목적지를 보여줍니다.

Request

Kakao.Navi.start(PARAMETER);

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'
});

목적지 공유하기

Kakao.Navi.share를 호출합니다. 목적지 좌표는 파라미터로 전달합니다. 요청 성공 시, 카카오내비 앱 또는 웹 버전이 실행되어 공유한 목적지를 보여줍니다.

Request

Kakao.Navi.share(PARAMETER);

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'
});

더보기