Sunny's Coding Diary

[Web] - 카카오 맵 API를 활용하여 지도만들기 본문

Project

[Web] - 카카오 맵 API를 활용하여 지도만들기

Sunny._. 2023. 9. 11. 15:41

소프트웨어 공학 팀 프로젝트로 길 찾기 프로그램을 만들고 싶었다.

 

우선 HTML, 자바스크립트, CSS 기초 웹프로그래밍에서 카카오 맵 API를 접목하여 지도를 불러오고 검색 기능을 만들어 해당 위치의 좌표를 불러와 지도에 표시하였다.

지도에 표시는 하였지만 길찾기 알고리즘을 무료 API에 적용시키기는 것은 매우 힘들었다. 우리가 흔히 알고 있는 코드들이 아닌 카카오 맵에서 사용하는 코드들이었기 때문에 이해하는데 어려웠다.....

 

따라서 기존 길찾기 프로그램에서 지도 프로그램을 변경하였다.

지도에서 우리가 보여줄 수 있는 부분들이 무엇이 있을까??

구현한 기능들은 다음과 같다.

 

1. 지도 불러오기

2. 위치 검색 후 해당 위치에 마커 표시하기

3. 주변 편의시설 검색

4. 실시간 교통정보 확인

5. 자전거 전용 도로 확인

6. 스카이뷰

 

6가지 기능들을 구현하였다.

 

먼저 기능에 대한 사진들이다.

 

1. 지도 불러오기

초기화면

위 사진은 카카오 맵 API를 이용하여 실제 지도를 불러온 초기 화면이다. 초기 지도 좌표 값으로 강릉원주대 원주캠퍼스를 기점으로 넣었다.

 

2. 위치 검색 후 해당 위치에 마커 표시하기

출발지와 목적지 입력

출발지와 목적지를 입력하게 되었을 때 지도상에 마커를 표시하게 한다.

 

위 기능을 구현할 때 초기에는 해당 위치의 주소를 정확하게 입력해야 마커가 찍혔다. 원하는 위치를 확인할 때 정확한 주소를 사용하는 사람들도 있지만 대부분의 사람들은 키워드를 통해 검색할 것이다. 그렇기 때문에 초기 방법도 포함한 키워드를 통해 위치를 찾을 수 있게 구현했다.

 

사진에서는 출발지와 목적지를 둘다 입력했지만 원하는 위치 한 곳을 찾고 싶다면 출발지를 입력하는 부분에 원하는 장소를 검색하면 하나의 위치만 지도상에 표시되게 된다.

 

3. 주변 편의시설 검색

은행 검색
마트 검색
약국 검색
주유소 검색
카페 검색
편의점 검색
편의 시설 기능의 상세정보

편의 시설을 카테고리로 분류하여 해당 버튼을 누르면 지도상에 해당하는 편의 시설을 보여준다.

또한 지도에 표시된 마커들을 클릭하게 되면 해당 편의 시설의 이름과 위치를 보여준다.

 

4. 실시간 교통정보 확인

교통정보 1
교통정보 2

오른쪽 상단의 교통정보 버튼을 누르면 지도 상에 교통정보를 표시해준다.

이 부분을 구현할 때 실시간 교통정보를 보여주는지에 대한 의문점이 생겨 시간마다 확인한 결과 차량들이 많이 몰리는 퇴근시간 때에는 주요 지역에 교통이 혼잡한 빨간색 선들이 많이 보이는 것을 확인하였다.

또한 교통정보를 보여주는 기능이기 때문에 색으로 나타난 부분들은 도로라는 것을 확인할 수 있었다.

 

5. 자전거 전용 도로 확인

자전거 전용 도로

교통정보와 다른 자전거 전용도로를 지도에 표시해 주는 기능이다.

자전거 도로를 포함한 산책로도 지도에 표시해 주고 자전거도로들의 이름도 보여준다.

 

6. 스카이뷰

스카이뷰
스카이뷰 + 교통정보

스카이뷰 기능은 위에서 보이는 지도를 실제 지형으로 표시하여 보여준다. 아래 사진은 스카이뷰 기능을 사용했을 때 교통정보 기능을 합친 것이고 스카이뷰 기능을 사용해도 위에서 설명한 기능들을 전부 사용할 수 있다.

 

