건축물 도면정보제공 API 레퍼런스
- OpenAPI
- 건축물 도면정보 API
- 건축물 도면정보 API 레퍼런스
층별 도면목록 정보 API 레퍼런스
도로명주소
지번주소
건축물대장키
요청주소 (Request URL)
| 요청주소 | http://blcm.go.kr/api/DrawSearch.do |
|---|
출력방식 (Response Type)
| 출력방식 |
|---|
요청변수 (Request Parameter)
| 파라미터 | 값 | 설명 |
|---|---|---|
| key* | string(필수) | 발급받은 인증키를 입력합니다. |
| q* | string(필수) | 검색을 원하는 질의를 입력합니다. (질의생성규칙 : 도로명코드 + 건물본번 + '-' + 건물부번) |
| target* | string(필수):floor | 검색을 원하는 정보의 유형입니다. 층별 도면목록 정보는 floor을 입력합니다. |
| searchType* | string(필수):road | 검색 질의 유형입니다. 도로명주소는 road를 입력합니다. |
| url* | string(필수) | 인증키 발급시 작성한 서비스 url을 입력합니다. |
| output* | string(필수) | 요청 데이터 포맷입니다. (xml, json) |
| result | string | 한 페이지에 출력될 결과수 (기본값:10) |
| pageno | string | 검색 결과 페이지 번호 (기본값:1) |
출력결과 (Response Element)
| 파라미터 | 값 | 설명 |
|---|---|---|
| totalCount | integer | 검색 결과의 총 개수 |
| currentPage | integer | 검색 결과의 페이지 번호 |
| countPerPage | integer | 현재 페이지의 검색 결과 수 |
| code | string | 검색결과 코드 |
| codeNm | string | 검색결과 메시지 |
| mgmBldrgstPk | string | 건축물대장키 |
| naAddr | string | 도로명 주소 |
| addr | string | 대지위치 |
| jibun | string | 지번 |
| bldNm | string | 건축물 명칭 |
| dongNm | string | 동 명칭 |
| blprtKindName | string | 도면 유형(배치도, 평면도) |
| flrGbCdName | string | 층 구분(지상, 지하) |
| flrNo | string | 층 번호 |
| flrNoNm | string | 층 이름 |
| blprtFileCnt | integer | 도면 이미지파일 수 |
| fileId | string | 도면 이미지파일 아이디 (도면 이미지파일 수가 1장 이상일 경우 URL을 ';' 로 구분하여 표출) |
| image | string | 도면 이미지경로 |
오류코드 (Error Code)
| 코드 | 메시지 |
|---|---|
| 0 | 정상 |
| E9999 | 시스템 오류 |
| E0001 | 승인되지 않은 인증키 |
| E0002 | 승인되지 않은 URL |
| E0003 | 승인되지 않은 정보요청 |
| E0004 | 경로에러 |