그누보드5·카페24·아임웹 오시는길 지도 백지 오류, 구형 SDK 종료 전 1분 교체 가이드
SSL(https://) 적용 후 http://apis.daum.net 혼용 차단이나 구형 약도 스크립트 중단으로 멈춘 오시는길 화면을, 기존 위·경도 좌표를 그대로 살린 최신 dapi.kakao.com/v2 비동기 코드 + 4.5초 길찾기 폴백으로 즉시 교체합니다.
5초 진단
구형 도메인·HTTP 차단 즉시 판별
좌표 자동 이식
기존 LatLng 위·경도 재조사 불필요
4.5초 폴백
앱키 누락 시 길찾기 버튼 자동 노출
플랫폼별 오시는길 파일 위치 및 교체 주의사항
관리자 메뉴에서 아래 경로만 열면 FTP 접속 없이 1분 안에 새 코드로 덮어쓸 수 있습니다.
| 홈페이지 환경 | 기존 지도 코드 위치 | 자주 발생하는 백지 원인 및 해결 포인트 |
|---|---|---|
| 그누보드5 · 영카트5 | 관리자 > 게시판관리 > 내용관리(content) 또는 테마 내 skin/content/basic/content.skin.php |
에디터 필터링으로 <script>가 잘리거나 http://apis.daum.net 혼합 콘텐츠 차단 발생 → HTML 소스 모드에서 https://dapi.kakao.com/v2/maps/sdk.js?autoload=false 비동기 코드로 교체 |
| 카페24 스마트디자인 | 디자인관리 > 스마트디자인 편집창 > company/location.html (또는 오시는길 모듈) |
쇼핑몰 기본 SSL 적용 후 구형 http://t1.daumcdn.net 약도 로더 차단 및 대표 도메인(www 유무) 미등록 → 카카오 콘솔에 https://도메인과 https://www.도메인 동시 등록 |
| 아임웹 · 워드프레스 | 아임웹 디자인 모드 > 코드(Code) 위젯 / 워드프레스 사용자 정의 HTML 블록 |
탭(Tab)·모달 내부에 지도가 들어 있을 때 초기 너비가 0px로 잡혀 회색 깨짐 발생 → 비동기 kakao.maps.load 완료 후 렌더링 및 4.5초 먹통 폴백 내장 필수 |
수동 수정 시 빠뜨리기 쉬운 3가지 체크리스트
- 카카오 개발자 콘솔 Web 플랫폼 도메인:
https://example.com과https://www.example.com두 줄을 모두 등록해야 모바일 유입에서 차단이 발생하지 않습니다. - REST API 키가 아닌 JavaScript 키 사용: 브라우저 지도 SDK에는 반드시 JavaScript 키를 넣어야 정상 로드됩니다.
- 앱키 한도 초과·도메인 전파 지연 대비: 스크립트만 교체하면 장애 시 또 빈 박스가 남으므로, 4.5초 내 미로드 시 매장 주소와 카카오맵·네이버지도 길찾기 버튼을 띄우는 폴백 함수를 함께 넣는 것이 안전합니다.
웹에이전시·프리랜서 무제한 거래처 패스 (월 4,900원)
관리 중인 그누보드·카페24·아임웹 거래처가 10곳이든 50곳이든 월 4,900원 패스 1개로 개수 제한 없이 교체 코드를 생성할 수 있습니다. 6대 마켓 발주서 통합기 + 영카트5 PHP KCP 결제 복구기까지 동시 잠금 해제되며 7일 내 100% 환불을 보장합니다.