토양환경 공공데이터 활용 가이드 및 파이썬 REST API 연동 실무

기후에너지환경부와 한국환경공단이 공공데이터포털을 통해 개방하는 토양측정망 및 실시간 지하수 수질 데이터는 환경 엔지니어링, 토양환경평가 및 프롭테크 분석에 필수적인 자산입니다. REST API를 활용한 데이터 호출 파이썬 코드와 결측치 정제, 공간정보시스템 시각화 기법을 총괄 안내합니다.

토양환경 주요 공공데이터 세트와 API 명세

공공데이터포털에서 제공하는 대표적인 토양·지하수 오픈 API 서비스는 다음과 같습니다.

파이썬 기반 공공데이터 API 연동 및 전처리 실무

오픈 API를 연동하여 대용량 측정 데이터를 수집하고 이상치를 정제하는 표준 데이터 파이프라인 구조는 다음과 같습니다.

• API 인증키 발급 및 요청: 공공데이터포털에서 범용 서비스키를 발급받아 requests 라이브러리로 페이징 반복 호출을 수행합니다.
• 결측치 및 검출한계 미만 처리: ‘불검출’ 또는 정량한계 미만 데이터의 처리방법은 데이터셋의 통계적 특성과 분석 목적에 따라 합리적으로 결정하며(대체법, 결측치 처리 등), 공식 분석 가이드라인이 제시된 경우 해당 기준을 우선 적용합니다.
• 좌표계 변환 및 GeoPandas 연동: WGS84 위경도 좌표를 국내 표준 직각좌표계(EPSG:5179)로 변환하여 부지 경계와 공간 조인을 수행합니다.

공공데이터 이용 요건 및 법적 유의사항

공공데이터를 활용한 데이터 분석 및 연계 시스템 구축 시 준수해야 하는 법적 요건과 기술적 관리 기준은 다음과 같습니다.

파이썬 API 호출 표준 예제 코드

import requests
import pandas as pd

# 기후에너지환경부 토양측정망 API 호출 예제
# ※ 본 코드는 공공데이터포털 REST API 연동 구조를 설명하기 위한 표준 파이썬 연동 의사 예제입니다.
# 실제 호출 시에는 공공데이터포털의 활성 OpenAPI 엔드포인트 및 발급받은 일반인증키를 확인하여 적용해야 합니다.
service_url = "https://apis.data.go.kr/1482249/SoilQualityService/getSoilQualityList"
params = {
 'serviceKey': 'YOUR_DECODED_SERVICE_KEY',
 'pageNo': '1',
 'numOfRows': '100',
 'resultType': 'json',
 'year': '2026'
}

response = requests.get(service_url, params=params, timeout=15)
if response.status_code == 200:
 data = response.json()
 items = data.get('response', {}).get('body', {}).get('items', [])
 df = pd.DataFrame(items)
 print(f"수집된 측정망 레코드 수: {len(df)}")
else:
 print(f"API 호출 실패: {response.status_code}")

자주 묻는 질문