Skip to content

chrisryugj/gjdong

Repository files navigation

표준주소실록 v3.0

뒤죽박죽 주소, 한방에 정리해버리겠다.

Deploy license

공무원이 현장방문 가기 전에 주소 정리하느라 반나절 날리는 거, 더 이상 못 참겠어서 만들었습니다.

도로명, 지번, 행정동 — 어떤 형태로 들어와도 표준 형식으로 통일하고, 지도에 찍고, 엑셀로 뽑습니다.

지금 바로 사용하기 (gjdong.vercel.app)


💡 표준주소실록으로 무엇을 할 수 있나요?

주소 하나 검색하는 도구가 아닙니다. 주소가 들어간 모든 업무를 자동화합니다.

  • 🔄 어떤 주소든 표준 형식으로: 광진구 아차산로 400, 자양동 870, 광진구청 — 뭘 넣어도 도로명 + 지번 + 행정동을 한번에 뽑아줍니다.
  • 📋 수백 건 일괄 변환: 엑셀에서 복사해서 붙여넣으면 끝. 변환 결과도 엑셀로 다운로드.
  • 🗺️ 지도에 바로 표시: 변환된 주소를 지도 위에 번호 마커로 찍어줍니다. 현장 동선 짤 때 유용.
  • 📊 Tableau/BI 연동: CSV 파일 올리면 위도·경도 컬럼 자동 추가. 지도 시각화 바로 가능.
  • 🧩 Chrome 익스텐션: 브라우저에서 주소 드래그 → 우클릭 → 즉시 변환. 단축키, 자동감지까지.

🧩 NEW — Chrome 익스텐션

웹사이트를 열 필요도 없습니다. 브라우저 위에서 바로 주소를 변환하세요.

이런 순간에 쓰세요

새올에서 민원 주소 복사했는데, 행정동이 안 붙어 있다?

→ 주소 드래그 → 우클릭 → "표준주소 변환" → 끝.

업무포털에서 주소 100개 복사해서 엑셀 정리해야 한다?

→ 익스텐션 팝업 열고 붙여넣기 → 일괄 변환 → 결과 복사.

웹서핑하다가 주소가 눈에 띈다?

→ 복사만 하면 자동 감지해서 알림으로 변환 결과를 띄워줍니다.

5가지 변환 방법

방법 어떻게 언제 쓰면 좋은지
인라인 카드 주소를 마우스로 드래그하면 바로 옆에 변환 카드가 뜸 가장 빠름 — 클릭 없이 바로 확인
우클릭 변환 주소 드래그 → 우클릭 → "표준주소 변환" 인라인 카드 대신 알림으로 받고 싶을 때
팝업 변환 익스텐션 아이콘 클릭 → 입력 여러 주소를 한번에 일괄 변환할 때
단축키 Ctrl+Shift+C (Mac: Cmd+Shift+C) 클립보드에 주소를 복사한 직후
자동 감지 주소 복사 시 자동으로 변환 알림 설정 켜두면 알아서 작동

인라인 카드 — 드래그만 하면 끝

익스텐션의 핵심 기능입니다. 아무 웹페이지에서 주소를 마우스로 드래그하면:

  1. 선택한 주소가 보라색 하이라이트로 표시되고
  2. 바로 옆에 말풍선 형태의 변환 카드가 나타납니다
  3. 카드 안의 토글 칩으로 보고 싶은 항목만 골라서 표시 (도로명, 지번, 행정동, 우편번호, 좌표)
  4. 항목을 클릭하면 바로 복사, 설정은 자동 저장

네이버 지도에서 주소를 복사하면 "복사/지번/도로명" 같은 UI 텍스트가 붙는데, 자동으로 제거해줍니다.

7가지 출력 포맷

필요에 따라 골라 쓰세요: 표준형식1, 표준형식2, 도로명주소, 지번주소, 행정동, 우편번호, 세부주소

그 외

  • 즐겨찾기 — 자주 쓰는 주소 저장해두고 원클릭 복사
  • 변환 히스토리 — 최근 20건 자동 저장, 다시 찾을 필요 없음
  • 독립 창 모드 — 팝업이 닫히는 게 싫으면 별도 창으로 분리
  • 인라인/팝업/알림 3가지 우클릭 모드 선택 가능
  • 설정 커스터마이징 — 기본 포맷, 지도 제공자, 알림 등 세부 조정

이런 업무에 쓰세요

실제 지방공무원이 겪는 주소 관련 업무 시나리오입니다. 본인 업무에 겹치는 게 있다면 바로 써보세요.

