페이지 이동경로
  • 문서>
  • 카카오내비>
  • 이해하기

카카오내비

이해하기

이 문서는 카카오내비 API를 소개합니다.

기능 소개

카카오내비 API는 카카오내비를 통해 길을 안내하는 내비게이션 기능과 경로 안내 데이터를 제공합니다.

Kakao SDK

Kakao SDK의 카카오내비 모듈이 제공하는 기능입니다. 카카오내비 애플리케이션(이하 앱)을 실행하여 목적지를 공유하거나 길을 안내할 수 있습니다. 카카오내비 앱이 설치되어있지 않은 경우, 설치 페이지로 이동합니다.

API Description
길안내 카카오내비를 실행하여 목적지까지의 길 안내, 차종이나 경로 옵션 설정 및 최대 3개의 경유지 추가 가능
목적지 공유하기 카카오내비를 실행하여 지정한 목적지 정보를 공유하고, 목적지까지의 추천 경로, 이동 거리, 통행료와 같은 장소 정보 제공
길안내 기능과 함께 사용 가능

참고: 카카오내비 길찾기 SDK(내장형) Beta

카카오내비를 실행하지 않고 서비스 내에서 내비게이션 기능을 직접 구현하려면 카카오내비 길찾기 SDK(내장형)를 사용합니다. Kakao SDK가 제공하는 카카오내비 모듈이 카카오내비를 실행시켜 길안내나 목적지 공유를 수행하는 반면, 카카오내비 길찾기 SDK(내장형)는 카카오내비의 길안내 기능 및 UI를 Kit로 제공하여 서비스 내에서 길안내 기능을 이용할 수 있도록 합니다.

카카오내비가 제공하는 기본적인 UI를 활용하여 서비스 내에서 턴바이턴(Turn by turn) 음성 안내를 포함한 길안내 기능을 사용하거나 지도나 오버레이 등을 직접 수정하여 서비스에 맞게 활용할 수 있습니다.

카카오내비 길찾기 SDK(내장형)는 Android, iOS SDK를 제공하며 현재 베타 서비스 중입니다. 카카오내비 길찾기 SDK(내장형)를 이용하려면 partnership@kakaomobility.com으로 별도 요청해야 합니다. 베타 서비스 기간에는 기능이 변경되거나 일시적으로 서비스 접근이 불가능할 수 있습니다.

길찾기 API

REST API를 통해 제공되는 길찾기 API는 지정한 출발지, 경유지, 목적지에 대한 예상 시간이나 이동 경로 등의 경로 정보를 제공합니다. 경로 탐색 시 대안 경로 제공 여부, 우선 순위나 제한 옵션을 설정하거나 차종, 유종, 하이패스 장착 여부와 같은 차량의 옵션을 설정할 수 있습니다.

길찾기 API는 장소 검색 후 이동 거리나 예상 시간을 알려주는 시나리오에 이용할 수 있습니다. 또는 길찾기 API와 카카오맵 SDK를 함께 활용하여 경로 정보 데이터를 필요에 따라 가공하여 사용할 수 있습니다.

카카오내비의 길찾기 API는 쿼터 제한이 있습니다. 각 API에 대한 쿼터 상향이 필요하거나 30개를 초과하는 출발지, 경유지, 목적지를 설정하려면 partnership@kakaomobility.com으로 문의합니다.

API별로 설정할 수 있는 장소 개수 및 제공 정보는 다음과 같습니다:

API 출발지 목적지 경유지 출발 시간 제공되는 정보
자동차 길찾기 1개 1개 최대 5개 현재 구간별 경로 상세 안내 정보 또는 경로 요약 정보
다중 경유지 길찾기 1개 1개 최대 30개 현재 구간별 경로 상세 안내 정보 또는 경로 요약 정보
다중 출발지 길찾기 1개 이상 1개 최대 30개 현재 예상 소요 시간, 이동 거리
다중 목적지 길찾기 1개 1개 이상 최대 30개 현재 예상 소요 시간, 이동 거리
미래운행정보 길찾기 1개 1개 최대 5개 미래 구간별 경로 상세 안내 정보 또는 경로 요약 정보
참고: 필요한 기능 찾기
목적 Kakao SDK 카카오내비 길찾기 SDK(내장형) Beta 길찾기 API
차종이나 경로 옵션에 따른 경로 정보 찾기
교통 상황을 반영하여 특정 장소까지의 경로 안내
카카오내비 앱을 통한 길안내
카카오내비를 별도로 실행하지 않고 서비스 자체 내에서 실시간 길안내
카카오내비의 UI나 지도의 형태를 서비스에 맞게 변형
장소 검색 후, 해당 장소까지 추천 경로나 이동 거리와 같은 경로 안내 정보 제공
장소 검색 후, 해당 장소까지 추천 경로나 이동 거리를 카카오내비를 실행하여 공유
출발지나 목적지를 여러 개 지정하여 경로 안내 정보 제공

지원 범위

API Android SDK iOS SDK JavaScript SDK REST API
길안내
목적지 공유하기
자동차 길찾기
다중 경유지 길찾기
다중 출발지 길찾기
다중 목적지 길찾기
미래운행정보 길찾기

* 카카오내비 길찾기 SDK(내장형) Beta 지원 범위 미포함