표준주소실록 v3.1

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

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

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

_{▶ 클릭하면 유튜브에서 재생됩니다.}

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

---

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

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

• 🔄 어떤 주소든 표준 형식으로: 광진구 아차산로 400, 자양동 870, 광진구청 — 뭘 넣어도 도로명 + 지번 + 행정동을 한번에 뽑아줍니다.
• 📋 수백 건 일괄 변환: 엑셀에서 복사해서 붙여넣으면 끝. 변환 결과도 엑셀로 다운로드.
• 🗺️ 지도에 바로 표시: 변환된 주소를 지도 위에 번호 마커로 찍어줍니다. 현장 동선 짤 때 유용.
• 🏢 시설관리 대시보드: 관내 시설을 지도에 올리고 분류·행정동별 필터링, 검색, 색상 마커로 관리. 현장 데이터 표를 컬럼 순서 상관없이 그대로 붙여넣으면 자동 인식.
• 📊 Tableau/BI 연동: CSV 파일 올리면 위도·경도 컬럼 자동 추가. 지도 시각화 바로 가능.
• 🧩 Chrome 익스텐션: 브라우저에서 주소 드래그 → 우클릭 → 즉시 변환. 단축키, 자동감지까지.
• 🚨 인파레이더: 서울·제주·부산·강원·인천공항 239개 지점의 실시간 혼잡도를 한 지도에서. 행사 안전 담당자용 상황실 모드(다지점 감시·CSV·상황보고·붐빔 알림)까지.

---

🚨 인파레이더 (/crowd) — 실시간 인구밀집 상황판

gjdong.vercel.app/crowd · 설치 없음 · 로그인 없음 · 무료

2024년 「재난 및 안전관리 기본법」 개정으로 다중운집인파사고가 사회재난으로 법정화되면서, 인파 안전은 지자체(재난관리책임기관)의 법정 의무가 됐습니다. 그런데 행사·축제 안전 담당자가 쓸 수 있는 도구는 현장 순찰과 감뿐이었습니다. 인파레이더는 공공 개방 데이터를 실무자가 바로 쓸 수 있는 화면으로 만든 것입니다.

시민용 — 지금 어디가 붐비나

• 5개 도시 239개 지점 혼잡도 지도 + 목록 (서울 121 · 제주 66 · 부산 26 · 강원 동해안 18 · 인천공항 출국장 8)
• 지점 상세: 24시간 인파 흐름·예측(서울), 요일×시간 패턴, 주변 CCTV, 주차·문화행사·따릉이·사고 통제, 지하철 실시간 도착(서울), 대기질(에어코리아 인근 측정소, 전 도시), 시간대별 날씨
• 지금 vs 평소 배지(서울·제주): 누적 요일×시간 평균과 비교해 "평소보다 붐빔/한산"을 목록·상세에 표시 — 같은 "붐빔"이라도 이 지점 기준 이례적인지 한눈에
• 기상특보·재난문자 배너 (전 도시): 발효 중인 기상특보(기상청) + 오늘 재난문자(행안부·서울시)를 도시별로 걸러 헤더에 — 해수욕장 도시(부산·강원)의 폭염·풍랑, 제주의 강풍 특보까지
• 주변 축제·행사(서울·제주·부산·강원, TourAPI): 지점 반경의 진행 중·예정 행사 — "왜 붐비는지"와 "갈 이유"를 같이 답합니다
• 시간대 패턴 렌즈(서울·제주): 지도 우상단 시계 버튼으로 "토요일 저녁엔 어디가 붐빌까"를 요일·시각별 누적 평균으로 미리보기 (실시간 아님 표기)
• 인천공항 실황 보드(인천공항 탭 하단): 주차장 구역별 잔여·점유율, 2시간 내 도착편(입국장 문·수하물 벨트 — 마중용)과 입국장별 예상 인원(공항공사 예고), 터미널별 택시 대기 대수, 공항철도 다음 열차·첫차·막차(일반 서울역행·직통, 공식 시각표 기준), 공항버스·리무진 노선 검색과 시간표(첫차·막차·요금·다음 출발)
• 내 주변 추천, 주소로 검색, 목적 프리셋(아이랑·데이트·핫플), MBTI 추천(재미 기능), 즐겨찾기, 카카오/네이버/티맵 길찾기
• 4개 언어(한·영·일·중) 완전 현지화, PWA 설치, ?spot= ?city= ?lang= 딥링크 공유
• 붐빔 지점은 지도에서 리플(물결) 애니메이션으로 한눈에 구분

