어디살지 — 주소 1건으로 가져올 수 있는 모든 필드

현재 코드 기준 (backend/src/app/adapters/external/*) · 2026-05-19 · 어댑터 7종 · 4개 데이터 소스
7
활성 어댑터
4
데이터 소스
38
총 필드
100%
캐시 적용 가능

파이프라인

"대전 유성구 가정동 277" │ ▼ ┌─── JUSO addrLinkApi ────────────┐ (1차) │ errorCode != 0 → 폴백 │ ├─── Kakao Local b_code ──────────┘ (폴백) │ ├──► sigunguCd | bjdongCd | bun | ji (4) ▼ ┌─── Kakao Geocoding ────► lat | lon (2) │ ├─── data.go.kr 건축물대장 (4종) ────► BuildingInfo (23) │ • getBrTitleInfo │ • getBrExposPubuseAreaInfo │ • getBrHsprcInfo │ • getBrJijiguInfo │ └─── NearbyFacility (Kakao POI + TAGO) ──► 7 카테고리 (~28) ※ 모든 단계는 cached_* Redis 래퍼로 캐시 가능
JUSO

주소 변환 — building_registry_adapter._search_address

sigunguCdstr(5)
bjdongCdstr(5)
bunstr(4)
jistr(4)
admCdstr(10)
roadAddrstr
jibunAddrstr
zipNostr(5)
KAKAO

지오코딩 + b_code 폴백 — kakao_geocoding_adapter

latitudeDecimal
longitudeDecimal
b_codestr(10)
h_codestr(10)
main_address_nostr
sub_address_nostr
region_1depth_namestr
region_2depth_namestr
region_3depth_namestr
DATA.GO.KR

건축물대장 BuildingInfo — building_registry_adapter (23 필드)

기본 (10)
build_yearint (연도)
total_areafloat ㎡
main_purposestr (공동주택 …)
floors.groundint
floors.undergroundint
structurestr (RC 등)
land_areafloat ㎡
building_areafloat ㎡
coverage_ratiofloat %
floor_area_ratiofloat %
구조 / 세대 (3)
roof_structurestr
household_countint (세대)
unit_countint (호)
엘리베이터 (2)
passenger_elevator_countint
emergency_elevator_countint
주차 ParkingInfo (5)
parking.indoor_countint
parking.outdoor_countint
parking.mechanical_countint
parking.self_parking_countint
parking.total_countint
인허가 일자 (3)
permit_dateYYYYMMDD
construction_start_dateYYYYMMDD
approval_dateYYYYMMDD
용도지역 (2)
land_use_zonestr (제2종일반 …)
land_use_districtstr
외부 연동 (2)
official_priceint (원, 공시가)
energy_efficiency_gradestr (1++~7)
DATA.GO.KR

호별 면적 UnitInfo (페이징, 메일 기준 1,630 행)

units[].dongstr
units[].hostr
units[].floorint
units[].exclusive_areafloat ㎡ (전유)
units[].common_areafloat ㎡ (공용)
units[].purposestr
KAKAO TAGO

주변시설 NearbyFacilities — nearby_facility_adapter (7 카테고리)

subwayNearbyFacility · extra.line
bus_stopNearbyFacility (TAGO)
schoolNearbyFacility · extra.school_type
convenience_storeNearbyFacility
cafeNearbyFacility
pharmacyNearbyFacility
bankNearbyFacility
각 항목 = NearbyFacility
namestr
facility_typePOICategory enum
distance_mint
extradict (line / school_type)
필터용 다중 — NearbySubwayStation[] (검색 매칭)
namestr (강남역 …)
linestr (2호선)
distance_mint
walking_minint (80m/min)
KAKAO

키워드 / 사무소 / 행정구역 — kakao_keyword_search_adapter 외 (POIResult)

namestr (장소명)
addressstr (지번)
road_addressstr (도로명)
latfloat
lonfloat
categorystr (3단 카테고리)
category_group_codeSW8 / CS2 / PS3 …
phonestr | None

현재 코드의 캐시 / 신뢰성 래퍼

아직 코드에 없지만 추가 가능