budongsan

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 27 Open GitHub ↗

주택 실거래가 분석을 위한 실 Datasets 및 함수 제공 R package

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Budongsan

**현재 데이터는 2016년까지만 제공됩니다. http://rtdown.molit.go.kr/download/downloadMainList.do**

국토교통부(molit.go.kr)와 한국 감정원에서 제공하는 아파트, 단독/다가구, 연립/다세대 주택 실거래 정보 분석을 위한 dataset과 함수를 제공합니다.

현재는, http://rtdown.molit.go.kr 에서 제공되는 2006~2016년까지의 모든 실거래 정보에 대한 R dataset을 제공하고 있습니다.

매매 데이터는 2006년 부터, 전월세 데이터는 2011년부터 존재합니다.

### 패키지 설치하기
* `budongsan` 패키지를 설치하기 위해선 `devtools` 패키지가 필요합니다.

```{r}
install.packages("devtools")
devtools::install_github("keepcosmos/budongsan")
# 100MB 이상의 데이터로 다소 시간이 소요될 수 있습니다.

library(budongsan)
```

### Datasets
`molit.rt.{type}.{year}` 형식으로 데이터를 불러옵니다.
* type:
  - `apt`: 아파트
  - `sh`: 단독 / 다가구
  - `rh`: 연립 / 다세대
* year: 2006 ~ 2016

```{r}
# 2016년 아파트 전월세 및 매매 실거래 데이터
molit.rt.apt.2016

# 2016년 단독/다가구 전월세 및 매매 실거래 데이터
molit.rt.sh.2016

# 2015년 연립/다세대 전월세 및 매매 실거래 데이터
molit.rt.rh.2015
```
* `help(molit.rt.apt)` 혹은 `?molit.rt.apt` 명령어를 통해 데이터에 대한 상세 정보를 확인할 수 있습니다.
* 데이터 양이 큽니다. `data.table` 패키지를 먼저 추가해주면 더 빠르게 데이터를 활용할 수 있습니다.
* 면적은 평방미터, 가격은 만원단위로 표시됩니다.

### 타입별 전체 데이터 불러오기
각 주택 타입별, 지역별 전체 데이터를 불러올 수 있습니다. 해당방법으로 데이터를 불러올 경우 컬럼이름 영어로 변환됩니다.

```{r}
# 단독 주택 전체 불러오기
molit.rt.get("sh")

# 지역별 아파트 불러오기
molit.rt.get("apt", "성남시")
molit.rt.get("apt", "판교")

# 해당 함수로 데이터를 불러올 경우 Default로 컬럼이름은 영어로 변환됩니다. 한국어로 적용된 컬럼이름을 원하실 경우 `colnames.locale="ko"` 파라미터를 추가해주세요.
molit.rt.get("apt", "서울특별시", colnames.locale="ko")

```

## Contribution
* 잘못된 데이터 / 제대로 cleaning된지 않은 데이터를 찾아주시는 것도 큰 도움이 됩니다.
* 해당 데이터를 활용한 어떤 분석이든 공유해주세요. PR뿐 아니라 Issue를 통한 제안이나 Gist를 통해 본인이 분석한 Script를 공유해주셔도 됩니다.
* molit.go.kr에서 다운받은 raw 파일은 package size 문제로 `data-raw` 브랜치에서 관리합니다. 데이터를 정리한 후 rda파일만 master에 머지하고 있으니 참고해주세요.

### TODO
* 부동산 거래 정보 정보에 필요한 유용한 함수들 추가
* 한국감정원 아파트 실거래가격지수에 대한 Open API 클라이언트 구현
  * 실거래가격지수 통계 조회 서비스
  * 아파트 실거래 가격 지수 조회 서비스

budongsan

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README