PublicDataReader - 토지대장 및 임야대장 조회하기

국토교통부 토지임야정보 데이터 조회하기

파이썬 PublicDataReader 라이브러리를 이용하면 공공데이터포털에서 제공하는 국토교통부 토지임야정보 데이터를 쉽게 조회할 수 있습니다.

PublicDataReader

PublicDataReader는 공공 데이터를 자동으로 조회할 수 있는 파이썬 라이브러리입니다. 이 라이브러리는 공공데이터포털과 국가통계포털(KOSIS)과 같이 Open API 서비스로 제공하는 공공 데이터를 쉽게 조회할 수 있도록 도와줍니다. 인증키가 필요한 공공 데이터는 인증키를 사용하여 조회할 수 있고, 인증키가 필요하지 않은 데이터는 별도의 인증 절차 없이 조회할 수 있습니다. PublicDataReader를 이용하면 일반적인 공공 데이터 조회 과정에서 필요한 API 명세 찾기, 요청 작성, 반환된 데이터 정리 과정을 자동으로 처리해줍니다. 또한, 웹에 공개된 데이터를 조회할 때도 데이터 수집과 가공 과정을 자동화해줍니다. 이를 통해 코드 작성이 간결해지고 공공 데이터 조회 작업이 편리해집니다.

• PublicDataReader 깃허브 저장소
• PublicDataReader 사용자 모임

국토교통부 토지임야정보 서비스

PublicDataReader를 통해 공공데이터포털에서 제공하는 Open API 서비스를 정상적으로 이용하려면 아래 서비스 신청 페이지 링크에 접속 후 서비스 이용 신청을 해야 합니다. 서비스 신청을 완료하면 Open API를 사용할 수 있는 서비스 키가 발급됩니다. 서비스 제공 기관에 따라 서비스 키 발급 후 약 1~2일이 지난 후 접근 권한이 부여될 수 있습니다. 충분한 시간이 지난 후에도 접근 권한이 부여되지 않는다면 서비스 제공처에 문의하는 것을 권장합니다.

• 토지임야정보 조회 서비스 신청 페이지

PublicDataReader 설치하기

1. 운영체제(OS)에 따라 아래 중 하나를 선택합니다.

• Windows: CMD(명령 프롬프트) 실행
• Mac: Terminal(터미널) 실행

1. 아래 Shell 명령어를 입력 후 실행합니다.

pip install PublicDataReader --upgrade

오픈 API 서비스 키 입력하기

공공데이터포털에서 발급받은 서비스 키를 복사하여 다음과 같이 service_key 변수에 할당합니다. 오픈 API 서비스 키 발급 방법에 대해 궁금하신 분들은 구글에 ‘공공데이터포털 오픈 API 사용법‘을 검색하시면 여러 문서들을 참조할 수 있습니다.

service_key = "공공데이터포털에서 발급받은 서비스 키"

국토교통부 토지임야정보 조회 API 인스턴스 정의하기

PublicDataReader 라이브러리에서 LandForestLedger라는 클래스를 가져와 api 라는 토지임야정보 조회 API 인스턴스를 생성합니다. 이 때, service_key 값을 인자로 입력합니다.

from PublicDataReader import LandForestLedger
api = LandForestLedger(service_key)

시군구코드와 법정동코드 조회하기

토지임야정보를 조회하려면 조회할 토지나 임야 필지가 속해 있는 시군구와 법정동 정보를 알아야 합니다. 예를 들어, 경기도 성남시 분당구 백현동에 있는 필지의 대장 정보를 조회한다고 가정하면, 분당구 백현동에 해당하는 시군구코드와 법정동코드 정보를 알아야 합니다. 아래 코드는 PublicDataReader 라이브러리를 사용하여 분당구 백현동과 일치하는 행을 찾는 작업을 수행합니다.

1. 먼저 PublicDataReader 라이브러리를 가져와 pdr라는 별칭으로 사용 할 수 있도록 합니다.
2. ‘sigungu_name = “분당구” bdong_name = “백현동” 이 부분에서 검색할 시군구와 읍면동을 변수에 저장합니다.
3. code = pdr.code_bdong() code라는 변수에 pdr의 code_bdong() 함수를 실행하여 그 결과값을 저장합니다. 이 함수는 시군구와 읍면동에 해당하는 코드를 포함하는 데이터프레임을 반환합니다.
4. code.loc[(code[‘시군구명’].str.contains(sigungu_name, na=False)) & (code[‘읍면동명’]==bdong_name)] 이 부분에서는 시군구명열에서 ‘분당구’를 포함하는 행과 읍면동명열에서 ‘백현동’인 행을 검색하는 검색식을 작성합니다.

조회 결과를 살펴보면 분당구에 해당하는 시군구코드는 41135이고, 백현동에 해당하는 법정동코드는 4113511000인 것을 알 수 있습니다. 법정동코드 10자리 중 처음 5자리는 시군구코드와 같고, 이후 5자리는 읍면동코드를 의미합니다. 주택인허가 조회 시 시군구코드와 법정동코드를 사용하는데, 이때 사용되는 법정동코드는 5자리 읍면동코드입니다. 즉, 주택인허가 조회 시 사용할 시군구코드는 41135이고, 법정동코드는 11000이 됩니다.

import PublicDataReader as pdr
sigungu_name = "분당구"
bdong_name = "백현동"
code = pdr.code_bdong()
code.loc[(code['시군구명'].str.contains(sigungu_name, na=False)) &
         (code['읍면동명']==bdong_name)]

	시도코드	시도명	시군구코드	시군구명	법정동코드	읍면동명	동리명	생성일자	말소일자
5162	41	경기도	41135	성남시 분당구	4113511000	백현동	NaN	19930115	NaN

토지임야목록 조회 서비스

입력 명세

항목명	설명	데이터 타입	샘플 데이터	항목구분
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

(참고) 건축물대장에서 PNU코드 목록 조회

• 법정동코드 목록 확인

import PublicDataReader as pdr
code_bdong = pdr.code_bdong()
code_bdong.loc[
    (code_bdong['시도명']=='서울특별시') &
    (code_bdong['말소일자'].isna()) &
    (code_bdong['시군구명']=='서초구')
]

	시도코드	시도명	시군구코드	시군구명	법정동코드	읍면동명	동리명	생성일자	말소일자
975	11	서울특별시	11650	서초구	1165000000	NaN	NaN	19880423	NaN
977	11	서울특별시	11650	서초구	1165010100	방배동	NaN	19890427	NaN
978	11	서울특별시	11650	서초구	1165010200	양재동	NaN	19920701	NaN
979	11	서울특별시	11650	서초구	1165010300	우면동	NaN	19920701	NaN
980	11	서울특별시	11650	서초구	1165010400	원지동	NaN	19920701	NaN
982	11	서울특별시	11650	서초구	1165010600	잠원동	NaN	19880423	NaN
983	11	서울특별시	11650	서초구	1165010700	반포동	NaN	19880423	NaN
984	11	서울특별시	11650	서초구	1165010800	서초동	NaN	19880423	NaN
985	11	서울특별시	11650	서초구	1165010900	내곡동	NaN	19880423	NaN
986	11	서울특별시	11650	서초구	1165011000	염곡동	NaN	19880423	NaN
987	11	서울특별시	11650	서초구	1165011100	신원동	NaN	19880423	NaN

• 건축물대장 조회 후 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

참고

• PublicDataReader 깃허브 저장소
• PublicDataReader 사용자 모임