← 보드로 돌아가기

sinmb79/geojimap-house

거지맵-가성비 주거지 여건 찾기

GitHub에서 열기 ↗
3
GitHub 스타
0
포크
TypeScript
언어
미표기
라이선스
2026.04.01
최근 푸시
2026.04.03
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
주거지 비교 서비스를 개발 중이거나 유사한 부동산 데이터 시각화 프로젝트를 고려한다면, 이 저장소의 Supabase/PostGIS 기반 공간 조회 및 실거래가 수집 파이프라인 구조를 참고할 가치가 있습니다.

강점

  • 실거래가와 생활 인프라(POI)를 함께 비교할 수 있어 가성비 주거지 탐색에 유용함
  • Leaflet + OpenStreetMap 기반으로 무료 지도 사용 가능
  • Supabase/PostGIS를 활용한 공간 조회 및 데이터 적재 파이프라인이 체계적으로 구성됨

약점

  • 아직 운영 배포 전 단계로 실제 사용자 피드백이 없음
  • 초기 데이터 적재가 완료되지 않아 현재는 빈 지도 상태
  • 서울 지역(lawdScope)만 지원하며 전국 확장 계획이 명시되지 않음

주의사항

  • 국토교통부 API 키, Kakao API 키 등 민감한 환경변수를 .env.local에 설정해야 하며, 유출에 주의
  • Supabase Edge Function 배포 및 초기 데이터 적재가 완료되어야 실제 사용 가능
  • PostGIS 공간 함수에 의존하므로 Supabase 프로젝트에 PostGIS 확장이 활성화되어 있어야 함

시작 가이드

  • Supabase Edge Function을 실제 배포하고 초기 데이터를 적재하여 지도에 마커가 표시되는지 확인
  • Vercel에 배포하여 외부에서 접근 가능한 URL을 확보
  • 도메인을 연결하고 실제 사용자 테스트를 진행하여 UI/UX 개선점 도출

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

geojimap-house

거래 데이터와 생활 인프라를 함께 보여주는 주거 비교 지도 서비스입니다. 같은 생활권 안에서 아파트, 빌라, 오피스텔의 가격 차이를 비교하고, 더 저렴한 선택지를 빠르게 찾는 것을 목표로 합니다.

주요 기능

  • Leaflet + OpenStreetMap 기반 무료 지도 표시
  • 현재 뷰포트 기준 실거래 마커 조회
  • 반경 기반 주거 유형별 가격 비교
  • POI 기반 생활편의 점수 표시
  • 국토교통부 실거래가 XML 파싱 및 적재 준비
  • Supabase/PostGIS 기반 공간 조회 함수 및 적재 함수 구성

기술 스택

  • Next.js 14 (App Router)
  • TypeScript
  • Tailwind CSS
  • Leaflet
  • Supabase
  • PostgreSQL + PostGIS
  • Supabase Edge Functions

실행 방법

  1. .env.example를 참고해 .env.local 생성
  2. 의존성 설치
npm install
  1. 개발 서버 실행
npm run dev
  1. 브라우저에서 http://localhost:3000 확인

환경변수

아래 값이 필요합니다.

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=

NEXT_PUBLIC_KAKAO_JS_KEY=
KAKAO_REST_KEY=

MOLIT_API_KEY=
  • .env.local은 Git에 포함되지 않습니다.
  • 민감한 키는 절대 저장소에 커밋하지 않도록 .gitignore가 설정되어 있습니다.

주의:

데이터베이스 초기화

Supabase SQL Editor에서 아래 파일을 실행하면 기본 테이블과 함수가 생성됩니다.

  • 20260401init.sql
  • transactions
  • reports
  • pois
  • transactionsinviewport()
  • comparetransactionsby_radius()
  • ingest_transaction()

생성 대상:

수집 함수

Supabase Edge Function 경로:

  • supabase/functions/sync-molit
  • MOLIT XML 조회
  • XML 파싱 및 정규화
  • Kakao 주소 geocoding
  • deterministic source_key 생성
  • ingest_transaction() RPC를 통한 upsert
  • 서울 lawdScope 일괄 처리

현재 지원 범위:

현재 상태

  • 지도 기본 UI
  • 필터 상태 연결
  • 비교 카드/절약 배너
  • POI 점수 패널
  • Supabase 공간 조회 연결
  • 실거래가 적재 파이프라인 기본 구조

구현 완료:

  • Supabase Function 실제 배포
  • 초기 데이터 적재 실행
  • Vercel 배포
  • 도메인 연결

운영 전 남은 작업:

라이선스 / 참고

  • 지도 타일: OpenStreetMap contributors

원본 저장소: sinmb79/geojimap-house

라이선스: 미표기

게재 제외를 원하시면 삭제 요청을 보내주세요.