1. 복지 · 주민지원 — 현장방문 명단 정리

"취약계층 100가구 현장방문 해야 하는데, 엑셀에 주소가 도로명·지번·행정동 뒤죽박죽이라 정리에만 반나절 걸려요."

Before: 엑셀 열어서 한 건씩 네이버/카카오 지도에 검색 → 복사 → 붙여넣기 × 100회 After: 주소 열 전체 복사 → 표준주소실록 붙여넣기 → 엔터 → 도로명+지번+행정동 엑셀로 다운로드 (3분)

2. 시설 관리 — 행정동별 시설 분류

"관내 경로당·어린이집 200개소 주소를 행정동별로 분류해서 통계 내야 해요."

활용법: 시설 목록 엑셀에서 주소 | 시설명 2열 복사 → 표준주소실록 붙여넣기 → 행정동이 자동 추가된 엑셀 다운로드 → 피벗 테이블로 행정동별 집계

3. 현장점검 · 단속 — 지도 기반 동선 계획

"불법광고물 신고 30건 위치를 지도에서 한눈에 보고 싶고, 동선도 짜야 해요."

활용법: 신고 주소 일괄 입력 → 지도에 번호 마커가 자동 표시 → 마커 순서로 현장 동선 계획 → 결과 엑셀로 저장해 보고서 첨부

4. 통계 · 보고 — 보고서용 주소 통일

"사업 대상지 주소가 담당자마다 제각각이에요. 보고서 양식은 표준형식인데..."

활용법: 담당자들이 보낸 잡다한 주소 모두 붙여넣기 → 표준형식으로 일괄 변환 → 클릭 한 번으로 복사 → 보고서에 붙여넣기

5. 민원 응대 — 약칭·별칭 즉시 확인

"민원인이 '광진구청 뒤편 공원'이라고 말했는데, 정확한 주소를 알아야 해요."

활용법: "광진구청" 입력 → 도로명·지번·좌표까지 즉시 표시 → 전화 끊기 전에 바로 안내 가능

6. 새올·업무포털 복붙 업무

"새올에서 민원 주소 복사했는데 행정동이 안 붙어 있어서 확인이 필요해요."

활용법: Chrome 익스텐션 설치 → 새올에서 주소 드래그하면 옆에 변환 카드가 바로 뜸 → 행정동 확인하고 바로 업무 진행. 페이지 이동 0회.

7. Tableau · Power BI 지도 시각화

"구민 만족도 조사 데이터(주소 포함)를 Tableau에서 지도로 시각화하고 싶어요."

활용법: Tableau Geocoder에 CSV 업로드 → 주소 컬럼 선택 → 위도·경도 컬럼이 추가된 CSV 다운로드 → Tableau/Power BI에 그대로 올리면 지도 시각화 완료. 한글 인코딩(UTF-8/EUC-KR/CP949) 자동 감지.

8. 공공데이터 정제 · 매칭

"공공데이터포털에서 받은 시설 정보와 우리 DB를 매칭해야 하는데, 주소 형식이 달라서 안 맞아요."

활용법: 양쪽 주소 모두 표준주소실록으로 변환 → 동일한 표준형식으로 통일 → VLOOKUP/조인 정상 작동

9. 긴급상황 · 재난 대응

"침수 피해 신고 50건 위치를 즉시 지도에서 확인하고 싶어요."

활용법: 접수된 주소 한꺼번에 입력 → 지도 마커로 피해 지역 분포 즉시 확인 → 의사결정 가속화


변환 예시

입력 출력 (표준형식)
광진구 아차산로 400 서울특별시 광진구 아차산로 400(자양동 870, 자양2동)
자양동 870 서울특별시 광진구 아차산로 400(자양동 870, 자양2동)
광진구청 서울특별시 광진구 아차산로 400(자양동 870, 자양2동)
판교역로 235 경기도 성남시 분당구 판교역로 235(삼평동 681, 삼평동)

도로명, 지번, 건물명, 약칭 — 뭘 넣어도 같은 표준 형식으로 나옵니다.


📖 사용 방법 (처음이라면 여기부터)

웹에서 주소 변환하기

설치 없이 바로 쓸 수 있습니다.

1단계 — 사이트 열기

gjdong.vercel.app 에 접속합니다. (PC, 모바일 다 됩니다)

2단계 — 주소 입력하기

입력창에 주소를 넣습니다. 아래처럼 아무렇게나 넣어도 됩니다.

광진구 아차산로 400
자양동 870
광진구청

여러 개를 한번에 하고 싶으면? 한 줄에 하나씩, 엔터로 구분해서 넣으세요.

