카카오지도에 위치를 표시하는 기능을 사용하기 위해서, 카카오지도 앱 키를 발급받아서 적용해 주셔야 합니다.
■ 카카오지도 앱 키 발급 방법
https://developers.kakao.com/ 에서 키를 발급받으실 수 있습니다.
카카오 키 발급 방법 매뉴얼 (https://bos.kr/kwa-manual_v-1608)의 1번 내용을 참고하여 앱 키를 발급 받아주세요.
■ 앱 키 적용 방법
1. 관리자 메뉴 > 확장기능 > 템플릿관리 메뉴를 클릭해 주세요.
2. 우편번호검색(주소검색) 우측의 '수정' 버튼을 클릭해 주세요.
3. 설정값 영역의 js_key, rest_key 에 위에서 발급받은 앱 키를 입력해 주세요.
- JavaScript 키 -> js_key에 입력
- REST API 키 -> rest_key에 입력
※ 키 입력시 공백이 포함되지 않도록 주의해 주세요.
■ 2025년 5월 추가 설정 사항 안내
카카오 지도 API를 사용하기 위해 API 키 입력 후에도 지도가 정상적으로 노출되지 않는 경우, 아래 설정을 추가로 확인해 주세요.
카카오맵 활성화 설정 방법
1. Kakao Developers에 접속 후 내 애플리케이션으로 이동
2. 제품 설정 > 카카오맵 메뉴로 이동
3. 카카오맵 활성화 설정을 ON으로 변경
![]()
참고: 카카오맵 기능을 활성화하려면 해당 앱을 비즈앱으로 전환해야 합니다.
비즈앱 전환 방법
1. 카카오맵 활성화 버튼을 누르면 아래와 같은 안내가 표시됩니다.
![]()
2. 안내에 따라 비즈앱 전환 절차를 완료한 뒤, 다시 카카오맵 활성화 설정을 ON 해 주세요.
