이 문서는 카카오맵 API를 소개합니다.
카카오맵 API는 웹과 앱 서비스에서 위치 기반 데이터를 조회하는 REST API와, 카카오맵을 표시하고 제어하는 지도 SDK를 제공합니다. 데이터 조회와 지도 기능 구현에 사용할 수 있는 기능 목록은 제공 방식에서 확인할 수 있습니다.
카카오맵 API는 REST API와 지도 SDK 두 가지 방식으로 제공합니다.
REST API는 장소, 주소, 좌표, 경로와 같은 데이터를 조회하거나 지도 이미지를 생성하는 기능을 제공합니다. 지번 주소와 도로명 주소 체계를 모두 지원합니다. 전체 API 규격은 REST API 문서에서 확인할 수 있습니다.
| 구분 | 제공 기능 |
|---|---|
| 주소/좌표 변환 | 주소와 좌표 변환, 좌표계 변환 |
| 장소 검색 | 키워드 및 카테고리 기반 장소 검색 |
| 경로 조회 | 출발지와 도착지 좌표 기준 대중교통, 도보, 자전거 경로 조회 |
| 정적 지도 조회 | 지정한 좌표와 옵션 기반 정적 지도 이미지 생성 |
지도 SDK는 웹과 모바일 애플리케이션에서 카카오맵을 표시하고 제어하는 기능을 제공합니다. 지도 SDK의 개발 문서, 레퍼런스, 샘플은 Kakao Maps API 웹사이트에서 확인할 수 있습니다.
| 구분 | 사용 환경 | 사용 플랫폼 키 | 참고 |
|---|---|---|---|
| 지도 Web(JavaScript) SDK | 웹 서비스에서 카카오맵 지도 기능 구현 | JavaScript 키 | 지도 Web SDK 개발 문서 |
| 지도 Android SDK | Android 앱에서 카카오맵 지도 기능 구현 | 네이티브앱 키 | 지도 Android SDK 개발 문서 |
| 지도 iOS SDK | iOS 앱에서 카카오맵 지도 기능 구현 | 네이티브앱 키 | 지도 iOS SDK 개발 문서 |
지도 SDK로 API 호출 시, 반드시 지정된 종류의 플랫폼 키를 사용해야 합니다. 지도 SDK에 REST API 키를 사용하지 않도록 주의합니다. 잘못된 앱 키 사용 시 에러가 발생합니다.
카카오맵 API를 사용하려면 아래 작업을 수행해야 합니다.
- 카카오디벨로퍼스 앱 생성
- 카카오맵 API 활성화: 앱 관리 페이지의 [카카오맵] > [사용 설정]의 [상태]를 [ON]으로 설정
- 개발자 계정 기준 첫 번째로 카카오맵 API를 활성화한 앱에만 무료 쿼터 제공(참고: 무료 쿼터 적용 앱 확인)
- 카카오맵 REST API 사용 시, 사용할 REST API 키에 필요한 설정 등록
- 카카오맵 지도 SDK 사용 시 플랫폼별 지정된 플랫폼 키에 아래 정보 등록
- Web(JavaScript) SDK: JavaScript 키의 JavaScript SDK 도메인
- Android/iOS SDK: 네이티브 앱 키의 Android/iOS 앱 정보
- 아래 조건에 하나라도 해당하는 경우, 비즈월렛 연결 후 유료 API 사용 설정 필요
카카오맵 API를 개발자 계정 기준 첫 번째로 활성화해 무료 쿼터를 제공받는 앱은, 앱 정보에 [카카오맵 무료 쿼터] 뱃지가 표시됩니다.
2026년 7월 21일부터 카카오맵 API 사용 방법과 무료 쿼터 제공 방식이 변경되었습니다. 자세한 안내는 공지를 참고합니다.
카카오 API는 원활한 서비스 제공을 위해 월간 및 일간 쿼터(Quota)를 적용합니다. 현재 적용 중인 무료 쿼터 정보는 무료 제공 쿼터에서 확인할 수 있습니다.
카카오맵 API는 개발자 계정 기준 첫 번째로 활성화한 앱에만 무료 쿼터를 제공합니다. 첫 번째로 활성화한 앱이 아닌 앱(두 번째 활성화 앱 부터) 또는 무료 쿼터를 초과해 사용해야 하는 경우, 비즈월렛 연결 및 유료 API 사용 설정 후 사용량 기반 과금으로 이용할 수 있습니다. 사용량 기반 과금 정보는 추가 쿼터 사용 요금에서 확인할 수 있습니다.
카카오맵 API는 앱별로 무료로 제공하는 쿼터가 있습니다. 무료 제공량을 모두 소진한 경우, 429 에러가 발생합니다.
무료 제공량 외에 더 많은 제공량이 필요한 경우, 유료 API를 설정해 추가 API를 호출할 수 있습니다. 자세한 설정은 유료 API를 참고합니다.
앱 관리 페이지의 [통계] > [쿼터]에서 내 앱이 사용한 월간 및 일간 쿼터를 확인할 수 있습니다.
네. [도구] > [리소스 다운로드] > [카카오맵]에서 카카오맵 로고와 디자인 가이드를 제공합니다. 카카오맵 API를 활용하는 서비스나 바로가기 아이콘으로 사용할 수 있습니다.
로고 사용 시, 사용자에게 일관된 브랜드 이미지를 전달하기 위해 디자인 가이드를 준수하는 것을 권장합니다. 디자인 가이드는 리소스 다운로드 페이지에서 함께 제공합니다.
데브톡의 카카오맵 API 게시판의 게시글을 찾아보거나, 서비스 소유자나 관계자로 확인되는 계정으로 글을 남기면 담당자가 빠르게 대응할 수 있습니다.
아래 표는 REST API 문서에서 제공하는 API 목록입니다. 지도 SDK의 플랫폼별 API는 Kakao Maps API 웹사이트에서 확인합니다.
각 API의 Kakao SDK 지원 여부는 지원 범위에서 확인할 수 있습니다.
| API | 메서드 | URL | 설명 |
|---|---|---|---|
| 주소로 좌표 변환 | GET | https://dapi.kakao.com/v2/local/search/address.${FORMAT} | 요청한 문자열 주소의 좌표와 세부 정보를 반환합니다. |
| 좌표로 행정구역정보 변환 | GET | https://dapi.kakao.com/v2/local/geo/coord2regioncode.${FORMAT} | 지정한 좌표값에 해당하는 행정동과 법정동 정보를 반환합니다. |
| 좌표로 주소 변환 | GET | https://dapi.kakao.com/v2/local/geo/coord2address.${FORMAT} | 지정한 좌표값에 해당하는 지번 주소와 도로명 주소 정보를 반환합니다. |
| 좌표계 변환 | GET | https://dapi.kakao.com/v2/local/geo/transcoord.${FORMAT} | 특정 좌표계의 좌표값을, 지정한 좌표계의 좌표값으로 반환합니다. |
| API | 메서드 | URL | 설명 |
|---|---|---|---|
| 키워드로 장소 검색 | GET | https://dapi.kakao.com/v2/local/search/keyword.${FORMAT} | 요청한 키워드에 부합하는 장소 검색 결과를 지정한 정렬 기준으로 반환합니다. |
| 카테고리로 장소 검색 | GET | https://dapi.kakao.com/v2/local/search/category.${FORMAT} | 요청한 카테고리 코드에 해당하는 장소 검색 결과를 지정한 정렬 기준으로 반환합니다. |
| API | 메서드 | URL | 설명 |
|---|---|---|---|
| 대중교통 경로 조회 | GET | https://dapi.kakao.com/v2/routing/publictraffic | 지정한 출발지와 도착지 좌표의 대중교통 경로를 반환합니다. |
| 도보 경로 조회 | GET | https://dapi.kakao.com/v2/routing/walk | 지정한 출발지와 도착지 좌표의 도보 경로를 반환합니다. |
| 자전거 경로 조회 | GET | https://dapi.kakao.com/v2/routing/bicycle | 지정한 출발지와 도착지 좌표의 자전거 경로를 반환합니다. |
| API | 메서드 | URL | 설명 |
|---|---|---|---|
| 정적 지도 조회 | GET | https://dapi.kakao.com/v2/maps/staticmap | 지정한 좌표와 옵션을 반영한 정적 지도 이미지를 생성해 반환합니다. |