핵심 요점
- 도로명과 건물번호는 한 묶음으로 봅니다.
- 동·층·호는 상세주소에 둡니다.
- 우편번호와 지역은 같은 레코드에서 가져옵니다.
작성 및 검토
편집 및 검토 원칙- 작성
- RZTKB Editorial Team
- 검토
- RZTKB Data Review
- 최근 주요 업데이트
- 2026-08-28
도로명 주소의 기본 구성
도로명 주소는 시·도, 시·군·구, 도로명, 건물번호를 중심으로 구성됩니다. 공동주택이나 복합건물이라면 건물명과 동·층·호가 상세주소로 이어집니다. 우편번호는 별도 필드로 보관하는 편이 안전합니다.
- 시·도
- 시·군·구
- 도로명과 건물번호
- 건물명·동·층·호
- 우편번호
지번주소와 분리하기
지번주소와 도로명 주소는 같은 장소를 다른 체계로 표현할 수 있지만, 한 줄에서 두 체계를 섞으면 검색과 검증이 어려워집니다. 원본 형식을 표시하고 변환된 값은 별도 필드와 출처를 함께 저장합니다.
형식 예시
김민준서울특별시 중구 세종대로 110본관 3층04524
입력 폼의 테스트 포인트
상세주소가 없는 경우, 긴 건물명, 숫자와 하이픈, 한글과 영문이 함께 있는 경우를 시험합니다. 자동완성 뒤에도 사용자가 값을 고칠 수 있어야 하며, 화면에 보이는 순서와 API 필드가 일치하는지 확인합니다.
자주 묻는 질문
상세주소에는 무엇을 쓰나요?
건물명, 동, 층, 호처럼 건물 내부 위치를 씁니다.
지번주소와 도로명 주소를 같이 저장해야 하나요?
필요하면 별도 필드로 저장하고 출처를 표시합니다.
우편번호는 숫자형이 좋은가요?
문자열이 안전합니다.