Programming/Web

Kakao map web API "Uncaught ReferenceError: kakao is not defined" error

Half YOLO 2025. 1. 13. 20:31
반응형

카카오맵 Web API 사용 시 아래와 같은 에러가 발생할 경우 확인해봐야 할 내용 5가지

Uncaught ReferenceError: kakao is not defined

내 경우 5번째 "앱 권한 신청" 후 문제를 해결했다.

 

1. 잘못된 키 사용 여부

    <script type="text/javascript" src="//dapi.kakao.com/v2/maps/sdk.js?appkey={JavaScript 키}&libraries=services,clusterer,drawing"></script>

키를 넣어줄 때 [내 애플리케이션 - 앱 설정 - 앱 키]에서 JavaScript 키를 넣어줬는지 확인, 키가 만료된것은 아닌지 함께 확인.

 

2. 도메인 등록

API를 호출하는 도메인이 [내 애플리케이션 - 앱 설정 - 플랫폼 - Web]에 등록되어 있는지 확인

 

3. 선언부가 <body>에 있다면 <head>로 이동

로직에 따라 타이밍 이슈가 있는듯 함

    <haed>
    <script type="text/javascript" src="//dapi.kakao.com/v2/maps/sdk.js?appkey={JavaScript 키}&libraries=services,clusterer,drawing"></script>
    ...
    </head>

 

4. https 사용

   <script type="text/javascript" src="https://dapi.kakao.com/v2/maps/sdk.js?appkey={JavaScript 키}&libraries=services,clusterer,drawing"></script>

 

5. 앱 권한 신청

2024년 12월 1일부터 신규 어플리케이션들은 별도로 카카오맵 API를 활성화해야 한다.

ref : https://devtalk.kakao.com/t/api/140875

 

[내 애플리케이션 - 앱 설정 - 앱 권한 신청]에서 먼저 "비즈 앱 전환"을 진행해 준다.

이후 카카오맵 API는 별도 승인요청 없이 [내 애플리케이션 - 제품 설정 - 카카오맵]에서 직접 ON 해주면 사용 가능하다.

반응형