실전예제/JavaScript예제

[ 카카오 API ]카카오(Daum) 주소 찾기 API 사용하기

Reload0213 2022. 1. 10. 15:45

https://postcode.map.daum.net/guide 주소찾기 API가이드 링크이며 아래는, 내용을 가져와 본 것이다.

  • Key를 발급 받을 필요가 없습니다.
  • 사용량에 대한 제한이 없습니다.
  • 업용이든 상업적 용도이든 상관없이 무료로 사용 가능합니다.
  • 기초구역번호가 발급된 도로명 주소, 영문 주소를 확인 가능합니다.
  • 행정안전부에서 제공하는 "도로명 주소" DB를 직접 업데이트 받고 있으므로 가장 최신의 데이터를 이용하실 수 있습니다.
  • 하단 로고를 임의로 가릴 경우, 사용에 제약이 발생할 수 있습니다.
  • JS API 스크립트를 임의 수정하여 사용할 경우, 사용에 제약이 발생할 수 있습니다.
  • 본 서비스는 인터넷이 가능한 환경에서 동작합니다. 인트라넷(내부망) 환경은 공식적으로 지원하지 않으며, 별도 요청시 "사용하는 도메인" 정보만 제공 가능합니다.
  • PC 및 모바일웹 환경에서 보편적으로 사용되는 대부분의 브라우저에서 동작됩니다.(IE11, Edge, Chrome, Safari 등)
  • 단, 커스텀 브라우저(벤더사 자체 제작 브라우저 및 웹뷰) 및 업데이트가 멈춘 오래된 브라우저에서는 정상 동작되지 않을 수 있습니다. (서비스 적용시 확인 필요)

 

위의 안내처럼 가장 큰 장점은 카카오 주소 찾기 API는 따로 서비스 키(key) 발급이나, 별도의 과정이 필요없이 접근도 간단하며 무료로 서비스를 제공해주어서 정말 좋은 것 같다.

 

사용방법

 

<script src="//t1.daumcdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>
<script>
    new daum.Postcode({
        oncomplete: function(data) {
            // 팝업에서 검색결과 항목을 클릭했을때 실행할 코드를 작성하는 부분입니다.
            // 예제를 참고하여 다양한 활용법을 확인해 보세요.
        }
    }).open();
</script>

그냥 인터넷만 되는 환경이면 위와 같은 코드만으로 쉽게 접근하여 사용가능하다.

사용예제

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Kakao API</title>
</head>
<body>
    <table>
        <tr>
            <th>이름</th>
            <td><input type="text" name="user_name"></td>
        </tr>
        <tr>
            <th>주소</th>
            <td><input type="text" id="address_kakao" name="address" readonly /></td>
        </tr>
        <tr>
            <th>상세 주소</th>
            <td><input type="text" name="address_detail" /></td>
        </tr>
    </table>
</body>
<script src="//t1.daumcdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>
<script>
window.onload = function(){
    document.getElementById("address_kakao").addEventListener("click", function(){ //주소입력칸을 클릭하면
        //카카오 지도 발생
        new daum.Postcode({
            oncomplete: function(data) { //선택시 입력값 세팅
                document.getElementById("address_kakao").value = data.address; // 주소 넣기
                document.querySelector("input[name=address_detail]").focus(); //상세입력 포커싱
            }
        }).open();
    });
}
</script>
</html>

실제 적용하여 실행시켜본다면 다음과 같이 손쉽게 작동 된다.