매장 위치를 보여주는 카카오맵 / 네이버 지도 API를 웹사이트에 깔끔하게 삽입하고 마커 커스텀하기
매장이나 오프라인 사업장의 위치를 웹사이트에 깔끔하게 표시하는 것은 고객 방문을 유도하는 필수 요소입니다. 국내 사용자 환경에 최적화된 카카오맵과 네이버 지도 API를 활용하면 자사 사이트 디자인 스타일에 맞춰 지도를 배치하고 기본 핀 대신 매장 로고나 맞춤형 아이콘 마커를 적용할 수 있습니다. 지도 API의 동작 원리부터 실제 삽입 코드, 커스텀 마커 설정 방법 및 레이아웃 최적화 팁을 알아봅니다.
카카오맵 API 연동 및 마커 커스텀
카카오맵 API는 JavaScript SDK를 통해 지도를 생성합니다. 발급받은 API 키를 스크립트 태그에 넣은 뒤 지도 객체를 초기화하고, kakao.maps.MarkerImage 클래스를 사용해 커스텀 마커 이미지와 크기, 중심 앵커 좌표를 지정할 수 있습니다.
<!-- 카카오 지도 SDK 로드 (발급받은 APP KEY 입력) -->
<script type="text/javascript" src="//dapi.kakao.com/v2/maps/sdk.js?appkey=YOUR_APP_KEY"></script>
<!-- 지도가 표시될 영역 -->
<div id="map" style="width:100%;height:400px;"></div>
<script>
// 지도를 표시할 DIV 요소와 지도 옵션 설정
var mapContainer = document.getElementById('map');
var mapOptions = {
center: new kakao.maps.LatLng(37.5665, 126.9780), // 매장 위도, 경도 좌표
level: 3 // 지도 확대 레벨
};
// 지도 생성
var map = new kakao.maps.Map(mapContainer, mapOptions);
// 커스텀 마커 이미지 정보 설정
var imageSrc = 'https://example.com/images/custom-marker.png'; // 커스텀 마커 이미지 경로
var imageSize = new kakao.maps.Size(40, 42); // 마커 이미지의 가로, 세로 크기
var imageOption = { offset: new kakao.maps.Point(20, 42) }; // 지도 좌표에 일치시킬 마커 안의 기준 점(앵커)
// 마커 이미지 객체 생성
var markerImage = new kakao.maps.MarkerImage(imageSrc, imageSize, imageOption);
var markerPosition = new kakao.maps.LatLng(37.5665, 126.9780);
// 마커 생성 및 지도 표시
var marker = new kakao.maps.Marker({
position: markerPosition,
image: markerImage // 커스텀 마커 이미지 적용
});
marker.setMap(map);
</script>네이버 지도 API 연동 및 마커 커스텀
네이버 지도 API(nmap) 역시 유사한 구조로 작동합니다. 네이버 클라우드 플랫폼에서 Client ID를 발급받아 SDK를 불러온 후, naver.maps.Marker의 icon 속성을 통해 이미지 URL 및 앵커 포인트를 커스텀합니다.
<!-- 네이버 지도 SDK 로드 (발급받은 Client ID 입력) -->
<script type="text/javascript" src="https://openapi.map.naver.com/openapi/v3/maps.js?ncpClientId=YOUR_CLIENT_ID"></script>
<!-- 지도가 표시될 영역 -->
<div id="naverMap" style="width:100%;height:400px;"></div>
<script>
// 지도 옵션 및 객체 생성
var mapOptions = {
center: new naver.maps.LatLng(37.5665, 126.9780), // 매장 위치 좌표
zoom: 16 // 지도 확대 레벨
};
var map = new naver.maps.Map('naverMap', mapOptions);
// 네이버 지도 커스텀 마커 생성
var marker = new naver.maps.Marker({
position: new naver.maps.LatLng(37.5665, 126.9780),
map: map,
icon: {
url: 'https://example.com/images/custom-marker.png', // 커스텀 아이콘 URL
size: new naver.maps.Size(40, 42), // 이미지 규격
scaledSize: new naver.maps.Size(40, 42), // 출력될 이미지 크기
anchor: new naver.maps.Point(20, 42) // 핀의 끝점이 위치할 앵커 좌표
}
});
</script>반응형 웹 레이아웃 최적화 기법
모바일과 데스크톱 화면에 맞춰 지도가 이질감 없이 깔끔하게 표시되도록 하려면 스타일과 리사이즈 이벤트를 정돈해야 합니다.
- 가로 폭 반응형 처리: 지도 컨테이너의 너비(
width)를100%로 지정하고 고정 높이 지정 또는 CSSaspect-ratio를 지정합니다. - 리사이즈 중심 유지: 창 크기가 변경될 때 지도가 깨지거나 중심 위치가 어긋나는 것을 방지하기 위해 브라우저 리사이즈 이벤트 시 중심 재설정 함수를 호출합니다.
- 플랫폼 약관 준수: API 발급 서비스의 개발자 약관 및 도메인 등록 규정을 준수하여 실제 운영 환경의 도메인이 등록되어 있는지 확인해야 합니다.
자주 겪는 문제
- 지도 영역이 하얗게 비어 있거나 레이아웃이 깨져서 나오는 증상
- 원인: 지도 컨테이너 DIV 요소에
height높이값이 지정되지 않았거나, 스크립트가 DOM 요소보다 먼저 실행된 경우입니다. - 해결: CSS로 DIV에 명확한
height값을 주고, 지도 생성 스크립트를 DOM 로드 이후(DOMContentLoaded또는 페이지 하단)에 실행합니다.
- 창 크기를 줄이거나 모달/탭 전환 후 지도의 중심점이 어긋나는 증상
- 원인: 지도가 숨겨진 상태(
display: none)에서 초기화되었거나 영역 크기가 변했을 때 좌표 재계산이 일어나지 않았기 때문입니다. - 해결: 탭이 열리거나 화면 크기가 변경되는 시점에 카카오맵은
map.relayout()및map.setCenter(), 네이버 지도는map.autoResize()및map.setCenter()를 호출합니다.
- 커스텀 마커 이미지가 실제 위치보다 위나 아래로 엇갈려 찍히는 증상
- 원인: 커스텀 마커의 앵커(
offset또는anchor) 좌표를 설정하지 않아 이미지의 좌측 상단이 해당 위경도 지점에 찍히는 현상입니다. - 해결: 마커 이미지 뾰족한 끝부분의 상대 위치 좌표(예: 가로 중앙 20px, 세로 맨 아래 42px)를 앵커 포인트로 명확히 지정합니다.
정리
카카오맵과 네이버 지도 API를 활용하면 몇 줄의 코드만으로 웹사이트에 매장 위치를 깔끔하게 삽입할 수 있습니다. 자사 브랜드 아이콘으로 마커를 커스텀할 때는 이미지 앵커 포인트를 정확히 맞춰 지점 오차를 줄이는 것이 핵심입니다. 반응형 레이아웃과 화면 전환 이벤트를 고려해 재정렬 함수를 작성하면 사용자에게 신뢰감 있는 위치 안내를 제공할 수 있습니다.
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.