이렇게 6가지 기능들을 사진과 함께 설명하였다.

 

다음은 소스코드이다.

 

[Map.html]

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>소프트웨어공학 2팀</title>
    <link rel="stylesheet" type="text/css" href="style.css">
</head>
<body>
    <div class="row">
        <div class="left">
            <h1>길찾기</h1>
            <!--출발지 및 목적지 설정-->
            <input type="text" id="start" placeholder="출발지 키워드 / ex 강릉원주대">
            <input type="text" id="end" placeholder="목적지 키워드 / ex 원주역">
            <button onclick="searchMarkers()">검색</button>
            <p>
                정보<br>
                <input type="checkbox" id="chkBicycle" onclick="setOverlayMapTypeId()" /> 자전거도로 정보 보기 <br>
            </p>
        </div>
        <p style="margin-top:-12px"></p>
        <div class="map_wrap">
        <div id="map" style="width:100%;height:100%;position:relative;overflow:hidden;"></div>
        <ul id="category">
        <li id="BK9" data-order="0"> 
            <span class="category_bg bank"></span>
            은행
        </li>       
        <li id="MT1" data-order="1"> 
            <span class="category_bg mart"></span>
            마트
        </li>  
        <li id="PM9" data-order="2"> 
            <span class="category_bg pharmacy"></span>
            약국
        </li>  
        <li id="OL7" data-order="3"> 
            <span class="category_bg oil"></span>
            주유소
        </li>  
        <li id="CE7" data-order="4"> 
            <span class="category_bg cafe"></span>
            카페
        </li>  
        <li id="CS2" data-order="5"> 
            <span class="category_bg store"></span>
            편의점
        </li>      
        </ul>
    </div>
</div>
<div class="traffic radius_border">
    <span id="traffic_button" onclick="toggleTraffic()">교통 정보</span>
    <span id="Skyview_button" onclick="toggleSkyview()">스카이뷰</span>
</div>
<div class="custom_zoomcontrol radius_border">
    <span onclick="zoomIn()"><img src="https://t1.daumcdn.net/localimg/localimages/07/mapapidoc/ico_plus.png" alt="확대"></span>  
    <span onclick="zoomOut()"><img src="https://t1.daumcdn.net/localimg/localimages/07/mapapidoc/ico_minus.png" alt="축소"></span>
</div>
<script type="text/javascript" src="//dapi.kakao.com/v2/maps/sdk.js?appkey=7d29e326e0f7eb1cefaed137d88d4323&libraries=services"></script>
<script src="MapScript.js"></script>
</body>
</html>

 

[MapScript.js]

