budongsan

KO | EN

gitlite — search

#python #hacktoberfest #react #golang #machine-learning #macos #nodejs #windows #cli #kubernetes #awesome-list #vue #security #open-source

(★ 27)

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

budongsan Latest Version Download

Download Latest Version (.zip)

// 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

budongsan Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

budongsan

budongsan Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README