FarmBiz Developers

Jeffrey Shin shinjh0711@gmail.com

스마트농업 솔루션 개발자 페이지 FarmBiz입니다.
FarmBiz는 스마트농업 솔루션 개발에 필요한 농업모델과 데이터 API에 대한 정보를 제공합니다.
정부, 공공기관, 대학 등이 제공하는 유용한 API를 선별하여 소개하고 있습니다.
* API 활용 샘플 코드는 아래 Github repository를 참조해주세요.

서울대학교 작물생태정보연구실(김광수 교수)에서 컨테이너기반 농업모델 API서비스
"CAMP(Community Agricultural Model Platform)"를 시범운영합니다.
정식서비스 전까지는 연구용으로만 지원될 예정으로 시스템이 불안정할 수 있습니다.
CAMP URL은 https://camp.re.kr입니다.

병해충 예측 앱서비스 "FarmMon v.0.5"
FarmMon은 API를 활용한 모바일 농장정보 조회서비스입니다.
원래 병해충 발생 예측정보 조회를 위해 만들었지만, 농장정보를 조회하기 위한 범용목적으로 수정할 계획입니다.

안드로이드용 앱 다운로드는 "여기"에서... 소스코드는 Github 리포지터리
"farmmon_flutter"에 공개되어 있습니다.
hidden hit counter

last modified: 2025-1-31

토양

1. 토양특성조회 OpenAPI

국립농업과학원 토양정보시스템(흙토람)에 수록된 농경지 토양특성정보를 조회합니다. 토양특성 30종중 상업적 이용을 금지하는 27종과 상업적 이용도 허용하는 3종을 별도의 API로 제공하고 있습니다.

(입력) 인증키, 지번코드(PNU코드)

(출력1) 27종_공공목적 사용만 허용(토색, 구조, 심토주토색, 모암(모재), 배수등급, 유효토심, 침식등급, 표토토성, 표토자갈함량, 분포지형, 퇴적양식, 토양목, 토양아목, 토양대군, 주토지이용, 토지이용추천, 토양유형, 논적성등급, 논저해요인, 밭적성등급, 밭저해요인, 과수상전적성등급, 과수상전저해요인, 초지적성등급, 초지저해요인, 임지적성등급, 임지저해요인)

(출력2) 3종_상업적 이용 가능(심토토성, 심토자갈함량, 경사도)는 별도 API로 제공

출처: 국립농업과학원
(27종) 문서: 신청: 샘플코드:

(3종) 문서: 신청: 샘플코드:




2. 토양화학성 검정자료 조회 OpenAPI

국립농업과학원 토양정보시스템(흙토람)에 수록된 전국 농경지(지번)의 토양검정 결과(토양화학성 분석)를 조회합니다.

(입력) 인증키, 지번코드(PNU코드)

(출력) 시료채취년도, 토양검정일, 경지구분, 지번주소, 산도, 유효인산, 유효규산, 유기물, 마그네슘, 칼륨, 칼슘, 전기전도도

출처: 국립농업과학원
문서: 신청: 샘플코드:




3. 비료사용처방 OpenAPI

토양검정 결과(토양화학성 분석)를 기준으로 비료사용 처방서를 발급합니다.

(입력) 작물, 토양검정결과값(pH, 유기물, 유효인산, 칼륨, 칼슘, 마그네슘, 유효규산), (선택사항) 전기전도도, 질산태질소 등

(출력) 비료사용 처방서(밑거름 및 웃거름으로 질소, 인산, 칼리, 퇴비 사용량)

출처: 국립농업과학원
문서: 신청: 샘플코드:




4. 토양현장진단 API

현장에서 휴대용 토양분석기로 토양을 분석한 결과에 따라 토양상태를 진단하고 이에 맞는 처방을 제공합니다. * CAMP

(입력) 휴대용 토양분석기 Rapid-d((주)테크넬) 분석결과(pH, EC, Eh, 질산이온, 황산이온, 염소이온)

