집콕맵 - 서울 아파트 실거래가·학군·학원비·출퇴근 시간 지도
본인 예산에 맞는 학군지 아파트를 찾도록 돕는 모바일 우선 웹앱. 설치·로그인 없이 바로 씁니다.
| 기능 | 설명 |
|---|
| 동네 학원비 | 교육청 공시 교습비로 계산한 단지 반경 1km 월 학원비 중앙값 (강남 36만 vs 강북 19.8만) |
| 예산별 학군지 | 같은 가격대 안에서의 학군 순위 — "내 6억으로 갈 수 있는 최고 학군" |
| 출퇴근 시간 | 회사 역을 넣으면 지하철 소요 시간 계산, 맞벌이 두 곳 동시 조건 |
| 공사 중 예정역 | 동북선 등 공사 중 노선 예정역 도보권 단지 |
| 배정 초등학교 | 공식 학구도 기준 배정 학교, 통학 거리, 학급당 인원 |
| 실거래·전세가율 | 국토교통부 실거래가, 갭, 상승·위험 신호 |
데이터 출처와 계산 방식은 지표 설명에 전부 공개돼 있습니다.
정적 파일(HTML/JS) + Python 파이프라인으로 만듭니다.
구조
pipeline/
fetch_trades.py 국토교통부 실거래가 API -> data/raw/trades_*.json (DATA_GO_KR_KEY 필요)
fetch_roads.py OSM Overpass -> app/data/roads.geojson (큰길/골목/인도 분류, 키 불필요)
fetch_poi.py OSM Overpass -> data/raw/poi.json (지하철역, 초등학교 위치)
fetch_boundary.py OSM 행정경계 -> data/raw/boundary_<구>.geojson (좌표 검증용)
geocode_osm.py 단지명 <-> OSM 아파트 매칭으로 좌표 채움 (키 불필요, 경계 밖 제외)
geocode.py 카카오 주소검색으로 나머지 좌표 채움 (KAKAO_REST_API_KEY + 카카오맵 서비스 활성화 필요)
fetch_rent.py 아파트 전월세 실거래 -> data/raw/rent_*.json (전세가율·갭)
fetch_kapt.py K-apt 단지목록(V4)+기본정보(V5) -> data/raw/kapt.json (세대수·동수·최고층·분양/임대/혼합·복도식)
fetch_neis.py 나이스 학원·교습소 + 초·중학교 (카카오 좌표화) -> academies.json, schools_neis.json
fetch_seoul_apt.py 서울시 공동주택 아파트 정보(열린데이터광장, SEOUL_KEY) -> seoul_apt.json (분양/임대/혼합·세대수·주차·면적별 세대수, K-apt 보강)
fetch_schoolinfo.py 학교알리미 OpenAPI(SCHOOLINFO_KEY) -> schoolinfo/<type>_<급>_<구>_<년>.json (학생수·학급당·전출입)
fetch_kakao_poi.py 카카오 로컬로 단지 반경 어린이집·소아과·병원·마트·공원·도서관 개수 -> kakao_poi.json
demo_data.py 키 없을 때 쓰는 데모 단지·학군·경매 (마포구 공덕·아현·염리)
build.py 위 소스를 합쳐 app/data/*.json 생성 (평당가, 1년 변동, 배정초등(보로노이 추정), 역거리, 대로변 여부, 장단점 자동 요약)
app/
index.html, app.js, style.css MapLibre GL 기반 지도 + 하단 시트 UI
data/ build.py 산출물
vendor/ maplibre-gl 4.7.1 (로컬 번들)
실행
pip install -r requirements.txt
python pipeline/fetch_roads.py # 최초 1회 (Overpass, 1~2분)
python pipeline/build.py # app/data 생성 (키 없으면 데모 모드)
python -m http.server 8765 --directory app
# -> http://localhost:8765
실데이터 갱신 순서 (마포구 기준)
python pipeline/fetch_trades.py --lawd 11440 --months 24 # 실거래 (지난달 캐시, 이번달만 재조회)
python pipeline/fetch_boundary.py --name 마포구 # 최초 1회
python pipeline/fetch_poi.py # 역/초등학교, 가끔
python pipeline/geocode_osm.py # 새 단지 좌표 (OSM)
python pipeline/geocode.py # 나머지 좌표 (카카오)
python pipeline/fetch_rent.py --lawd 11440 --months 12 # 전월세
python pipeline/fetch_kapt.py --sgg 11440 # 세대수 등 (가끔)
python pipeline/fetch_neis.py --gu 마포구 # 학원/학교 (가끔)
python pipeline/fetch_kakao_poi.py # 생활 편의 (새 단지만)
python pipeline/build.py
data/raw/geocode.json 에 좌표가 없는 단지는 앱에 안 나온다. 세대수/최고층/용적률은 K-apt 공동주택 API 연동 전까지 0 (화면에서 숨김).
정적 페이지 + 배포
python pipeline/generate_pages.py --base https://<owner>.github.io/apt-map # app/apt/*.html, sitemap.xml, robots.txt
python pipeline/deploy_github_pages.py --owner <owner> --repo apt-map # GITHUB_TOKEN 필요, gh-pages 브랜치로 app/ 푸시 + Pages ON
단지 페이지는 app/apt/<동>-<단지명>.html, 앱 딥링크는 index.html?id=<단지id>.
주기 갱신 (작업 스케줄러 JipkokMapRefresh, 매주 월 05:00)
python pipeline/refresh.py # 주간: 실거래/전월세 갱신 -> 좌표 -> 편의시설 -> build -> pages -> 알림 -> deploy
python pipeline/refresh.py --full # 분기: K-apt, 학원(NEIS), 학교알리미까지
python pipeline/build_schoolzones.py # 학구도 zip 갱신 시 (data/raw/schoolzone/ 에 풀어둔 뒤)
제보·찜 API (Cloudflare Worker)
python pipeline/deploy_worker.py # CLOUDFLARE_API_TOKEN 필요. worker/worker.js 업로드 + KV 바인딩 + app/config.js 갱신
엔드포인트: /reports?id= (GET), /reports (POST {id,name,area,price,kind,note}), /recent, /favs?code=, /favs (POST {code,ids}), /health
데이터 출처 / 한계
| 기능 | 현재 | 실서비스 계획 |
|---|
| 실거래가 | 데모 생성값 | 국토교통부 API (무료, 신고 지연 최대 30일) |
| 호가 | 데모 구간 + 사용자 제보(localStorage) | KB시세 상하한 / 지역 중개사 제휴 / 제보 검수. 네이버부동산 크롤링은 하지 않음 |
| 초등 배정 | 데모 폴리곤 | 학구도안내서비스(schoolzone.emac.kr) 통학구역 |
| 중학교 | 법정동별 학교군 목록 (데모) | 교육지원청 중학교 학교군 |
| 도로/인도 | 실데이터 (OSM, 마포구 일대) | 전국 확장 + 표준노드링크 교통량 |
| 경매 | 데모 3건 | 대법원 법원경매정보 수집 |