// JavaScript 코드
document.addEventListener("DOMContentLoaded", function() {
    var skyviewButton = document.getElementById("Skyview_button");
    var trafficButton = document.getElementById("traffic_button");
  
    skyviewButton.addEventListener("click", function() {
      skyviewButton.classList.toggle("active");
    });
  
    trafficButton.addEventListener("click", function() {
      trafficButton.classList.toggle("active");
    });
  });
  
      // 마커를 클릭했을 때 해당 장소의 상세정보를 보여줄 커스텀오버레이입니다
      var placeOverlay = new kakao.maps.CustomOverlay({zIndex:1}), 
          contentNode = document.createElement('div'), // 커스텀 오버레이의 컨텐츠 엘리먼트 입니다 
          markers = [], // 마커를 담을 배열입니다
          currCategory = ''; // 현재 선택된 카테고리를 가지고 있을 변수입니다
      
      var mapContainer = document.getElementById('map'), // 지도를 표시할 div 
          mapOption = {
              center: new kakao.maps.LatLng(37.305, 127.923), // 지도의 중심좌표
              level: 5 // 지도의 확대 레벨
          };  
  
      // 지도를 생성합니다    
      var map = new kakao.maps.Map(mapContainer, mapOption); 
  
      //출발지 및 목적지
      {
          var startMarker = new kakao.maps.Marker({
              map: map
          });
  
          var endMarker = new kakao.maps.Marker({
              map: map
          });  
          function searchMarkers() {
              var startKeyword = document.getElementById('start').value;
              var endKeyword = document.getElementById('end').value;
              var places = new kakao.maps.services.Places();
  
              // 출발지 검색
              places.keywordSearch(startKeyword, function (startResult, startStatus) {
                  if (startStatus === kakao.maps.services.Status.OK) {
                      var startPlace = startResult[0];
                      var startCoords = new kakao.maps.LatLng(startPlace.y, startPlace.x);
                      startMarker.setPosition(startCoords);
                      map.setCenter(startCoords);
                  }
              });
  
             // 목적지 검색
             places.keywordSearch(endKeyword, function (endResult, endStatus) {
                 if (endStatus === kakao.maps.services.Status.OK) {
                     var endPlace = endResult[0];
                     var endCoords = new kakao.maps.LatLng(endPlace.y, endPlace.x);
                     endMarker.setPosition(endCoords);
                     map.setCenter(endCoords);
                 }
             });
          }
      }
  
      // 지도 확대, 축소 컨트롤에서 확대 버튼을 누르면 호출되어 지도를 확대하는 함수입니다
      function zoomIn() {
          map.setLevel(map.getLevel() - 1);
      }
  
      // 지도 확대, 축소 컨트롤에서 축소 버튼을 누르면 호출되어 지도를 확대하는 함수입니다
      function zoomOut() {
          map.setLevel(map.getLevel() + 1);
      }
  
      // 장소 검색 객체를 생성합니다
      var ps = new kakao.maps.services.Places(map); 
  
      // 지도에 idle 이벤트를 등록합니다
      kakao.maps.event.addListener(map, 'idle', searchPlaces);
  
      // 커스텀 오버레이의 컨텐츠 노드에 css class를 추가합니다 
      contentNode.className = 'placeinfo_wrap';
  
      // 커스텀 오버레이의 컨텐츠 노드에 mousedown, touchstart 이벤트가 발생했을때
      // 지도 객체에 이벤트가 전달되지 않도록 이벤트 핸들러로 kakao.maps.event.preventMap 메소드를 등록합니다 
      addEventHandle(contentNode, 'mousedown', kakao.maps.event.preventMap);
      addEventHandle(contentNode, 'touchstart', kakao.maps.event.preventMap);
  
      // 커스텀 오버레이 컨텐츠를 설정합니다
      placeOverlay.setContent(contentNode);  
  
      // 각 카테고리에 클릭 이벤트를 등록합니다
      addCategoryClickEvent();
  
      // 엘리먼트에 이벤트 핸들러를 등록하는 함수입니다
      function addEventHandle(target, type, callback) {
          if (target.addEventListener) {
              target.addEventListener(type, callback);
          } else {
              target.attachEvent('on' + type, callback);
          }
      }
  
      // 카테고리 검색을 요청하는 함수입니다
      function searchPlaces() {
          if (!currCategory) {
              return;
          }
          
          // 커스텀 오버레이를 숨깁니다 
          placeOverlay.setMap(null);
  
          // 지도에 표시되고 있는 마커를 제거합니다
          removeMarker();
          
          ps.categorySearch(currCategory, placesSearchCB, {useMapBounds:true}); 
      }
  
      // 장소검색이 완료됐을 때 호출되는 콜백함수 입니다
      function placesSearchCB(data, status, pagination) {
          if (status === kakao.maps.services.Status.OK) {
  
              // 정상적으로 검색이 완료됐으면 지도에 마커를 표출합니다
              displayPlaces(data);
          } else if (status === kakao.maps.services.Status.ZERO_RESULT) {
              // 검색결과가 없는경우 해야할 처리가 있다면 이곳에 작성해 주세요
  
          } else if (status === kakao.maps.services.Status.ERROR) {
              // 에러로 인해 검색결과가 나오지 않은 경우 해야할 처리가 있다면 이곳에 작성해 주세요
              
          }
      }
  
      // 지도에 마커를 표출하는 함수입니다
      function displayPlaces(places) {
  
          // 몇번째 카테고리가 선택되어 있는지 얻어옵니다
          // 이 순서는 스프라이트 이미지에서의 위치를 계산하는데 사용됩니다
          var order = document.getElementById(currCategory).getAttribute('data-order');
  
          for ( var i=0; i<places.length; i++ ) {
  
                  // 마커를 생성하고 지도에 표시합니다
                  var marker = addMarker(new kakao.maps.LatLng(places[i].y, places[i].x), order);
  
                  // 마커와 검색결과 항목을 클릭 했을 때
                  // 장소정보를 표출하도록 클릭 이벤트를 등록합니다
                  (function(marker, place) {
                      kakao.maps.event.addListener(marker, 'click', function() {
                          displayPlaceInfo(place);
                      });
                  })(marker, places[i]);
          }
      }
  
      // 마커를 생성하고 지도 위에 마커를 표시하는 함수입니다
      function addMarker(position, order) {
          var imageSrc = 'https://t1.daumcdn.net/localimg/localimages/07/mapapidoc/places_category.png', // 마커 이미지 url, 스프라이트 이미지를 씁니다
              imageSize = new kakao.maps.Size(27, 28),  // 마커 이미지의 크기
              imgOptions =  {
                  spriteSize : new kakao.maps.Size(72, 208), // 스프라이트 이미지의 크기
                  spriteOrigin : new kakao.maps.Point(46, (order*36)), // 스프라이트 이미지 중 사용할 영역의 좌상단 좌표
                  offset: new kakao.maps.Point(11, 28) // 마커 좌표에 일치시킬 이미지 내에서의 좌표
              },
              markerImage = new kakao.maps.MarkerImage(imageSrc, imageSize, imgOptions),
                  marker = new kakao.maps.Marker({
                  position: position, // 마커의 위치
                  image: markerImage 
              });
  
          marker.setMap(map); // 지도 위에 마커를 표출합니다
          markers.push(marker);  // 배열에 생성된 마커를 추가합니다
  
          return marker;
      }
  
      // 지도 위에 표시되고 있는 마커를 모두 제거합니다
      function removeMarker() {
          for ( var i = 0; i < markers.length; i++ ) {
              markers[i].setMap(null);
          }   
          markers = [];
      }
  
      // 클릭한 마커에 대한 장소 상세정보를 커스텀 오버레이로 표시하는 함수입니다
      function displayPlaceInfo (place) {
          var content = '<div class="placeinfo">' +
                          '   <a class="title" href="' + place.place_url + '" target="_blank" title="' + place.place_name + '">' + place.place_name + '</a>';   
  
          if (place.road_address_name) {
              content += '    <span title="' + place.road_address_name + '">' + place.road_address_name + '</span>' +
                          '  <span class="jibun" title="' + place.address_name + '">(지번 : ' + place.address_name + ')</span>';
          }  else {
              content += '    <span title="' + place.address_name + '">' + place.address_name + '</span>';
          }                
      
          content += '    <span class="tel">' + place.phone + '</span>' + 
                      '</div>' + 
                      '<div class="after"></div>';
  
          contentNode.innerHTML = content;
          placeOverlay.setPosition(new kakao.maps.LatLng(place.y, place.x));
          placeOverlay.setMap(map);  
      }
  
  
      // 각 카테고리에 클릭 이벤트를 등록합니다
      function addCategoryClickEvent() {
          var category = document.getElementById('category'),
              children = category.children;
  
          for (var i=0; i<children.length; i++) {
              children[i].onclick = onClickCategory;
          }
      }
  
      // 카테고리를 클릭했을 때 호출되는 함수입니다
      function onClickCategory() {
          var id = this.id,
              className = this.className;
  
          placeOverlay.setMap(null);
  
          if (className === 'on') {
              currCategory = '';
              changeCategoryClass();
              removeMarker();
          } else {
              currCategory = id;
              changeCategoryClass(this);
              searchPlaces();
          }
      }
  
      // 클릭된 카테고리에만 클릭된 스타일을 적용하는 함수입니다
      function changeCategoryClass(el) {
          var category = document.getElementById('category'),
              children = category.children,
              i;
  
          for ( i=0; i<children.length; i++ ) {
              children[i].className = '';
          }
  
          if (el) {
              el.className = 'on';
          } 
      } 
  
      var isTrafficOn = false;  // 교통정보 상태 변수
  
      //도로 정보버튼을 클릭시 켰다 껐다 하는 기능
      function toggleTraffic() {
          if (isTrafficOn) {
              ShowOff();  // 끄기 함수 호출
          } else {
              ShowOn();   // 켜기 함수 호출
          }
          
          isTrafficOn = !isTrafficOn;  // 교통정보 상태 변경
      }
      
      //도로 정보 기능을 켭니다.
      function ShowOn() {
          map.addOverlayMapTypeId(kakao.maps.MapTypeId.TRAFFIC);
      }
  
      //도로 정보 기능을 끕니다.
      function ShowOff() {
          map.removeOverlayMapTypeId(kakao.maps.MapTypeId.TRAFFIC);
      }
  
      var isSkyviewOn = false;
      
      //스카이뷰버튼을 클릭시 켰다 껐다 하는 기능
      function toggleSkyview() {
          if(isSkyviewOn) {
              SkyOff();
          } else {
              SkyOn();
          }
  
          isSkyviewOn = !isSkyviewOn;
      }
  
      //스카이뷰 기능을 켭니다.
      function SkyOn() {
          map.setMapTypeId(kakao.maps.MapTypeId.HYBRID);
      }
  
      //스카이뷰 기능을 끕니다.
      function SkyOff() {
          map.setMapTypeId(kakao.maps.MapTypeId.ROADMAP);
      }
  
   //지도 정보
   {
          // 지도 타입 정보를 가지고 있을 객체입니다
          var mapTypes = {
              bicycle : kakao.maps.MapTypeId.BICYCLE
          };
  
          // 체크 박스를 선택하면 호출되는 함수입니다
          function setOverlayMapTypeId() {
              var chkBicycle = document.getElementById('chkBicycle')
          
              // 지도 타입을 제거합니다
              for (var type in mapTypes) {
                  map.removeOverlayMapTypeId(mapTypes[type]);    
              }
  
              // 자전거도로정보 체크박스가 체크되어있으면 지도에 자전거도로정보 지도타입을 추가합니다
              if (chkBicycle.checked) {
                  map.addOverlayMapTypeId(mapTypes.bicycle);    
              }
          }
      }

 

