오픈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정보, 수질검사정보 등 | 공간 | |
지하수지도 | 수문지질도 | 지하수 등수위선, 대수층, 수문지질단위 등 | 공간 |
선형구조분포도 | 지질구조선, 지질구조밀도 등 | 공간 | |
지하수수질현황도 | 전기전도도, 지하수수질현황도 등 | 공간 | |
지하수오염취약성도 | 잠재오염원, 공업단지, 농업단지, 기타, 토양도, 오염취약성도 등 | 공간 | |
지하수유동체계도 | 유동방향, 지하수유동체계규모 등 | 공간 | |
지하수심도분포도 | 지하수 등수심선 등 | 공간 | |
국가지하수측정망 | 측정망현황 | 측정망, 기간, 측정망제원 정보, 관측통계 정보 등 | 속성 |
측정망 제원 | 측정망명, 관측정번호, 관측정, 표고, 권역, 위치, 설치일자, 관리기관, 심도정보, 굴착정보 등 | 속성 | |
조사현황 | 측정망명, 관측정, 착정업체, 작업기간, 착정공법 정보, 사용비트 정보, 착정구경, 심도, 우물자재 정보, 정호구조도 등 | 속성 |