업무용 — 상황실 모드 (행사·축제 안전 담당자)

헤더의 상황판 아이콘(⊞)을 누르면 업무 모드로 전환됩니다.

• 다지점 동시 감시: 관할 지점 최대 12곳을 카드 그리드로 — 붐빔 우선 정렬, 등급 변화 추세 화살표
• 자치구 필터: "광진구 전체 추가" 한 번으로 관할 상황실 구성 (전 지점 자치구 매핑 내장)
• 기록·증빙: 전 지점 스냅샷 CSV·XLSX 다운로드(현황+행사로그 2시트, 열너비·자동필터) + 감시 지점 상황보고 문안 복사(등급 분포·인원·사고 통제·재난문자 포함)
• 보고서 출력: /crowd/report — A4 인쇄 최적화 상황보고서(표제·등급 분포·지점별 표·기상특보·재난문자·주변 행사 부록·출처 각주). 인쇄 대화상자에서 PDF 저장하면 그대로 결재 첨부물
• 행사 연동(서울·제주·부산·강원): 진행 중·예정 행사 주변 지점을 한 번에 감시목록으로 — 행사 안전관리 대상 구성이 클릭 한 번
• 행사 타임라인 로그: 상황실이 켜져 있는 동안 갱신 시각마다 감시 지점 등급을 자동 기록(이 기기 로컬, 최대 24시간) — 행사 끝나고 시간축 CSV로 내보내거나 보고서에 등급 추이 스파크라인으로 실림
• 붐빔 전환 알림: 감시 지점이 붐빔이 되면 브라우저 알림 — 약 5분 주기 감시라 실시간 경보는 아닙니다
• 상황실 공유: ?mode=ops&spots=... 링크로 동료에게 같은 구성 전달, 전체화면(상황판 벽걸이) 지원

도시별 데이터가 어떻게 다른가 (정직 고지)

같은 "붐빔"이라도 도시마다 등급의 근거가 다릅니다. 인파 실측이 아닌 도시는 목록·지도·카드에 근거를 병기합니다.

도시	등급의 의미	실시간 인원	예측	원천 갱신
서울 (121)	인파 실측 (KT 통신 기반 추정)	○	○ 12시간	5분
제주 (66)	인파 기반 파생 (SKT 통신 기반, 리듬비율×밀도상한)	○ (도민/관광객)	×	1시간 (15분 수집)
부산 (26)	주차·도로 혼잡 (인파 원천 없음)	×	×	2분
강원 (18)	주차·도로 혼잡 — 강릉권 밖 8곳은 "정보 없음"	×	×	2분
인천공항 (8)	출국장 대기시간 (30분↑ 붐빔)	○ (대기 인원)	×	1분

등급 산출식의 상세는 docs/crowd-methodology.md, 다른 지자체 이식 방법은 docs/crowd-adoption-guide.md를 보세요.

데이터 출처

서울 열린데이터광장(실시간 도시데이터)·서울 TOPIS · 제주관광공사 빅데이터(GEONET) · 부산 교통정보센터(ITS)·부산시설공단 · 국립해양조사원(해수욕장 지수) · 인천국제공항공사 · KBS 재난 CCTV · Open-Meteo, 그리고 공공데이터포털(강릉시 ITS · 기상청 기상특보 · 행안부 긴급재난문자 · 에어코리아 대기질 · 한국관광공사 TourAPI). 전부 무료 개방 원천이며, 인증키는 공공데이터포털 계정 키 하나면 됩니다(서비스별 활용신청).

한계

• 인원 수는 통신사 신호 기반 추정치입니다 — 절대값보다 등급·추세를 보세요.
• 갱신은 원천 주기 + 캐시(1~15분)를 따릅니다. 초 단위 실시간 경보 시스템이 아닙니다.
• 부산·강원의 등급은 주차·도로 혼잡의 근사입니다. 도보 인파가 많고 차량이 적은 상황은 놓칠 수 있습니다.
• 과거 되짚기는 상황실을 켜둔 동안의 행사 로그(이 기기 로컬)로만 가능합니다 — 서버 축적 리플레이는 없습니다.
• 시민 모드의 MBTI 추천은 재미 기능입니다 — 등급 산출식(방법론 문서)과 무관하며, 업무 산출물(보고서·CSV)에는 실리지 않습니다.

