메인로고

국가지하수정보센터

오픈 API

  • 데이터 서비스
  • 오픈 API
지하수 정보의 개방, 공유, 참여를 통해 공간 정보의 자율적이고 창조적인 다양한 애플리케이션을 개발할 수 있도록 오픈 API 서비스와 기술을 제공합니다.

소개

속성 정보

- 속성정보에 대한 데이터를 외부에서 활용할 수 있도록 XML 또는 JSON 형태로 데이터를 제공하는 API서비스입니다.

공간 정보

- OGC(Open Geospatial Consortium)가 제정한 표준 프로토콜을 이용해 지리공간 정보를 두 가지 형태의 API서비스를 제공합니다.

  • WMS (Web Map Service) 서비스는 지리 데이터에서 생성된 맵 이미지(png, jpg, gif)를 활용할 수 있도록 합니다.

  • WFS (Web Feature Service) 서비스는 (벡터 도형 및 속성을 지닌) 지리 피처 데이터를 활용할 수 있도록 합니다.

인증키 발급

  • 오픈API서비스는 활용신청 절차를 통해 이용하실 수 있습니다.

  • 오픈API 사용 신청 (오픈API > 상세기능 > 신청하기) 을 통해 인증키를 발급받습니다. 활용신청 후 부여받은 인증키값과 함께 요청URL을 서버로 전송하면 오픈API 서비스를
    사용하실 수 있습니다.

요청 URL 작성 예시

- 요청 URL은 오퍼레이션 상세 (오픈API 서비스 목록 > 서비스 상세 > 상세기능) 화면의 요청주소란에서 확인할 수 있습니다.

속성 정보

- 서비스 결과는 XML 또는 JSON 형식으로 받을 수 있고, 아래 예시처럼 원하는 결과형식을 지정할 수 있습니다.
format 요청변수를 이용하여 원하는 결과형식을 지정하며, 결과형식을 지정하지 않으면 기본값으로 XML 형식이 사용됩니다.

  • JSON 형식 : http://www.gims.go.kr/서비스제공 restful URI.?type=json&key=인증키[&요청변수=값]

  • XML 형식 : http://www.gims.go.kr/서비스제공 restful URI.?type=xml&key=인증키[&요청변수=값]

공간 정보

- WMS/WFS 서비스별로 필요한 요청변수는 [요청변수] 탭을 참고합니다.

  • http://www.gims.go.kr/서비스제공 restful URI.?key=인증키[&요청변수=값]

개방데이터

- 지하수 데이터를 사용자 활용이 용이하도록 오픈API 서비스를 통해, 공간과 속성 형태로 표준용어를 준수하여 오픈 포맷으로 제공됩니다.

개방데이터를 구분, 데이터명, 속성정보, 구분으로 나타낸 목록
구분 데이터명 속성정보 구분
지하수시설 개발이용관정 종류, 주소, 허가신고형태, 지하수용도, 지하수음용여부, 굴착정보, 설치심도, 소유수량, 취수계획량, 양수능력, 동력장치마력, 토출관직경, 위치정보 등 공간
관측망 종류, 공번, 지자체관측소명, 관측소코드, 인허가등록번호, 주소, 경도, 위도, 관할기관, 설치일자, 관측정 정보, 굴착정보, 관측방법, 관측항목, 용도, 음용여부 등 공간
조사시설 종류, 보고서번호, 보고서명, 조사기관, 착정/지층정보, 대수성 시험정보, WHPA정보, 수질검사정보 등 공간
지하수지도 수문지질도 지하수 등수위선, 대수층, 수문지질단위 등 공간
선형구조분포도 지질구조선, 지질구조밀도 등 공간
지하수수질현황도 전기전도도, 지하수수질현황도 등 공간
지하수오염취약성도 잠재오염원, 공업단지, 농업단지, 기타, 토양도, 오염취약성도 등 공간
지하수유동체계도 유동방향, 지하수유동체계규모 등 공간
지하수심도분포도 지하수 등수심선 등 공간
국가지하수관측망 관측망현황 관측소, 기간, 관측소제원 정보, 관측통계 정보 등 속성
관측소 제원 관측소명, 관측정번호, 관측정, 표고, 권역, 위치, 설치일자, 관리기관, 심도정보, 굴착정보 등 속성
조사현황 관측소명, 관측정, 착정업체, 작업기간, 착정공법 정보, 사용비트 정보, 착정구경, 심도, 우물자재 정보, 정호구조도 등 속성
오픈 API 바로가기
quick
menu