카카오 JavaScript 키 발급·지도 설정 안내

카카오 지도용으로 필요한 값은 JavaScript 키입니다. 고객의 카카오 계정으로 앱을 만들고 운영 도메인을 등록한 뒤, 발급받은 키를 관리자에 입력합니다. 이 솔루션에서는 카카오톡 공유에도 같은 키를 사용합니다.

발급하고 입력하는 순서

1. 카카오 디벨로퍼스에서 앱을 만듭니다카카오 디벨로퍼스에 고객 계정으로 로그인해 개발자 등록과 앱 생성을 진행합니다. 앱 이름과 사업자 정보는 실제 운영 서비스에 맞게 입력합니다.
2. JavaScript 키를 선택합니다앱 → 앱 설정 → 앱 → 플랫폼 키에서 사용할 JavaScript 키를 선택합니다. REST API 키나 Admin 키를 복사하지 마세요.
3. JavaScript SDK 도메인을 등록합니다해당 키의 도메인 설정에 실제 운영 주소(예: https://example.com)를 등록합니다. www나 하위 도메인으로도 서비스를 제공하면 그 주소도 확인해 등록합니다. 부고웍스 샘플 주소가 아니라 고객의 실제 주소를 사용합니다.
4. 키를 복사해 관리자에 저장합니다키를 복사해 내 사이트 관리자 → 설정 → 카카오 연동 → 카카오 JavaScript 키 (카카오 지도용)에 입력합니다.
5. 운영 사이트에서 지도를 확인합니다장례식장 위치나 부고장의 지도 화면을 열어 확인합니다. 지도가 나오지 않으면 키 종류, 등록 도메인과 실제 접속 주소, 카카오 콘솔의 이용 상태를 확인합니다.

키와 채널 주소는 다른 값입니다

카카오 채널 주소와 오픈채팅 주소는 별도 입력란에 넣습니다. JavaScript 키를 발급한다고 채널이나 오픈채팅이 자동으로 만들어지지는 않습니다. 키가 없으면 카카오톡 공유 버튼은 숨겨지고 지도는 대체 지도(OSM)로 표시됩니다.

공식 안내: 카카오 지도 Web API 준비하기 · 카카오 앱·플랫폼 키 설정