← 포럼 · 소프트웨어
소프트웨어

매장 위치를 보여주는 카카오맵 / 네이버 지도 API를 웹사이트에 깔끔하게 삽입하고 마커 커스텀하기

2026.11.17조회 16댓글 0

매장이나 오프라인 사업장의 위치를 웹사이트에 깔끔하게 표시하는 것은 고객 방문을 유도하는 필수 요소입니다. 국내 사용자 환경에 최적화된 카카오맵과 네이버 지도 API를 활용하면 자사 사이트 디자인 스타일에 맞춰 지도를 배치하고 기본 핀 대신 매장 로고나 맞춤형 아이콘 마커를 적용할 수 있습니다. 지도 API의 동작 원리부터 실제 삽입 코드, 커스텀 마커 설정 방법 및 레이아웃 최적화 팁을 알아봅니다.

카카오맵 API 연동 및 마커 커스텀

카카오맵 API는 JavaScript SDK를 통해 지도를 생성합니다. 발급받은 API 키를 스크립트 태그에 넣은 뒤 지도 객체를 초기화하고, kakao.maps.MarkerImage 클래스를 사용해 커스텀 마커 이미지와 크기, 중심 앵커 좌표를 지정할 수 있습니다.

html
<!-- 카카오 지도 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 및 앵커 포인트를 커스텀합니다.

html
<!-- 네이버 지도 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%로 지정하고 고정 높이 지정 또는 CSS aspect-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

아직 댓글이 없습니다. 첫 질문을 남겨 주세요.

찾으시는 내용이 없다면

만들고 싶은 것이나 막힌 부분을 알려주시면 검토해 드립니다.