도로명주소 API 연동하기

솔직히... 소스나 연동 방법이 매우 쉬운편이라 포스팅할만한 내용은 아니지만 지금 딱히 쓸게 없어서 써본다.

 

 

1. 도로명주소 개발자센터 접속

 - 아래 링크를 통해 도로명주소 개발자센터에 접속한다.

   (https://www.juso.go.kr/addrlink/devAddrLinkRequestGuide.do?menu=roadApi)

 - 팝업 API와 검색 API가 있는데, 이번 포스팅에서는 더 간단한 팝업 API를 연동할 것이다.

• 팝업 API : 사용자 페이지에서 도로명주소 API에서 제공하는 팝업 화면을 오픈해 주소 검색 이후 선택한 주소 데이터를 반환받는 방식.
• 검색 API : 사용자 페이지에서 주소 검색을 위한 UI를 직접 구현할 때 사용하며, 검색한 주소 목록 데이터를 받아 개발자가 직접 화면에 출력해주고 이후 처리 또한 모두 해주어야함.

 - 가이드 및 소스 다운로드 (JSP | ASP | PHP) 에서 원하는 언어를 선택한다. 여기선 JSP로 했다.

 

 

 

2. 코드 작성

 - 제공된 파일은 생각보다 훨씬 간단하다. 가이드 문서 하나, Sample.jsp, jusoPopup.jsp 끝이다.

 - Sample.jsp에서 버튼을 클릭하면 jusoPopup.jsp를 오픈하고, jusoPopup.jsp에서 도로명 주소를 검색해 선택한 주소 데이터를 다시 Sample.jsp로 반환하는 형태의 샘플이다.

 - 결국 연동을 하게되는 페이지는 jusoPopup.jsp인데, 아래 설정은 눈여겨 봐둬야한다.

• confmKey : 승인키. 좌측의 API 신청하기 메뉴를 통해 발급받은 승인키를 입력해야한다.
• returnUrl : 주소 검색 결과를 리턴받을 페이지의 URL.
• resultType : 도로명주소 검색결과 화면 출력내용.
  • 1 : 도로명
  • 2 : 도로명+지번
  • 3 : 도로명+상세건물명
  • 4 : 도로명+지번+상세건물명

 - 팝업 API의 경우에는 위 세가지 변수값만 제대로 입력하면 연동이 끝나며, 선택한 주소 데이터를 반환받은 이후 처리만 프로그램 로직대로 작성해주면 된다.

 

 

 

3. API 신청하기

 - 좌측의 API 신청하기 메뉴를 클릭한다.

 - 신청하려는 API를 선택하고 내용을 작성한다.

 - 신청 이후 발급받은 승인키를 연동 소스에 입력한다.