(출력) 흙토람 현장진단 결과(양분 과부족, 화학적 상태), 진단결과에 따른 처방법(pH교정, 비료공급, 물공급)

출처: 국립농업과학원 · 서울대학교
문서: 테스트: 신청: 샘플코드(수정중): 활용사례:




5. 밭작물 물사용 처방 API

각 지역별로 주요 노지 밭작물에 대한 생육단계별 관수 필요량을 제시해 줍니다.

제공작물: 콩, 배추, 옥수수, 감자, 고구마, 땅콩, 양파, 사과, 무, 상추

(입력) 작물분류, 정식시기, 기상정보산출방식, 관수방법, 밭 면적

(출력) 생육단계별 물 필요량과 일일 물 필요량

출처: 국립농업과학원
문서: 참고: 신청: 샘플코드:




6. 가뭄예측 API

누적강수량, 토양표면유거수량, 누적증발산량(FAO-56 penman-monteith)을 이용하여 계산한 가뭄지수 * CAMP

(입력) 예측시점 이전 67일의 일별강수량, 예측시점 이전 7일간 일별 최고기온, 최저기온, 강수량, 수증기압, 일사량, 풍속

(출력) 일별 가뭄지수

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




7. 농업용수 저수지수위 OpenAPI

한국농어촌공사에서 관리하는 농업용저수지의 코드를 조회하고, 해당 코드로 저수지의 수위정보를 조회할 수 있습니다.

(입력) 저수지이름, 위치주소(군, 구), 저수지코드, 조회시작날짜(yyyymmdd), 조회끝날짜(yyyymmdd)

(출력) 측정날짜, 수위(m), 저수율(%)

출처: 농어촌공사
문서: 신청: 샘플코드:




8. 침수흔적도 OpenAPI

태풍, 호우, 해일 등 자연재해로 인한 침수피해 지역(농경지)에 대한 조사결과를 표시한 지도입니다.

(입력) 주제도명

(출력) 침수위, 침수심, 침수시간

출처: 생활안전정보(행안부)
문서: 신청: 샘플코드: 준비중




9. 산사태위험도 OpenAPI

집중강우 등이 발생하면 산사태가 발생할 가능성이 높은 지역(농경지)을 등급(5등급)으로 표현한 지도를 제공합니다.

(입력) 주제도명

(출력) 산사태위험도(5등급)

출처: 생활안전정보(행안부)
문서: 신청: 샘플코드: 준비중




기상

1. 농업기상 관측정보 OpenAPI

전국 150여개소의 농업기상관측용 AWS 측정정보를 1시간 간격으로 제공합니다.

(입력) 관측지역, 관측일

(출력) 기온, 습도, 강수, 바람, 토양수분, 지온 등

출처: 국립농업과학원
문서: 신청: 샘플코드:




2. 가축 더위지수 정보 OpenAPI

가축 축종(한우, 젖소, 돼지, 가금)에 대한 더위지수를 단기예보(3일)기준으로 1시간 간격으로 제공합니다.

(입력) x좌표, y좌표

(출력) 예보날짜, 예보시각, 하늘상태(sky), 기온(t3h), 강수확률(pop), 상대습도(reh), 더위지수(thi)
더위지수에 대한 축종별 위기경보단계는 아래 참고문서를 참조해주세요.

출처: 국립축산과학원
문서: 신청: 샘플코드: 활용사례:




3. 기상청 단기예보 조회서비스 OpenAPI

초단기실황(조회지역의 대표AWS관측값), 초단기예보, 단기예보를 제공합니다. 단기예보를 예시로 제시합니다.

(입력) 발표일자와 발표시각, 예보지점 x좌표, y좌표

(출력) 자료구분(기온, 1시간강수량, 동서바람성분, 남북바람성분, 습도, 강수형태, 풍향, 풍속), 실황값

출처: 기상청
문서: 신청: 샘플코드:




4. 기상청 지상(종관, ASOS) 일자료 조회서비스 OpenAPI

기상관측 지점(종관 및 ASOS 89개소)의 일단위 기상자료를 조회.

(입력) 관측지점, 시작일, 종료일

