OpenAPI

한국지질자원연구원 지오빅데이터 오픈플랫폼 오픈 API 서비스는 공개된 지질자원 데이터셋 정보를 이용자들이 보다 손쉽게 활용 할 수 있도록, 제공하는 개방형 API 서비스 입니다. 제공되는 지질자원 데이터셋 정보는 기관 또는 개인이 자유롭게 활용하여, 다양한 컨텐츠를 생산하는데 도움을 주는데 목적을 두고 있으며, 누구나 손쉽게 데이터를 활용할 수 있도록 웹서비스 방식(JSON/REST)으로 서비스를 제공합니다.

Limited usage

지나치게 잦은 API의 호출로 서버에 과도한 부하가 발생하여 다른 사용자의 이용에 지장을 줄 경우 이용에 제한이 발생할 수 있으니 서비스의 이용 시 주의를 부탁 드립니다.

OpenAPI for Geoscience Thematic Maps v1.0.0

GET/openapi/wms?key=인증키 지질주제도 WMS API
상세기능
맵 서버에서 생성된 지도 이미지 제공을 위해 Web Map Service(WMS) 표준에 기반한 오픈API 서비스를 제공합니다.
openlayer 예제 leaflet 예제 QGIS 사용 예제 ARCGIS 사용 예제
요청변수
Name Description
key
발급된 인증키
service WMS (고정값)
version 서비스 버전 1.0.0, 1.1.0, 1.1.1, 1.3.0 중 하나
REQUEST
GetMap (고정값)
layers
레이어명, 콤마구분자로 다중레이어 조회가능, 레이어목록참고
srs or crs
좌표계, 형식은 EPSG:nnnn, 서비스버전이 1.3.0일경우 파라미터키는 crs
bbox
지도범위의 경계상자, 형식은 위 좌표계 단위의 minx,miny,maxx,maxy
width
pixel단위의 지도 넓이
height
pixel단위의 지도 높이
FORMAT
image/png (고정값)
transparent 지도배경의 투명여부 true 또는 false, 기본값은 false
bgcolor 지도배경색 RRGGBB형식으로 기본값은 FFFFFF(흰색)
요청예시
호출예시

OpenAPI v1.0.0

GET/openapi/data?key=인증키 데이터셋 검색 API
상세기능
지오빅데이터 오픈플랫폼을 통해 제공되는 데이터셋을 검색할 수 있습니다.
검색결과는 데이터셋의 간략정보를 제공하며, 테이터셋 조회 API를 통해 상세정보를 조회할 수 있습니다.
요청변수
Name Description
key
발급된 인증키
page 페이지 번호
size 페이지당 출력건수
q 검색 키워드
요청예시
호출예시
GET/openapi/data/데이터셋 아이디?key=인증키 데이터셋 조회 API
상세기능
지오빅데이터 오픈플랫폼을 통해 제공되는 데이터셋 상세정보를 조회할 수 있습니다.
데이터셋 아이디는 데이터셋 식별자로 검색결과에서 response > content > id 항목의 값으로 확인할 수 있습니다.
요청변수
Name Description
key
발급된 인증키
dataset_id
데이터셋 아이디
요청예시
호출예시
GET/openapi/file/파일 아이디?key=인증키 데이터 파일 다운로드 API (데이터 파일을 다운로드합니다.)
상세기능
지오빅데이터 오픈플랫폼을 통해 제공되는 데이터셋의 파일 데이터를 다운로드 할 수 있습니다.
파일 아이디는 파일 데이터 식별자로 조회결과에서 bundles > files > id 항목의 값으로 확인할 수 있습니다.
요청변수
Name Description
key
발급된 인증키
file_id
파일 아이디
요청예시
호출예시