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

카카오내비

이해하기

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

기능 소개

카카오내비 API는 카카오내비를 통해 길을 안내하는 내비게이션 기능과 경로 안내 데이터를 제공합니다. 이를 통해 서비스는 카카오내비 앱을 실행하여 내비게이션 기능을 이용하거나, 서비스 내에 내비게이션 기능을 직접 구현할 수 있습니다.

아래는 카카오내비 API가 제공하는 기능 목록 및 구현 방식별 지원 여부입니다.

목적 Kakao SDK 길찾기 카카오내비 길찾기 SDK(내장형)
차종이나 경로 옵션에 따른 경로 정보 찾기
교통 상황을 반영하여 특정 장소까지의 경로 안내
카카오내비 앱을 통한 길 안내
카카오내비를 별도로 실행하지 않고 서비스 자체 내에서 실시간 길 안내
카카오내비의 UI나 지도의 형태를 서비스에 맞게 변형
장소 검색 후, 해당 장소까지 추천 경로나 이동 거리와 같은 경로 안내 정보 제공
장소 검색 후, 해당 장소까지 추천 경로나 이동 거리를 카카오내비를 실행하여 공유
출발지나 목적지를 여러 개 지정하여 경로 안내 정보 제공

목적지 공유와 길 안내

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

카카오내비 기능 예시 화면

길찾기

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

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

다중 출발지 길찾기 예시 화면

API별로 설정할 수 있는 장소 개수 및 제공 정보는 다음과 같습니다. 자세한 구현 안내는 REST API 개발 가이드를 참고합니다.

API 출발지 목적지 경유지 출발 시간 제공되는 정보
자동차 길찾기 1개 1개 최대 5개 현재 구간별 경로 상세 안내 정보 또는 경로 요약 정보
다중 경유지 길찾기 1개 1개 최대 30개 현재 구간별 경로 상세 안내 정보 또는 경로 요약 정보
다중 출발지 길찾기 1개 이상 1개 최대 30개 현재 예상 소요 시간, 이동 거리
다중 목적지 길찾기 1개 1개 이상 최대 30개 현재 예상 소요 시간, 이동 거리
미래운행정보 길찾기 1개 1개 최대 5개 미래 구간별 경로 상세 안내 정보 또는 경로 요약 정보
참고: 제휴 안내

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

서비스 앱에 길 안내 제공하기

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

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

카카오내비 길찾기 SDK(내장형)는 Android, iOS SDK를 제공합니다. 카카오내비 길찾기 SDK(내장형)를 이용하려면 partnership@kakaomobility.com으로 별도 요청해야 합니다.

지원하는 기능

  • 이 문서는 카카오내비 길찾기 SDK(내장형) Beta에서 지원하는 기능에 대한 안내를 포함하지 않습니다.
  • 각 API 및 기능의 Kakao SDK 지원 여부는 지원 범위에서 확인할 수 있습니다.
API 및 기능 설명
길 안내 카카오내비를 실행하여 목적지까지의 길을 안내합니다.
차종이나 경로 옵션 설정, 최대 3개의 경유지 추가가 가능합니다.
목적지 공유하기 카카오내비를 실행하여 지정한 목적지 정보를 공유합니다.
목적지까지의 추천 경로, 이동 거리, 통행료와 같은 정보를 제공합니다.
길 안내 기능과 함께 사용할 수 있습니다.
자동차 길찾기 단일 출발지에서 단일 목적지까지의 경로 정보를 제공합니다.
다중 경유지 길찾기 단일 출발지에서 여러 개의 경유지를 거쳐 단일 목적지까지의 경로 정보를 제공합니다.
다중 출발지 길찾기 한 개 이상의 다중 출발지에서 단일 목적지까지의 경로 요약 정보를 제공합니다.
다중 목적지 길찾기 단일 출발지에서 한 개 이상의 다중 목적지까지의 경로 요약 정보를 제공합니다.
미래운행정보 길찾기 미래의 특정 시간을 지정하여 해당 시간을 기준으로 단일 출발지에서 단일 목적지까지의 경로 정보를 제공합니다.