v1
latestOpenAPI 3.1.02026-07-23117546.8 KB건물
건물 검색 (도면 포함)
도면이 등록된 건물 목록을 검색합니다.
사용처
- 키워드 기반 건물 검색
- 지도 영역(bounding box) 기반 건물 조회
- 면적, 침실/욕실 수 필터링
페이지네이션
- offset 기반 페이징 (0부터 시작)
- limit: 페이지 크기 (최소 1, 최대 200)
- 응답의 hasNext로 다음 페이지 존재 여부 확인
필터 조건
- keyword: 주소명 / 도로명 / 건물명 / 사용자 설정 건물 별칭 검색
- bottomRightLat, bottomRightLon, topLeftLat, topLeftLon: 지도 영역 필터 (4개 모두 입력하거나 모두 생략)
- minArea, maxArea: 도면 면적 범위 필터 (㎡)
- bedrooms: 침실 수 필터
- bathrooms: 욕실 수 필터
- sort: 정렬 기준 (ID_DESC, ID_ASC, UPDATED_ASC, UPDATED_DESC 등)
get/api/v1/building
Query parameters
offsetinteger required
페이지 번호 (0부터 시작, offset 페이징)
limitinteger required
페이지 크기 (최소: 1, 최대: 200)
sortType'ID_DESC' | 'ID_ASC' | 'NAME_ASC' | 'NAME_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC'
정렬 타입
정렬 기준
keywordstring
검색어 (주소명 / 도로명 / 건물명 / 건물 별칭)
bottomRightLatnumber double
우하단 위도 (bounding box)
bottomRightLonnumber double
우하단 경도 (bounding box)
topLeftLatnumber double
좌상단 위도 (bounding box)
topLeftLonnumber double
좌상단 경도 (bounding box)
minAreanumber double
최소 면적 (㎡)
maxAreanumber double
최대 면적 (㎡)
bedroomsinteger
침실 수
bathroomsinteger
욕실 수
Response
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)