[style.css]

/*지도 확대, 축소 컨트롤 객체, 교통혼잡 객체, 스카이뷰*/
.radius_border{border:1px solid #919191;border-radius:5px;}
.custom_zoomcontrol {position:absolute;top:50px;right:20px;width:36px;height:80px;overflow:hidden;z-index:1;background-color:#f5f5f5;} 
.custom_zoomcontrol span {display:block;width:36px;height:40px; user-select: none;text-align:center;cursor:pointer;}     
.custom_zoomcontrol span img {width:15px;height:15px;padding:12px 0;border:none;}             
.custom_zoomcontrol span:first-child{border-bottom:1px solid #bfbfbf;} 
.traffic{ position: absolute; top: 15px; right: 5px; width:122px; height:29px; overflow:hidden; z-index: 1; background-color:#f5f5f5;font-family:'Malgun Gothic', '맑은 고딕', sans-serif;}
.traffic span {display:block;float:left;user-select: none;text-align:center;line-height:30px;cursor:pointer;}
#Skyview_button{font-size: 12px;width:60px;height:30px;}
#traffic_button{font-size: 12px;width:60px;height:30px;border-right: 1px solid black;}
.traffic span.active {
    background-color: #425470; /* 버튼이 활성 상태일 때의 색상 */
    color: white;
  }
  
/*기본 패널 만들기*/
div.row {
width: 100%;
display: flex;
border: 1px solid #003458;
}
div.left {
width: 20%;
float: left;
box-sizing: border-box;
background: #46a6dd;
}
div.right {
width: 80%;
float: right;
box-sizing: border-box;
background: #ece6cc;
}
/* 전체 body 스타일링 */
body {
margin: 0;
padding: 0;
}

/* 전체 .container 스타일링 */
.container {
display: flex;
justify-content: center;
}

/* 패널 스타일링 */
.panel {
width: 100%;
border-radius: 0;
}

/* 왼쪽 컨테이너 스타일링 */
.left {
display: flex;
flex-direction: column;
align-items: center;
padding: 20px;
width: 50%;
}

/* 오른쪽 컨테이너 스타일링 */
.right {
width: 50%;
}

/* 제목 스타일링 */
h1 {
margin-top: 0;
}

/* 입력창 스타일링 */
input[type="text"] {
width: 100%;
margin-bottom: 10px;
padding: 10px;
border-radius: 5px;
border: none;
box-shadow: 0 0 5px rgba(0, 0, 0, 0.1);
}

/* 버튼 스타일링 */
button {
padding: 10px 20px;
background-color: #007bff;
color: #fff;
border: none;
border-radius: 5px;
cursor: pointer;
}

/* 지도 스타일링 */
#map {
width: 100%;
height: 900px;
}

.map_wrap, .map_wrap * {margin:0; padding:0;font-family:'Malgun Gothic',dotum,'돋움',sans-serif;font-size:12px;}
.map_wrap {position:relative;width:100%;height:900px;}
#category {position:absolute;top:10px;left:10px;border-radius: 5px; border:1px solid #909090;box-shadow: 0 1px 1px rgba(0, 0, 0, 0.4);background: #fff;overflow: hidden;z-index: 2;}
#category li {float:left;list-style: none;width:50px;border-right:1px solid #acacac;padding:6px 0;text-align: center; cursor: pointer;}
#category li.on {background: #eee;}
#category li:hover {background: #ffe6e6;border-left:1px solid #acacac;margin-left: -1px;}
#category li:last-child{margin-right:0;border-right:0;}
#category li span {display: block;margin:0 auto 3px;width:27px;height: 28px;}
#category li .category_bg {background:url(https://t1.daumcdn.net/localimg/localimages/07/mapapidoc/places_category.png) no-repeat;}
#category li .bank {background-position: -10px 0;}
#category li .mart {background-position: -10px -36px;}
#category li .pharmacy {background-position: -10px -72px;}
#category li .oil {background-position: -10px -108px;}
#category li .cafe {background-position: -10px -144px;}
#category li .store {background-position: -10px -180px;}
#category li.on .category_bg {background-position-x:-46px;}
.placeinfo_wrap {position:absolute;bottom:28px;left:-150px;width:300px;}
.placeinfo {position:relative;width:100%;border-radius:6px;border: 1px solid #ccc;border-bottom:2px solid #ddd;padding-bottom: 10px;background: #fff;}
.placeinfo:nth-of-type(n) {border:0; box-shadow:0px 1px 2px #888;}
.placeinfo_wrap .after {content:'';position:relative;margin-left:-12px;left:50%;width:22px;height:12px;background:url('https://t1.daumcdn.net/localimg/localimages/07/mapapidoc/vertex_white.png')}
.placeinfo a, .placeinfo a:hover, .placeinfo a:active{color:#fff;text-decoration: none;}
.placeinfo a, .placeinfo span {display: block;text-overflow: ellipsis;overflow: hidden;white-space: nowrap;}
.placeinfo span {margin:5px 5px 0 5px;cursor: default;font-size:13px;}
.placeinfo .title {font-weight: bold; font-size:14px;border-radius: 6px 6px 0 0;margin: -1px -1px 0 -1px;padding:10px; color: #fff;background: #d95050;background: #d95050 url(https://t1.daumcdn.net/localimg/localimages/07/mapapidoc/arrow_white.png) no-repeat right 14px center;}
.placeinfo .tel {color:#0f7833;}
.placeinfo .jibun {color:#999;font-size:11px;margin-top:0;}

 

끝으로 팀 프로젝트로 카카오 맵 API를 활용하여 지도를 구현해 보았다. 처음 해보는 것이기 때문에 어려움이 많았지만 카카오 맵 API 사이트에 들어가면 API를 활용한 예제들이 있어서 그나마 수월하게 구현할 수 있었다. 위 코드들의 대부분은 예제들을 가져와서 수정한 코드임을 말씀드린다. 이처럼 이미 나와있는 API를 활용하여 자신만의 스타일로 구현할 수 있다는 점을 이번 프로젝트를 통해 깨닫게 되었다.

 

그리고 막상 해보니 이해하는 것은 어려웠지만 지도상에 내가 원하는 대로 나타낼 수 있다는 점이 재밌었다. 이 글을 보는 여러분들도 충분히 해낼 수 있을 거라고 생각한다.

 

 

[꿈은 크게 가져라, 부서져도 그 조작이 크게.]

Comments