들어가며
공공데이터포털을 이용하면 손 쉽게 아파트 실거래가 정보를 이용할 수 있습니다. 하지만 공공데이터포털 OPEN API를 이용할려면 파이썬 등의 코딩이 필요합니다. 그러나 Power BI Desktop이 있으면 코딩없이 OPEN API를 호출 및 사용 할 수 있습니다. 하지만 좀처럼 Power BI Desktop 파워BI로 공공데이터포털 아파트 실거래가 OPEN API를 호출하고 분석하는 방법에 대한 문서를 잘 찾아볼 수 없습니다. 따라서 Power BI로 공공데이터포털 아파트 실거래가 OPEN API 호출 및 분석 방법에 대해서 알아보는 포스팅을 기획하게 되었습니다. 본 포스팅 시리즈를 잘 숙지하면 아파트 실거래가 OPEN API 뿐 만 아니라 공공데이터포털의 다른 Data OPEN API들도 쉽게 응용하여 사용할 수 있게 될 것 입니다.
아직 이전 포스팅을 읽지 않으신 분들은 아래를 참고하시기 바랍니다.
Power BI Desktop 다운로드 및 설치 2가지 방법
공공데이터포털 가입 및 로그인
아래는 공공데이터포털 바로가기 입니다.
저의 경우 기존 사용하고 있는 아이디가 별도로 있지만, 본 블로그 포스팅을 위해서 카카오 계정으로 로그인을 하였습니다.
이렇게 요즘 플랫폼이나 웹,앱들은 대체적으로 소셜 로그인을 많이 사용하고 있는 편입니다.
소셜 로그인이란, 인터넷에서 다양한 서비스나 앱을 사용할 때마다 새로운 아이디와 비밀번호를 만들지 않고, 이미 가지고 있는 소셜 미디어(예: 페이스북, 구글, 네이버, 카카오 같은) 계정을 사용해서 로그인하는 방법을 말합니다.
로그인에 성공하면 아래 처럼 본인인증 정보수집 팝업이 열리는데, 굳이 원하지 않는다면 닫으면 됩니다. 하지만 로그인 할 때 마다 본 팝업은 계속해서 뜨게 될 것 입니다.
실거래가 OPEN API 검색하기
이제 공공데이터포털에 로그인을 하였으므로, <실거래가>라고 검색해 보도록 하겠습니다.
현재 공공데이터포털에서는 실거래가에 대해서 총 43건이 검색되었고, 그 중에서 20개의 오픈API가 있다고 나오는 것을 볼 수 있습니다.
아래 이미지 처럼 오픈API 탭 메뉴를 클릭합니다.
그 중에서도 우리가 신청 후 사용해야 할 OPEN API는 아래 붉은 박스에 있는 2개의 오픈API입니다.
아파트 매매,전월세 OPEN API는 다음과 같습니다.
국토교통부_아파트매매 실거래자료
https://www.data.go.kr/data/15058747/openapi.do
국토교통부_아파트 전월세 자료
https://www.data.go.kr/data/15058017/openapi.do
먼저 국토교통부_아파트매매 실거래자료 사용신청을 위해서 활용신청 버튼을 클릭합니다.
OPEN API 개발계정 신청하기
그러면 OpenAPI 개발계정 신청 페이지로 넘어가게 됩니다.
①자동승인: 신청하면 자동으로 승인된다는 뜻(하지만 공휴일에는 지연이 되네요. 글을 적고 있는 이 순간 일요일인데, 아직 승인되지 않았어요. 원칙은 몇 일 걸린다고 합니다. 참고하세요.)
②개발계정: 개발계정 외에 운영계정이 있어요. 개발계정 신청이라는 뜻
③승인일로부터 24개월 간 활용가능: 한 번 사용신청 시 2년 동안 사용할 수 있음.
이어서 활용목적에 아래 처럼 체크하고 작성하시면 될 것 같습니다. 그리고 이용목적범위에 동의합니다 에 체크를 합니다.
그런 다음 활용신청 하면 아래와 같이 신청하겠습니까? 라는 경고창이 뜹니다. 당연히 확인 클릭~!!
그러면 이번엔 신청이 완료되었다는 경고창으로 답을해주는 친철한 공공데이터포털 사이트 입니다.
실거래가 OPEN API 호출하기
이렇게 활용신청을 하고난 뒤 마이페이지>API신청 으로 들어 가보면 조금 전 신청했던 국토교통부_아파트매매 실거래자료 목록을 볼 수 있습니다.
현재는 활용 1건 이라고 나오는 것을 볼 수 있습니다.
활용신청 상세기능정보 중 일일트래픽 1000 항목을 볼 수 있습니다. 바로 이 부분이 현재 개발계정 이지만, 앞으로 운영계정으로 업그레이드가 필요한 이유가 됩니다.
위에서 ②확인 버튼을 클릭하면, 아래 처럼 요청변수 라는 항목이 나타나게 됩니다.
저 같은 경우 아래 처럼 아직 승인이 되지 않았다는 메세지가 나오는것을 볼 수 있습니다.
<response>
<script/>
<header>
<resultCode>99</resultCode>
<resultMsg>SERVICE KEY IS NOT REGISTERED ERROR.</resultMsg>
</header>
</response>
제대로 사용신청 승인이 나면, 아래와 같이 아파트 매매 실거래가 정보들이 나오는 것을 볼 수 있을것 입니다.
OPEN API 개발계정 일일 트래픽 한계
여기서 잠깐 개발계정에서 바로 운영계정으로 활용신청 해야 하는 이유에 대해서 말씀드리도록 하겠습니다.
일일트래픽이란? 하루 24시간 동안 요청할 수 있는 숫자를 말하는데, 1000이라고 하면 1000번을 요청할 수 있다는 뜻 입니다.
아파트매매 실거래가 정보를 요청할 경우, 두 개의 요청변수가 필요합니다.
①LAWD_CD: 각 지역별 코드 (경상남도 진주시: 48170)
②DEAL_YMD: 월 단위 신고자료 (2024년2월 자료: 202402)
경상남도 진주시의 2024년 02월 아파트 매매 실거래가 자료를 볼려면 위 처럼 요청변수를 입력하면 되겠습니다.
아파트매매 실거래가 자료는 2006년 01월 부터 시작되었습니다. 따라서 경상남도 진주시의 아파트 매매 실거래가 자료를 모두 구할려면 2006년 01월 부터 현재 2024년 02월 까지의 총 218개의 DEAL_YMD 변수가 필요합니다. 여기서 대략 진주시 말고 다른 시군구 4개의 아파트 매매 실거래가 자료를 구할려고 한다면 총 218*5= 1090으로 일일트래픽 1000이 초과해버리게 됩니다.
결국 개발계정으로는 하루 24시간 동안 4개 시군구의 아파트 매매 실거래가 자료만 전부 받을 수 있을 뿐 더 이상 다른 시군구의 자료를 구할 수 없게 됩니다. 만 24시간이 지나야 다시 1000개의 트래픽을 사용할 수 있으므로 만약 분석이 더 필요한 경우에는 하루 24시간이 지나야 가능한 것을 알 수 있습니다.
위 같은 사실이 바로 개발계정에서 운영계정으로 꼭 업그레이드 해야 하는 이유입니다.
실거래가 OPEN API 운영계정 신청하기 TIP
운영계정 신청을 위해서 아래 처럼 운영계정 신청 버튼을 클릭합니다.
일일 트래픽이 100만 이나 되는 것을 확인할 수 있습니다. 이는 하루에 전국 매매실거래가 정보를 전부 호출하고도 남을 양 입니다.
기능 및 서비스 화면 설명에는 “실거래가를 파워BI로 차트 또는 시각화하여 분석하는 프로그램” 이런 느낌으로 기재하시면 되겠습니다.
기능 및 서비스 화면/ 대표 이미지(썸네일) 항목에는 이미지를 첨부해야 합니다. 이미지는 아래 블로그 포스팅 중 아무 Power BI로 구현한 차트를 첨부하시면 됩니다.
부동산빅데이터땅짚고-네이버블로그
https://blog.naver.com/rmawn0504
위 블로그에서 ‘Power BI‘ 또는 ‘파워BI‘ 이렇게 검색한 다음, 포스팅 내부의 차트 및 시각화 이미지가 있으면 그것을 다운로드 받아서 첨부하시면 되겠습니다. 아래 몇 몇 예시 포스팅들 입니다.
https://blog.naver.com/rmawn0504/223356257777
https://blog.naver.com/rmawn0504/222649631095
https://blog.naver.com/rmawn0504/221284655667
https://blog.naver.com/rmawn0504/223155732266
https://blog.naver.com/rmawn0504/223185719274
서비스 개시일(론칭일) 의 경우 미래의 특정 날짜를 기재하시면 될 것 입니다.(사후 체크하지 않으므로 편하게 기재하세요^^)
그 외 사항은 여러분 상황에 맞도록 작성하시면 되겠습니다.
마치며
이렇게 해서 공공데이터포털 아파트 실거래가 OPEN API 개발계정 신청에서 운영계정 신청 까지 모두 살펴보았습니다. 이 후 포스팅 부터는 본격적으로 이제 Power BI에 OPEN API를 호출하여 분석하는 방법에 대해서 상세하게 풀어나가 보도록 하겠습니다. 많이 기대해 주시기 바라며, 본 포스팅이 유익하셨다면 많은 분들에게 공유해주시면 더 좋은 포스팅으로 다시 찾아뵙도록 하겠습니다.
이상 저는 부를 코딩하는 코딩맨 지중해부자 였습니다.
댓글 남기기