---

🏢 NEW (v3.1) — 시설관리 대시보드

gjdong.vercel.app/facility — 관내 시설을 지도에 올려놓고 한 화면에서 관리하세요. 경로당·어린이집·CCTV·불법광고물 등 위치 기반으로 관리하는 모든 시설에 쓸 수 있습니다.

엑셀 양식 맞추느라 컬럼 순서 바꾸고, 행정동별로 일일이 필터 거는 일 — 이제 안 해도 됩니다.

v3.1에서 새로 들어온 것

• 📥 컬럼 순서 자유 자동 인식 — 연번·시설명·주소·행정동 이든 주소·시설명·시설구분 이든, 갖고 있는 표를 그대로 붙여넣거나 업로드하면 주소·시설명·연번·분류 컬럼을 알아서 찾습니다. 헤더가 있어도, 없어도, 순서가 달라도 OK.
• 🔢 연번 자동 생성 — 연번 열이 없으면 자동으로 매기고, 가져온 표의 연번이 기존과 겹치면 빈 번호로 자동 정리합니다. 지도 마커·목록은 연번. 시설명 형태로 표시.
• 🎛️ 자동 필터 — 입력 데이터에서 행정동·시설구분 같은 분류 항목을 감지해 필터 셀렉트박스를 자동 생성합니다. 화양동 (12) 처럼 건수까지 표기.
• 🔍 시설 목록 검색 — 시설명·연번·주소·행정동·분류·메모를 통합 검색. 검색 결과 건수도 함께 표시.
• 🖥️ 지도 전체화면 — 버튼 하나로 브라우저 전체화면 전환, 지도 크기 자동 재계산.

그 외 기능

• 🎨 분류별 색상·모양 마커 — 시설 종류마다 마커 색과 모양을 지정해 지도에서 한눈에 구분
• 🏷️ 라벨 토글 — 마커 위 시설명 라벨을 켜고 끄기
• 📤 내보내기 — 현황을 엑셀·스크린샷·인쇄용 보고서로 출력 (자동 필터 컬럼도 함께 포함)
• 💾 브라우저 로컬 저장 — 모든 데이터는 이 브라우저에만 저장됩니다. 서버 전송 없음.

주소 변환기(/)에서 변환한 결과를 "시설관리에 추가" 버튼으로 바로 대시보드에 보낼 수도 있습니다.

---

🧩 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개소 주소를 행정동별로 분류해서 지도로 보고 통계도 내야 해요."

활용법: 시설관리 대시보드에 시설 목록 표를 컬럼 순서 그대로 붙여넣기 → 주소·시설명·행정동 자동 인식 → 행정동/시설구분 필터로 즉시 분류, 분류별 색상 마커로 지도 확인 → 엑셀·보고서로 내보내기

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

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

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

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

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

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

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

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

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

6. 손에 든 주소의 행정동 확인

"주소는 아는데 행정동이 안 붙어 있어서 확인이 필요해요."

활용법: 주소 입력 → 도로명·지번·행정동 즉시 확인. 여러 건이면 붙여넣기로 일괄 변환.

⚠️ 업무시스템에서는 쓰지 마세요. 새올·업무포털 등 민원인 개인정보를 다루는 행정정보시스템 화면에서 익스텐션으로 주소를 변환하면, 선택한 텍스트가 외부 서버 (gjdong.vercel.app → Kakao API)로 전송됩니다. 이 도구는 개인이 만든 비공식 도구이며 행정망 반출 승인을 받은 바 없습니다. 업무시스템의 민원인 정보에는 사용하지 마시고, 소속 기관의 정보보안 지침을 따르십시오.

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 16 (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 — 제작자가 작성한 코드에 적용됩니다.

포함된 제3자 저작물(shadcn/ui·Radix UI·SheetJS·Leaflet 등)의 저작권·라이선스 고지는 NOTICE를 참조하세요. Kakao Local API 응답 데이터의 권리는 카카오 및 원 데이터 제공처에 있으며, 위 MIT 라이선스가 적용되지 않습니다.