지하수 측정망

사용 설명

Open API를 정확하고 효율적으로 활용할 수 있도록 Open-API 사용 예제를 제공합니다.
요청 URL, 요청 변수, 샘플 URL, 요청 결과 출력, 오류코드 설명 예시가 정리되어 있어 개발 시 참고하여 활용하실 수 있습니다.

요청 URL

http://www.mulmoa.go.kr/openapi/api/v1/waterQualityNetwork/groundwaterSites

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
pDcVal	필수	구분	150 : 국가관리 313 : 국가오염
basin	선택	대권역	1 : 한강 2 : 낙동강 3 : 금강 4 : 영산강
output	선택	출력 포맷	xml(기본값), json

※ 시자료는 1개월, 일자료는 3개월, 월자료는 1년까지 조회 가능합니다.

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/waterQualityNetwork/groundwaterSites?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
GENNUM	관측정번호
WELLNUM	관측정
ORIG_TMX	영점표고
BLT_CODE	권역
JUSO	위치
INSTALL_DATE	설치일자
KEAUNRI_GOV	관리기관
SIGONG_GOV	시공기관
WELLDEP	정호 심도값
upprt_dgg_calbr	상부 굴착구경
lwprt_dgg_calbr	하부 굴착구경
otsd_csng_instl_iseg_cn	외부 케이싱 설치구간
otsd_csng_calbr	외부 케이싱 규격
otsd_csng_mqlt_cn	외부 케이싱 재질
insd_csng_instl_iseg_cn	외부 케이싱 설치구간
insd_csng_calbr	외부 케이싱 규격
insd_csng_mqlt_cn	외부 케이싱 재질
strnr_instl_iseg_cn	스트레나 설치구간
strnr_calbr	스트레나 규격
strnr_mqlt_cn	스트레나 재질
auto_obsrvn_eqpmnt_instl_dph	자동관측기 설치 심도
TOC1	설치 심도(TOC)
AUTO_JEPUM	자동관측기 제품명
AC_GU	관측소 전원 종류 쿠도
RAINYN	자동관측기 강우량
PROTOCOL	프로토콜
LEV	지하수위
WTEMP	수온
PH	수소이온
EC	전기전도도
DASANG	대상지하수
ROCKNAME	암석명
MEASUR_ITEM	관측항목
USE_OX	운영여부
MOISTURE_FACTOR	투수량계수값
TRANSCOE	수리전도도
l_BASIN_NM	대권역
m_BASIN_NM	중권역
CONN_WATER_OBSV	관련기상관측소
RAINGUAGE	강우량계 설치유무
ETC	비고
OBSV_CODE
OBSVRNAME	측정망명

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Open API를 보다 쉽게 활용할 수 있도록 주요 언어별 샘플 코드(Sample Code)를 제공합니다.
제공된 예제를 참고하여 API 호출 방식, 인증 처리, 요청/응답 구조를 빠르게 이해할 수 있으며, 서비스 환경에 맞춰 자유롭게 수정하여 사용할 수 있습니다.

Java

JavaScript


const API_URL = 'http://www.mulmoa.go.kr/openapi/api/v1/waterQualityNetwork/groundwaterSites';

function getObsData() {
    axios.get(API_URL)
        .then(response => {
            const res = response.data;

            // 응답 코드 확인
            if (res.result.code === '00') {
                console.log(`조회 성공 (총 ${res.count}건)`);
                console.log('데이터 목록:', res.list);

                // 여기서 res.list 배열을 활용해 비즈니스 로직 처리
            } else {
                console.error('API 내부 에러:', res.result.msg);
            }
        })
        .catch(error => {
            console.error('API 호출 중 통신 에러 발생:', error);
        });
}

제공정보 미리보기

                                    {
                                      "result": {
                                        "code": "00",
                                        "msg": "정상적으로 처리되었습니다."
                                      },
                                      "count": 735,
                                      "list": [
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "평창군(월정분교)",
                                          "obscd": "10014010  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "정선군(정선군2청사)",
                                          "obscd": "10014020  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "상원사",
                                          "obscd": "10014070  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "강릉시(대기리)",
                                          "obscd": "10014080  "
                                        },
                                                    .
                                                    .
                                                    .

사용 설명

요청 URL

http://www.mulmoa.go.kr/openapi/api/v1/waterQualityNetwork/groundwaterData

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
stationCodes	필수	지점코드	예) 770286
pDateGun	필수	구분	1 : 일자료 2 : 시간별
pRSDay	필수	조회시작일	예) 20201101
pREDay	필수	조회종료일	예) 20201104
output	선택	출력 포맷	xml(기본값), json

※ 시자료는 1개월, 일자료는 3개월, 월자료는 1년까지 조회 가능합니다.

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/waterQualityNetwork/groundwaterData?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
DT	관측일
RAIN	강수량
WL	수위
DE	심도
WT	수온
EC	전기전도도

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


const API_URL = 'http://www.mulmoa.go.kr/openapi/api/v1/waterQualityNetwork/groundwaterData';

function getObsData() {
    axios.get(API_URL)
        .then(response => {
            const res = response.data;

            // 응답 코드 확인
            if (res.result.code === '00') {
                console.log(`조회 성공 (총 ${res.count}건)`);
                console.log('데이터 목록:', res.list);

                // 여기서 res.list 배열을 활용해 비즈니스 로직 처리
            } else {
                console.error('API 내부 에러:', res.result.msg);
            }
        })
        .catch(error => {
            console.error('API 호출 중 통신 에러 발생:', error);
        });
}

제공정보 미리보기

                                    {
                                      "result": {
                                        "code": "00",
                                        "msg": "정상적으로 처리되었습니다."
                                      },
                                      "count": 735,
                                      "list": [
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "평창군(월정분교)",
                                          "obscd": "10014010  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "정선군(정선군2청사)",
                                          "obscd": "10014020  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "상원사",
                                          "obscd": "10014070  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "강릉시(대기리)",
                                          "obscd": "10014080  "
                                        },
                                                    .
                                                    .
                                                    .

물모아 : 국가 통합물관리정보플랫폼

내 주변 물정보

데이터 검색

데이터 활용

참여마당

정보마당

지하수 측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

지하수 측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색