User guide
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 |
파일 아이디 |
요청예시