(출력) 지점명, 기온, 강수량, 풍향, 풍속, 상대습도, 증기압, 일조시간, 일사량, 적설량, 지면온도, 초상온도, 지중온도, 증발량, 일기현상

출처: 기상청
문서: 신청: 샘플코드:




5. 기상청 서리발생 가능성 예측 OpenAPI

서리발생 가능성(%) 예측 서비스.

(입력) 예측날짜, 예측시각, x좌표, y좌표

(출력) 서리발생 예측값(%)

출처: 기상청
문서: 신청: 샘플코드:




6. 30M격자단위 농업기상재해조기경보 API

필지별 상세기상정보와 재해 위험도를 알려줍니다(apikey발급 별도협의 필요, '25.1월~).

(입력) 시군명, 작물명, 날짜, xy좌표

(출력) 30미터 해상도의 기상요소별 지점값(기온, 습도, 강수량, 일사량, 일조시간, 풍속), 재해경보(냉해, 우박, 한파, 대설, 가뭄, 일소 등)

출처: 국립농업과학원
문서: 신청: 샘플코드:




7. 온실 냉난방 부하계산 API_준비중입니다

시설구조와 기상자료에 따른 냉난방 부하량을 제공

(입력) 시설구조(측고, 폭, 길이, 피복 등), 기상자료, 환경설정값

(출력) 난방부하량, 냉방부하량

출처: 국립농업과학원 농업공학부
문서: 신청: 샘플코드:




작물

1. 토마토 생육예측모델(GreenTom) API

온실내 기상환경변화에 의한 토마토 생육 예측 * CAMP

(입력) 시간별 온실내부 기상자료(온도, 습도, 이산화탄소, 일사량), 품종정보, 재배개요(정식일 등)

* 기상파일(weather.WTH), 지점정보(SITE.DAT), 재배관리파일(manage.TXT)을 zip file로 압축해서 API를 호출합니다.

(출력) 엽면적, 건물중, 수확량, 화방수 등

출처: 서울대학교
문서: 테스트: 참고논문: 입력자료: 신청: 샘플코드:




2. 배추 생육예측모델(pyCabbage) API

기상환경변화에 의한 배추 생육 예측 * CAMP

(입력) 일별 기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 구중, 구폭, 수확량 등

출처: 국립원예특작과학원
문서: 테스트: 신청: 샘플코드:




3. 마늘 생육예측API_준비중입니다.

기상환경변화에 의한 마늘 생육 예측 * CAMP

(입력) 일별 기상자료(온도, 습도, 이산화탄소, 일사량)

(출력) 엽면적, 건물중, 수확량, 화방수 등

출처: 국립원예특작과학원
문서: 테스트: 신청: 샘플코드:




4. 벼 생산량예측모델(ORYZA2000) API

벼 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드(수정):




5. 벼 생산량예측모델(CERES-RICE) API

벼 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드(수정):




6. 옥수수 생산량예측모델(CERES MAIZE) API

옥수수 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




7. 밀 생산량예측모델(CERES WHEAT) API

밀 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




8. 콩 생산량예측모델(CROPGRO-SOYBEAN) API

콩 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




9. 감자 생산량예측모델(SUBSTOR POTATO) API

감자 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




10. 식량작물 생산량예측모델(WOFOST) API

식량작물 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




11. 식량작물 생산량예측모델(LINTUL4) API

식량작물 생육 및 수량 예측 * CAMP

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 엽면적, 건물중, 수확량 등

출처: 서울대학교
문서: 테스트: 신청: 샘플코드:




12. 과수 생물계절 예측 API_준비중입니다

사과, 배 등 과수의 개화기 예측

(입력) 일별기상자료(온도, 습도, 일사량, 강우량)

(출력) 사과, 배, 개화기, 만개기 등

출처: 국립원예특작과학원
문서: 테스트: 신청: 샘플코드:




13. 작물재배 스케쥴러 API

현장데이터와 적산온도를 기반으로 17개 작물에 대한 재배시기 정보 제공

(입력) 작물명, 기상데이터, 파종일, 모델파라메터(선택)

(출력) 재배기간, 생육단계(예) 배추: 파종, 정식, 결구, 수확 등)별 날짜, 주요농작업일, 재배시 주의사항

