공공데이터포털에서 제공하는 오픈 API 서비스를 이용하려면 인증키가 필요합니다. 인증키를 얻기 위해서는 공공데이터포털에 회원가입을 하고 원하는 오픈 API 서비스를 신청해야 합니다. 공공데이터포털에서 API를 신청하면 일반적으로 1~2시간 이내에 호출이 가능합니다. 그러나 일부 API의 경우 인증 절차가 24시간 이상 소요될 수 있습니다.
항목명 | 설명 | 데이터 타입 | 샘플 데이터 | 항목구분 |
---|---|---|---|---|
pnu_code | PNU코드: 각 필지를 서로 구별하기 위하여 필지마다 붙이는 고유한 번호 | String | 540 | 필수 |
translate | 컬럼명 한글 표시 여부 (한글 표시: True, 영문 표시: False) ※ 기본값: True |
Boolean | True | 선택 |
verbose | 데이터 조회 진행 상황 메시지 출력 여부 (출력: True, 미출력: False) ※ 기본값: False |
Boolean | False | 선택 |
wait_time | API 추가 요청 시 대기 시간(초) (30초: 30) ※ 기본값: 30 |
Integer | 30 | 선택 |
항목명(국문) | 항목명(영문) | 항목설명 | 샘플데이터 |
---|---|---|---|
고유번호 | pnu | 각 필지를 서로 구별하기 위하여 필지마다 붙이는 고유한 번호 | 1.11101E+18 |
법정동명 | ldCodeNm | 토지가 소재한 소재지의 행정구역코드(법정동코드) 10자리 | 서울특별시 종로구 청운동 |
법정동코드 | ldCode | 토지가 소재한 소재지의 행정구역 명칭(법정동명) | 1111010100 |
지번 | mnnmSlno | 필지에 부여하여 지적공부에 등록한 번호 | 126-25 |
대장구분코드 | regstrSeCode | 토지가 위치한 토지의 대장 구분 (토지(임야)대장구분)코드 | 1 |
대장구분명 | regstrSeCodeNm | 코드 정보 | 토지대장 |
지목코드 | lndcgrCode | 토지의 주된 용도에 따라 토지의 종류를 구분한 지목코드 | 8 |
지목명 | lndcgrCodeNm | 코드 정보 | 대 |
면적(㎡) | lndpclAr | 지적공부에 등록한 필지의 수평면상 넓이(㎡) | 376.9 |
소유구분코드 | posesnSeCode | 국토를 토지 소유권 취득 주체에 따라 구분한 코드 | 6 |
소유구분명 | posesnSeCodeNm | 코드 정보 | 법인 |
소유(공유)인수(명) | cnrsPsnCo | 토지를 공동 소유하고있는 사람수(명) | 2 |
축척구분코드 | ladFrtlSc | 토지(임야)대장에 등록된 지적도(임야도)의 축척구분 코드 | 6 |
축척구분명 | ladFrtlScNm | 코드 정보 | 0.458333333 |
데이터기준일자 | lastUpdtDt | 데이터 작성 기준일자 | 2015-11-12 |
from PublicDataReader import LandForestLedger
service_key = "공공 데이터 포털에서 발급받은 서비스 키"
api = LandForestLedger(service_key)
df = api.get_data(
pnu_code="4113511000105420000",
)
df.head()
고유번호 | 법정동명 | 법정동코드 | 지번 | 대장구분코드 | 대장구분명 | 지목코드 | 지목명 | 면적(㎡) | 소유구분코드 | 소유구분명 | 소유(공유)인수(명) | 축척구분코드 | 축척구분명 | 데이터기준일자 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 4113511000105420000 | 경기도 성남시 분당구 백현동 | 4113511000 | 542-0 | 1 | 토지대장 | 08 | 대 | 65893.5 | 01 | 개인 | 0 | 00 | 수치 | 2022-06-07 |
- 법정동코드 목록 확인
import PublicDataReader as pdr
code_bdong = pdr.code_bdong()
code_bdong.loc[
(code_bdong['시도명']=='서울특별시') &
(code_bdong['말소일자']=='') &
(code_bdong['시군구명']=='서초구')
]
시도코드 | 시도명 | 시군구코드 | 시군구명 | 법정동코드 | 읍면동명 | 동리명 | 생성일자 | 말소일자 | |
---|---|---|---|---|---|---|---|---|---|
975 | 11 | 서울특별시 | 11650 | 서초구 | 1165000000 | 19880423 | |||
977 | 11 | 서울특별시 | 11650 | 서초구 | 1165010100 | 방배동 | 19890427 | ||
978 | 11 | 서울특별시 | 11650 | 서초구 | 1165010200 | 양재동 | 19920701 | ||
979 | 11 | 서울특별시 | 11650 | 서초구 | 1165010300 | 우면동 | 19920701 | ||
980 | 11 | 서울특별시 | 11650 | 서초구 | 1165010400 | 원지동 | 19920701 | ||
982 | 11 | 서울특별시 | 11650 | 서초구 | 1165010600 | 잠원동 | 19880423 | ||
983 | 11 | 서울특별시 | 11650 | 서초구 | 1165010700 | 반포동 | 19880423 | ||
984 | 11 | 서울특별시 | 11650 | 서초구 | 1165010800 | 서초동 | 19880423 | ||
985 | 11 | 서울특별시 | 11650 | 서초구 | 1165010900 | 내곡동 | 19880423 | ||
986 | 11 | 서울특별시 | 11650 | 서초구 | 1165011000 | 염곡동 | 19880423 | ||
987 | 11 | 서울특별시 | 11650 | 서초구 | 1165011100 | 신원동 | 19880423 |
- 건축물대장 조회 후 PNU코드 생성
from PublicDataReader import BuildingLedger
bl = BuildingLedger(service_key)
buildings = bl.get_data("총괄표제부", sigungu_code="11650", bdong_code="10300")
transform_dict = {
"0": "1",
"1": "2",
"2": "3",
}
buildings['필지구분코드'] = buildings['대지구분코드'].replace(transform_dict)
buildings['PNU'] = buildings['시군구코드'] + buildings['법정동코드'] + buildings['필지구분코드'] + buildings['번'].str.zfill(4) + buildings['지'].str.zfill(4)
buildings['필지구분코드'].value_counts()
1 27
2 1
Name: 필지구분코드, dtype: int64
- 필지구분코드로 PNU코드 list_iterator 객체 생성
it = iter(list(buildings.loc[buildings['필지구분코드']=='2']['PNU']))
- 토지임야정보 조회
pnu_code = next(it)
print(pnu_code)
api.get_data(pnu_code=pnu_code)
1165010300200360000
고유번호 | 법정동명 | 법정동코드 | 지번 | 대장구분코드 | 대장구분명 | 지목코드 | 지목명 | 면적(㎡) | 소유구분코드 | 소유구분명 | 소유(공유)인수(명) | 축척구분코드 | 축척구분명 | 데이터기준일자 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 1165010300200360000 | 서울특별시 서초구 우면동 | 1165010300 | 36-0 | 2 | 임야대장 | 05 | 임야 | 14777 | 02 | 국유지 | 0 | 30 | 1:3000 | 2022-06-07 |