오픈API

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

이용제한

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

지질주제도 오픈 API

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(흰색)
요청예시
호출예시

오픈API

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
파일 아이디
요청예시
호출예시
GET/openapi/jeju-rock?key=인증키 제주도 암석시료 분석정보 검색 API
상세기능
제주도에서 채취한 암석시료의 분석정보(위치, 주원소·미량원소 분석 여부 등)를 검색할 수 있습니다.
검색결과는 시료의 간략정보를 제공하며, 제주도 암석시료 분석정보 조회 API를 통해 분석값과 박편 사진을 조회할 수 있습니다.
요청변수
Name Description
key
발급된 인증키 (요청 헤더 X-Auth-Key로도 전달할 수 있습니다.)
q 시료 아이디의 일부 (영문, 숫자, 하이픈, 괄호, 마침표 / 대소문자 구분 없음)
bbox 검색 영역. 최소경도,최소위도,최대경도,최대위도 (예: 126.1,33.1,127.0,33.6)
hasMajor 주원소 분석값 유무 (true: 있는 시료만, false: 없는 시료만)
hasTrace 미량원소 분석값 유무 (true: 있는 시료만, false: 없는 시료만)
page 페이지 번호 (0부터 시작, 기본값 0)
size 페이지당 출력건수 (기본값 20, 최대 100)
응답항목
Name Description
totalElements 검색된 전체 시료 수
totalPages 전체 페이지 수
numberOfElements 현재 페이지의 시료 수
content[].sampleId 시료 아이디
content[].longitude / latitude 경도 / 위도 (WGS84, EPSG:4326)
content[].elevation 고도 (예: 118 m, 없으면 null)
content[].collectionDate 채취일자 (YYYY-MM-DD, 없으면 null)
content[].laboratory 분석기관
content[].provider 자료제공 기관
content[].hasMajorElements 주원소 분석값 유무
content[].hasTraceElements 미량원소 분석값 유무
요청예시
https://data.kigam.re.kr/openapi/jeju-rock?key=인증키&q=AS9&hasMajor=true&page=0&size=2
{
  "request": { "q": "AS9", "bbox": "", "hasMajor": "true", "hasTrace": "", "page": 0, "size": 2 },
  "response": {
    "totalElements": 8,
    "totalPages": 4,
    "numberOfElements": 2,
    "content": [
      {
        "sampleId": "AS92-23",
        "longitude": 126.781716,
        "latitude": 33.412381,
        "elevation": null,
        "collectionDate": null,
        "laboratory": "Actlabs",
        "provider": "제주특별자치도 세계유산본부 한라산연구부",
        "hasMajorElements": true,
        "hasTraceElements": false
      },
      ...
    ]
  }
}
GET/openapi/jeju-rock/시료 아이디?key=인증키 제주도 암석시료 분석정보 조회 API
상세기능
암석시료 한 건의 상세정보를 조회할 수 있습니다.
시료 기본정보와 함께 주원소(wt%)·미량원소(ppm) 분석값, 박편 사진 주소를 제공합니다.
요청변수
Name Description
key
발급된 인증키 (요청 헤더 X-Auth-Key로도 전달할 수 있습니다.)
sample_id
시료 아이디 (검색 API 결과의 sampleId)
응답항목
Name Description
sampleId ~ hasTraceElements 검색 API의 시료 간략정보와 같습니다.
projected 평면직각좌표 (crs: EPSG:5186, x, y)
thinSectionPhotos 박편 사진 주소. planePolarized: 개방니콜(오픈니콜), crossPolarized: 직교니콜(크로스니콜)
주소를 그대로 호출하면 사진(JPEG, 한 장에 수 MB)을 받을 수 있습니다. 사진이 없으면 null
majorElements 주원소 분석값. unit: wt%, values: SiO2, Al2O3, Fe2O3T, MnO, MgO, CaO, Na2O, K2O, TiO2, P2O5, LOI, Total
분석값이 없는 시료는 null
traceElements 미량원소 분석값. unit: ppm, values: V, Cr, Co, Ni, Cu, Zn, Ga, Ge, As, Rb, Sr, Y, Zr, Nb, Mo, Ag, In, Sn, Sb, Cs, Ba, La, Ce, Pr, Nd, Sm, Eu, Gd, Tb, Dy, Ho, Er, Tm, Yb, Lu, Hf, Ta, W, Tl, Pb, Bi, Th, U
값은 문자열이며 검출한계 미만은 "< 5"와 같이 표기됩니다. 분석값이 없는 시료는 null
요청예시
https://data.kigam.re.kr/openapi/jeju-rock/AS93-8?key=인증키
{
  "sampleId": "AS93-8",
  "longitude": 126.798083,
  "latitude": 33.426241,
  "elevation": null,
  "collectionDate": null,
  "laboratory": "Actlabs",
  "provider": "제주특별자치도 세계유산본부 한라산연구부",
  "hasMajorElements": true,
  "hasTraceElements": false,
  "projected": { "crs": "EPSG:5186", "x": 181221.415, "y": 92541.851 },
  "thinSectionPhotos": {
    "planePolarized": "https://data.kigam.re.kr/mgeo/common/jejuRockPhoto.do?file=AS93-8(O).jpg",
    "crossPolarized": "https://data.kigam.re.kr/mgeo/common/jejuRockPhoto.do?file=AS93-8(X).jpg"
  },
  "majorElements": {
    "unit": "wt%",
    "values": { "SiO2": 50.18, "Al2O3": 16.12, "Fe2O3T": 12.16, "MnO": 0.155, "MgO": 5.13, "CaO": 7.42,
                "Na2O": 3.81, "K2O": 1.74, "TiO2": 2.356, "P2O5": 0.62, "LOI": -0.17, "Total": 99.52 }
  },
  "traceElements": null
}