* 벼(조생종, 중생종, 중만생종), 밀, 보리, 옥수수, 콩, 팥, 고구마, 감자, 참깨, 배추(봄, 가을), 무, 고추, 마늘, 양파

출처: 노트스퀘어
문서: Github: 신청: 샘플코드:




병해충

1. 병해충예측 OpenAPI

9개작물 52종 병해충에 대한 발생예측지도와 예측값을 제공(벼, 감자, 사과, 배, 포도, 감귤, 고추, 파, 마늘)

(입력) Ajax: xy좌표, zoom단계, REST: 기상데이터

(출력) 병해충 종류와 예측시간을 선택할 수 있는 콤보박스와 병해충 발생 예측 지도(xy좌표위치를 표시)

* 예측지도는 ajax 동적로딩 방식으로, 예측값은 REST방식으로 제공합니다.

출처: 국가농작물병해충정보(NCPMS)
문서: (벼) (사과) (배) (포도) (감귤) (고추) (마늘) (감자)
테스트: (벼) (사과) (배) (포도) (감귤) (고추) (마늘) (감자)
신청: 샘플코드(asp): 실행결과(asp)_중단: 샘플코드(REST):




2. 병해충예찰 OpenAPI

전국 2,000여개 예찰포, 관찰포에서 정기적으로 조사하는 병해충 예찰정보를 제공

(입력) 조사시도, 조사시군, 년도

(출력) 조사장소, 조사회차, 병해충명 및 조사값

* API기술명세서 보완중입니다(샘플코드를 우선 참조해주세요)

출처: 국가농작물병해충정보(NCPMS)
문서: 신청: 샘플코드:




3. 병해충영상진단 API_준비중입니다.

인공지능 병해충 영상진단 모바일 앱을 개발하여 시범적으로 테스트중이며, API도 준비중입니다. 진단앱의 내용은 아래 문서를 참고해주세요.

(입력) 병해충이미지

(출력) 병해충 진단결과(29작물: 보리, 콩, 옥수수, 감자, 고구마, 사과, 배, 포도, 복숭아, 감, 자두, 감귤, 수박, 참외, 토마토, 딸기, 멜론, 오이, 호박, 배추, 무, 양파, 파, 고추, 마늘, 생강, 참깨, 들깨, 땅콩)

출처: 농촌진흥청 문제병해충사업단
문서: 신청: 샘플코드:




4. 딸기 병해충 예측 API

엽면습윤(leaf wetness)지속시간를 이용한
시설딸기 병해충발생 예측 모델 **CAMP

(입력) 시간별 엽면습윤센서측정값, 온도, 습도

(출력) 딸기(탄저병, 잿빛곰팡이병)
* IOT포털에서 데이터를 가져와서 병해충 API를 호출합니다. API명세서 작성중

출처: 충청남도농업기술원
문서(탄저병): 문서(잿빛곰팡이병): 테스트(탄저병): 테스트(잿빛곰팡이병): 신청: 샘플코드: 활용사례:




5. 과수화상병위험도예측 API

개화기 과수화상병 발생 위험도를 예측하여 약제 살포 적기를 알려줍니다.

(입력) 작물명(사과, 배), 조회시작일, 조회종료일, xy좌표, 자료형식

(출력) 작물명, 생육단계, 적산온도, 꽃감염위험도, 꽃 마름병징출현 예상일, 궤양활성유무, 궤양마름병징출현 예상일, 신초마름병징출현 예상일

출처: 국립농업과학원
문서: 신청: 샘플코드: 활용사례:




6. 농약등록현황조회 OpenAPI

농약등록현황을 조회할 수 있습니다

(입력) 용도구분(살충제, 살균제, 제초제 생장조정제, 기타), 안전사용기준(확정여부), 검색항목, 검색단어

