전국 아파트 공공데이터 동기화

국토교통부 K-apt 공동주택 기본정보를 DB에 저장하고 평형별 적정 가입금액을 계산합니다.

DB 현황

-
총 아파트 단지
-
상세정보 보유
-
좌표 등록
-
API 키 상태

국토교통부 공공데이터 API 키 설정 방법

  1. data.go.kr → 국토교통부_공동주택 단지 목록제공 서비스 에서 API 키 발급
  2. 발급 후 활용신청 승인 (즉시 또는 1~2일 소요)
  3. 터미널에서 아래 명령어로 Worker 시크릿에 등록:
gsk hosted secret_put --name MOLIT_API_KEY --value "여기에_발급받은_API_키"

* API 키 없이도 현재 샘플 데이터 15개로 모든 기능을 사용할 수 있습니다.

1 전국 아파트 단지 목록 동기화

국토교통부 K-apt API에서 전국 22,243개 아파트 단지 목록을 가져옵니다. 페이지당 500개씩 처리합니다. (API 키 필요)

전체 동기화: 페이지 1~45 (500개 기준, 총 22,243개). 한 번에 너무 많이 요청하면 타임아웃될 수 있으니 5~10페이지씩 나눠 실행하세요.

2 단지 상세정보 동기화 (사용승인일·평형별 세대수)

단지 목록 동기화 후, 각 단지의 사용승인일·평형별 세대수·난방방식 등 상세정보를 가져옵니다. 한 번에 20개씩 처리합니다. (API 키 필요)

3 좌표 지오코딩 (OpenStreetMap Nominatim)

주소 정보를 바탕으로 위도·경도 좌표를 조회합니다. 지번주소 → 도로명 → 시도+단지명 순으로 다단계 검색합니다. Nominatim 정책상 요청당 1.1초 간격이 필요합니다. (API 키 불필요)

예상 소요시간: 배치 10개 = ~12초 / 100개 = ~2분 / 전체 22,000개 ≈ 약 7시간 — 시도별로 나눠 실행하거나, 연속 실행 후 Esc로 중지할 수 있습니다.

평형별 적정 가입금액 직접 계산

전용면적과 사용승인일을 입력하면 감가를 반영한 적정 가입금액을 계산합니다.

실행 로그

== 슬기로운 아파트생활 아파트 데이터 동기화 관리자 ==
페이지 로드 시 DB 현황을 자동으로 불러옵니다...