카카오모빌리티 디벨로퍼스 문서 길찾기 API 시작하기

시작하기 전에 링크 복사

앱 등록 및 REST API 키 확인하기 링크 복사

길찾기 API를 사용하기 위해서는 애플리케이션(이하 앱)을 등록하고 REST API 키를 발급 받아야 합니다.

1. 앱 등록하기 링크 복사

[카카오디벨로퍼스에서 진행]

  1. 카카오디벨로퍼스에 로그인하세요. 계정이 없을 경우, 회원 가입을 한 후 다음 단계를 진행하세요.

  2. 로그인 후, 화면 오른쪽 상단에서 내 애플리케이션 → 애플리케이션 추가하기를 클릭하세요.

  3. 아래 각 항목에 추가할 내용을 확인하여 앱을 추가하세요.

    • 앱 아이콘: 앱 아이콘으로 사용할 이미지를 추가합니다. 권장하는 이미지의 사이즈는 128 px * 128 px이며 최대 250 KB 크기의 파일을 등록할 수 있습니다. 지원하는 파일 포맷은 JPG, GIF, PNG입니다.

    • 앱 이름: 내 앱(서비스)의 이름을 설정합니다. * 필수 입력 사항

    • 사업자명: 사업자명을 입력합니다. 사업자 정보와 동일한 이름을 사용해야 합니다. * 필수 입력 사항

      주의: 앱(서비스) 이름은 공백 포함 30자까지 입력할 수 있습니다.

  4. 각 항목을 입력한 후 저장을 눌러 앱을 생성하세요.

    생성된 앱은 내 애플리케이션에서 확인할 수 있습니다.

자세한 내용은 카카오디벨로퍼스의 애플리케이션 등록을 참고하세요.

2. REST API 키 확인하기 링크 복사

[카카오디벨로퍼스에서 진행]

위의 단계에서 앱을 생성했다면 앱 키(App Key)가 발급됩니다. REST API를 호출하기 위해서는 REST API 키 값이 필요합니다.

  1. 내 애플리케이션 → 앱 설정 → 요약 정보 또는 내 애플리케이션 → 앱 설정 → 앱 키를 클릭하세요.
  2. REST API 키 값을 복사하여 사용하세요.

길찾기 API 제공 정보 링크 복사

각각의 API별로 설정할 수 있는 장소 개수와 제공 정보는 다음과 같습니다.

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

길찾기 API 사용에 대한 쿼터와 가격을 확인할 수 있습니다. 각 API에 대한 쿼터 상향이 필요하거나 위의 표에서 언급한 최대 장소 개수를 초과하여 설정할 경우 제휴 문의로 문의하세요.

길찾기 API 목록 링크 복사

길찾기 API에서 제공하는 기능과 기본적인 요청 규격 정보는 아래와 같습니다.

표 2 길찾기 API
Name URL Host Method
자동차 길찾기 /v1/directions https://apis-navi.kakaomobility.com GET
다중 경유지 길찾기 /v1/waypoints/directions https://apis-navi.kakaomobility.com POST
다중 출발지 길찾기 /v1/origins/directions https://apis-navi.kakaomobility.com POST
다중 목적지 길찾기 /v1/destinations/directions https://apis-navi.kakaomobility.com POST
미래 운행 정보 길찾기 /v1/future/directions https://apis-navi.kakaomobility.com GET

REST API 테스트 링크 복사

이 문서에서 제공하는 길찾기 API는 카카오디벨로퍼스 REST API 테스트에서 사용해 볼 수 있습니다. 문서에 설명된 쿼리 스트링을 입력한 후 전송을 눌러 응답을 확인해 보세요.