(출력) 안전사용기준, 작물명, 적용병해충, 용도, 품목, 상표명, 회사명, 작용기작

* 농촌진흥청 농약안전정보시스템에서 REST방식으로도 제공됩니다.(농사로는 ajax만 제공)

출처: 농촌진흥청
문서: 신청: 샘플코드:




식품

1. 식품영양성분 OpenAPI

국가표준식품성분표 10개정판에 수록된 식품의 성분정보를 제공합니다.

(입력) 식품코드(아래참고) * 전체식품수는 3,270개

(출력) 일반성분(에너지,수분,단백질,지방,회분,탄수화물,당류,총식이섬유 등), 아미노산(총아미노산, 총필수아미노산 등), 무기질(칼슘,철,마그네슘,인,칼륨,나트륨,아연,구리,망간,셀레늄,몰리브덴,요오드), 비타민, 콜레스테롤, 지방산, 식염상당량, 폐기율

출처: 국립농업과학원
문서: 참고(식품코드 등): 신청: 샘플코드:




2. 음식 정보 OpenAPI

농식품올바로에 수록된 1991종의 음식별로 재료와 조리법, 이미지정보를 제공합니다.

(입력) 음식명('밥','죽','찜','김치'), 조리법('조리')

(출력) 음식(음식코드, 음식 대분류, 음식 중분류, 음식명, 중량) 정보, 재료(식품코드, 국문 식품명, 영문 식품명, 국가표준성분식품군, 국가표준성분출처, 중량, 알레르기 정보, 자체표준 식품군명, 동식품 분류) 정보, 조리 (조리 순서, 조리 정보) 정보, 이미지 정보(이미지 주소)

출처: 국립농업과학원
문서: 신청: 샘플코드:




데이터수집

1. 데이터수집API(IOT포털)

현장의 데이터를 농촌진흥청 클라우드 서버에 전송하고 조회하는 기능을 제공합니다.

http://iot.rda.go.kr 회원가입후 이용

(입력) 채널명, API인증키, 저장일(yyyyMMdd), 저장시(HH), 수집항목(사용자 정의)

(출력) 채널명, API인증키, 저장일(yyyyMMdd), 저장시(HH), 수집데이터

* IOT서버에 저장한 일시를 기준으로 조회합니다.

출처: 농촌진흥청 IOT포털
문서: 신청: 샘플코드_read: 샘플코드_write:




2. 스마트팜 혁신밸리 수집데이터API

스마트팜 혁신밸리 4개소(김제, 상주, 밀양, 고흥)의 임대형 스마트팜에서 수집된 환경데이터를 실시간으로 조회할 수 있습니다.

(입력) 서비스키, 시설ID, 농가ID, 측정일시(YYYYMMDD)

(출력) 분야(시설원예), 측정일시, 센서값, 항목코드(내부온도, 내부습도, 내부CO2, 일사량 등), 품목코드(참외, 토마토, 딸기 등), 분류코드(내부환경, 외부환경, 토양환경, 양액정보, 제어정보)

출처: 스마트팜코리아 데이터마트
문서: 신청: 샘플코드:




3. vworld 지도검색API 2.0, Geocoder API 2.0

주소정보로 토양데이터와 같은 정보검색에 필요한 PNU코드, xy좌표(위경도)를 조회합니다.

(입력) 주소

(출력) PNU, x좌표, y좌표(meter 또는 위경도) 등

출처: 공간정보산업진흥원
문서: 신청: PNU샘플코드: Geo샘플코드: Geocoding샘플코드:




4. 농촌지역 생활권 공간데이터 API_준비중입니다.

농촌 지역 생활관련 데이터를 검색합니다.

(입력) 주소, 좌표, PNU

(출력) 보건, 의료, 문화, 체육, 보육, 교육, 행정, 복지, 여가휴게, 상업, 금융, 교통분야 데이터

출처: 국립농업과학원
문서: 신청: 샘플코드:




개발 도구



스마트팜 농부 일러스트 작가 rawpixel.com, 출처 Freepik





Contact Us