오픈API 상세

XML

건물에너지정보 서비스

지번별 전기, 가스 등 건물별 에너지 사용량

※ 활용신청은 PC버전에서만 가능합니다.

OpenAPI 정보

분류체계
지역개발 - 지역및도시
제공기관
국토교통부
관리부서명
녹색건축과
관리부서 전화번호
보유근거
수집방법
API 유형
REST
데이터포맷
XML
활용신청
556
데이터한계
키워드
에너지, 건물, 사용량
등록
2015-12-24
수정
2018-03-23
심의유형
개발단계 : 허용 / 운영단계 : 허용
비용부과유무
무료

상세기능

건물에너지관리시스템을 통해 수집된 전기의 사용량 정보를 제공한다. 단, 단독주택과 500세대 미만 공동주택은 대상에서 제외함

  • 활용승인 절차 개발단계 : 허용 / 운영단계 : 허용
  • 신청가능 트래픽 1000000 / 운영계정은 활용사례 등록시 신청하면 트래픽 증가 가능
  • 요청주소 http://apis.data.go.kr/1611000/BldEngyService/getBeElctyUsgInfo
  • 서비스URL http://apis.data.go.kr/1611000/BldEngyService

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
리스트수 numOfRows VARCHAR2(3) 0 10 페이지당 목록 수
페이지번호 pageNo VARCHAR2(3) 0 1 페이지번호
시군구코드 sigunguCd VARCHAR2(5) 1 11680 행정표준코드
법정동코드 bjdongCd VARCHAR2(5) 1 10300 행정표준코드
bun VARCHAR2(4) 1 0012
ji VARCHAR2(4) 1 0000
사용년월 useYm VARCHAR2(6) 1 201501 YYYYMM

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
시군구코드 sigunguCd VARCHAR2(5) 1 11680 행정표준코드
법정동코드 bjdongCd VARCHAR2(5) 1 10300 행정표준코드
대지구분코드 platGbCd VARCHAR2(1) 0 0 0:대지 1:산 2:블록
bun VARCHAR2(4) 0 0012
ji VARCHAR2(4) 0 0000
새주소도로코드 naRoadCd VARCHAR2(12) 0 116804166040 새주소도로코드
새주소지상지하코드 naUgrndCd VARCHAR2(1) 0 0 새주소지상지하코드
새주소본번 naMainBun NUMBER(5) 0 21.0 새주소본번
새주소부번 naSubBun NUMBER(5) 0 0.0 새주소부번
사용량 useQty NUMBER(22) 1 1112466.0 사용량
Items 1..n
순번 rnum NUMBER(8) 0 1 순번
사용년월 useYm VARCHAR2(6) 1 201501 사용년월
대지위치 platPlc VARCHAR2(500) 1 서울특별시 강남구 개포동 12-4번지 대지위치
도로명대지위치 newPlatPlc VARCHAR2(400) 0 서울특별시 강남구 개포로109길 21 도로명대지위치

샘플코드

샘플코드는 PC에서 확인해주세요.

  • 13110343

    2020-06-12 18:37

    요청변수의 번과 지는 어떤 것을 나타내나요?
  • tjdeo0427

    2017-07-26 16:47

    OPENAPI활용하려하는데, XML열어보니 시군구코드, 법정동코드등을 일일히 입력하면 데이터가 한건씩밖에 조회가 안되더라고요, 여러건을 한번에 다보는 방법은 없나요?