3단계 — Enter 또는 검색 아이콘 클릭

Enter를 누르거나 입력창 오른쪽의 검색 아이콘을 클릭하면 변환이 시작됩니다. 결과가 오른쪽에 나타나고, 지도에도 위치가 표시됩니다.

여러 줄을 입력 중이라면 Shift+Enter로 줄바꿈하세요. Enter만 누르면 바로 검색됩니다.

4단계 — 결과 가져가기

  • 결과를 클릭하면 자동으로 복사됩니다
  • 상단 칩 버튼으로 원하는 출력 포맷(도로명, 지번, 행정동 등)을 바꿀 수 있습니다
  • 여러 건이면 "엑셀 다운로드" 버튼으로 파일로 받을 수 있습니다

꿀팁: 엑셀에서 시설명과 주소를 2열로 복사해서 붙여넣으면, 시설명도 같이 처리됩니다.


Chrome 익스텐션 설치하기

브라우저에서 바로 주소를 변환하고 싶다면 익스텐션을 설치하세요.

1단계 — 다운로드 및 압축 해제

이 저장소의 gjdong-extension.zip 파일을 다운로드 받은 후, 압축을 해제합니다.

2단계 — Chrome에 설치

  1. Chrome 주소창에 chrome://extensions 입력 후 이동
  2. 오른쪽 위 "개발자 모드" 스위치를 켜기
  3. "압축해제된 확장 프로그램을 로드합니다" 버튼 클릭
  4. 압축을 해제한 폴더(chrome-mv3-prod 또는 해당 폴더)를 선택

설치하면 Chrome 오른쪽 위에 표준주소실록 아이콘이 생깁니다.

3단계 — 사용하기

설치 끝! 이제 아무 웹페이지에서:

  • 주소를 마우스로 드래그 → 바로 옆에 변환 카드가 뜹니다
  • 우클릭 → "표준주소 변환" 메뉴를 클릭해도 됩니다
  • Ctrl+Shift+C 를 누르면 방금 복사한 주소가 바로 변환됩니다

Tableau/BI 도구에서 지도 만들기

주소가 담긴 엑셀/CSV 파일에 위도·경도를 붙여주는 기능입니다.

  1. gjdong.vercel.app/tableau-geocoder 에 접속
  2. 주소가 들어있는 CSV 또는 엑셀 파일을 업로드
  3. 주소 컬럼을 선택
  4. 다운로드 → 위도·경도 컬럼이 추가된 파일을 받습니다

받은 파일을 Tableau, Power BI 등에서 열면 바로 지도 시각화가 됩니다. 한글 CSV 파일도 걱정 없이 올려주세요 (UTF-8, EUC-KR, CP949 다 됩니다).


기술 스택

웹 앱

Framework Next.js 15 (App Router), React 19
UI Tailwind CSS 4, shadcn/ui
지도 Leaflet.js (OpenStreetMap)
API Kakao Local API
엑셀 xlsx

Chrome 익스텐션

Framework Plasmo (Manifest V3), React 19, TypeScript
UI Tailwind CSS 3
저장소 @plasmohq/storage

개발자용

설치 및 실행

웹 앱

npm install
npm run dev      # http://localhost:3000
npm run build    # 프로덕션 빌드

Chrome 익스텐션

cd extension
npm install
npm run dev      # 핫 리로드 개발 모드
npm run build    # 프로덕션 빌드
npm run package  # .zip 패키징

빌드 후 chrome://extensions → 개발자 모드 → "압축해제된 확장 프로그램을 로드합니다" → extension/build/chrome-mv3-prod 선택

환경 변수

.env.local 파일 생성:

KAKAO_REST_API_KEY=your_kakao_rest_api_key

Kakao Developers에서 앱 생성 → REST API 키 복사 → 웹 플랫폼에 도메인 등록

Vercel 배포

  1. GitHub에 푸시
  2. Vercel에서 import
  3. Environment Variables에 KAKAO_REST_API_KEY 추가
  4. Deploy

제한 사항

  • Kakao API 무료 플랜: 일 30만 건 제한
  • 200개 이상 주소 변환 시 확인 메시지 표시
  • 변환 실패 시 원본 주소 그대로 표시

만든 사람

대한민국 지방공무원. 광진구청에서 7년간 주소 정리하다가 이걸 만들었습니다. 현장방문 가기 전에 주소 뒤죽박죽인 엑셀 정리하는 거, 이제 안 해도 됩니다.

라이선스

MIT

About

표준주소실록 v3.0 | 뒤죽박죽 주소, 한방에 정리해버리겠다.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors