OpenAPI
Limited usage
OpenAPI for Geoscience Thematic Maps
| 맵 서버에서 생성된 지도 이미지 제공을 위해 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
|
지오빅데이터 오픈플랫폼을 통해 제공되는 데이터셋을 검색할 수 있습니다. 검색결과는 데이터셋의 간략정보를 제공하며, 테이터셋 조회 API를 통해 상세정보를 조회할 수 있습니다.
|
|---|
| Name | Description |
|---|---|
key |
발급된 인증키 |
| page | 페이지 번호 |
| size | 페이지당 출력건수 |
| q | 검색 키워드 |
지오빅데이터 오픈플랫폼을 통해 제공되는 데이터셋 상세정보를 조회할 수 있습니다.데이터셋 아이디는 데이터셋 식별자로 검색결과에서 response > content > id 항목의 값으로 확인할 수 있습니다.
|
|---|
| Name | Description |
|---|---|
key |
발급된 인증키 |
dataset_id |
데이터셋 아이디 |
지오빅데이터 오픈플랫폼을 통해 제공되는 데이터셋의 공개 파일 데이터를 다운로드 할 수 있습니다.파일 아이디는 파일 데이터 식별자로 조회결과에서 bundles > files > id 항목의 값으로 확인할 수 있습니다.
|
|---|
| Name | Description |
|---|---|
key |
발급된 인증키 |
file_id |
파일 아이디 |
|
제주도에서 채취한 암석시료의 분석정보(위치, 주원소·미량원소 분석 여부 등)를 검색할 수 있습니다. 검색결과는 시료의 간략정보를 제공하며, 제주도 암석시료 분석정보 조회 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
},
...
]
}
}
|
암석시료 한 건의 상세정보를 조회할 수 있습니다. 시료 기본정보와 함께 주원소(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
}