로컬
이해하기
이 문서는 로컬(Local) API를 소개합니다.
로컬(Local) API는 키워드로 특정 장소 정보를 조회하거나, 좌표를 주소 또는 행정구역으로 변환하는 등 장소에 대한 정보를 제공합니다. 특정 카테고리로 장소를 검색하는 등 폭넓은 활용이 가능하며, 지번 주소와 도로명 주소 체계를 모두 지원합니다.
장소 정보 활용 예시
로컬 API를 사용하려면 아래 작업을 수행해야 합니다.
- 카카오디벨로퍼스 앱 생성
- 카카오맵 API 활성화: 앱 관리 페이지의 [카카오맵] > [사용 설정]의 [상태]를 [ON]으로 설정
- 이미 카카오맵 API를 활성화한 앱을 소유한 개발자가 추가로 카카오맵 API를 활성화해야 하는 경우, 추가 기능 신청으로 권한 신청 및 승인 후 설정 가능
카카오맵 API 활성화
2024년 12월 1일부터 신규로 카카오맵 API를 호출하는 앱은 카카오맵 사용 설정이 필요 합니다. 자세한 안내는 공지를 참고합니다.
카카오 API는 원활한 서비스 제공을 위해 월간 및 일간 쿼터(Quota)를 적용합니다. 현재 적용 중인 쿼터 정보는 쿼터에서 확인할 수 있습니다.
무료 제공 쿼터 외에 추가 제공량이 필요한 경우 유료 API 설정이 필요합니다. 자세한 설정 방법은 유료 API를 참고합니다.
Kakao 지도 API는 Web(JavaScript)과 모바일 애플리케이션(Android, iOS)에서 지도를 이용한 서비스를 제작할 수 있도록 다양한 기능을 제공하고 있습니다. 지도 SDK에 대한 내용은 Kakao Maps API 웹사이트를 참고합니다.
각 API의 Kakao SDK 지원 여부는 지원 범위에서 확인할 수 있습니다.
| API | 메서드 | URL | 설명 |
|---|---|---|---|
| 주소로 좌표 변환 | GET | https://dapi.kakao.com/v2/local/search/address.${FORMAT} | 주소를 지도 위에 정확하게 표시하기 위해 해당 주소의 좌표 정보를 제공하는 API입니다. |
| 좌표로 행정구역정보 변환 | 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} | x, y 값과 입력 및 출력 좌표계를 지정해 변환된 좌표 값을 구해, 서로 다른 좌표계간 데이터 호환이 가능하도록 합니다. |
| 키워드로 장소 검색 | GET | https://dapi.kakao.com/v2/local/search/keyword.${FORMAT} | 질의어에 매칭된 장소 검색 결과를 지정된 정렬 기준에 따라 제공합니다. |
| 카테고리로 장소 검색 | GET | https://dapi.kakao.com/v2/local/search/category.${FORMAT} | 미리 정의된 카테고리 코드에 해당하는 장소 검색 결과를 지정된 정렬 기준에 따라 제공합니다. |