API

소개

WMS(Web Map Service)와 WFS(Web Feature Service)를 통해 고품질의 공간정보 서비스를 제공합니다.
인증된 키를 사용하여 요청 URL를 서버에 전송하면 WMS 1.3.0 / WFS 1.1.0 서비스를 활용하실 수 있습니다.

WMTS(Web Map Tile Service)를 통해 고품질의 배경지도를 제공합니다.
인증된 키를 사용하여 요청 URL를 서버에 전송하면 WMTS 서비스를 활용하실 수 있습니다.

API 사용요청

WMS 요청 URL

https://climate.gg.go.kr/ols/api/geoserver/wms?apiKey={인증키}&[WMS Param]
WMS 파라미터
파라미터 선택 설명 유효값
service 0/1 요청 서비스명 WMS(기본값)
version 0/1 요청 서비스 버전 1.3.0(기본값)
request M/1 요청 서비스 오퍼레이션 GetMap, GetCapabilities
apiKey M/1 발급받은 API Key
format 0/1 응답결과 포맷 image/png(기본값)
exceptions O/1 에러 응답결과 포맷 text/xml(기본값)
layers M/1 하나 또는 쉼표(,)로 분리된 지도레이어 목록, 최대 4개 레이어 목록 참고
styles O/1 LAYERS와 1대1 관계의 하나 또는 쉼표(,)로 분리된 스타일 목록 레이어 목록 참고
bbox M/1 요청 객체의 Bounding box
(xmin,ymin,xmax,ymax)
예외) EPSG:4326, EPSG:3857, EPSG:5185, EPSG:5186, EPSG:5187, EPSG:5188 경우 (ymin,xmin,ymax,xmax) 		예외 좌표계는 순서 변경
width M/1 지도의 픽셀 너비 숫자
height M/1 지도의 픽셀 높이 숫자
transparent O/1 지도 배경의 투명도 여부 TRUE, FALSE(기본값)
bgcolor O/1 배경색 정의부 0xFFFFFF(기본값)
crs O/1 응답결과 좌표계와 bbox 파라미터의 좌표계, 지원좌표계 EPSG:4326(기본값)

WMS 요청 예제 URL

https://climate.gg.go.kr/ols/api/geoserver/wms?
REQUEST=GetMap&SERVICE=WMS&VERSION=1.3.0&FORMAT=image%2Fpng&STYLES=&TRANSPARENT=TRUE&LAYERS=spggcee%3A{레이어명}&TILED=true&CRS=EPSG%3A3857
&apiKey={인증키}&FORMAT_OPTIONS=dpi%3A68&WIDTH=192&HEIGHT=192&BBOX=14098656.993144188%2C4490828.2858106755%2C14108440.93276469%2C4500612.225431178

WFS 요청 URL

https://climate.gg.go.kr/ols/api/geoserver/wfs?apiKey={인증키}&[WFS Param]
WFS 파라미터
파라미터 선택 설명 유효값
service O/1 요청 서비스명 WFS(기본값)
version O/1 요청 서비스 버전 1.1.0(기본값)
request M/1 요청 서비스 오퍼레이션 GetFeature, GetCapabilities
apiKey M/1 발급받은 API Key
output O/1 응답결과 포맷
* output=text/javascript는 JSONP를 반환		 text/xml; subtype=gml/2.1.2(기본값), GML2, text/xml; subtype=gml/3.1.1, GML3, application/json, text/javascript
format_options O/1 jsonp 응답 형식의 콜백 함수 이름을 지정합니다. 예: format_options=callback:func_callback, 기본값: parseResponse
exceptions O/1 에러 응답결과 포맷 text/xml(기본값)
typename M/1 하나 또는 쉼표(,)로 분리된 지도레이어 목록, 최대 4개 레이어 목록 참고
featureid O/1 요청 FEATURE ID
bbox O/1 요청 객체의 Bounding box EPSG:4326일 경우 (ymin,xmin,ymax,xmax), 그 외 (xmin,ymin,xmax,ymax)
propertyname O/1 하나 또는 쉼표(,)로 분리된 속성 목록
maxfeatures O/1 출력되는 피처의 최대 개수
* version=1.0.0일 때 사용 가능		 숫자, 기본값: 1000, 최소값: 1, 최대값: 1000
count O/1 출력되는 피처의 최대 개수
* version=2.0.0일 때 사용 가능		 숫자, 기본값: 1000, 최소값: 1, 최대값: 1000
startindex O/1 출력되는 피처의 시작지점 설정
* version=2.0.0일 때 사용 가능		 예: startindex=10 → 11번째 피처부터 출력
sortby O/1 정렬하고 싶은 속성명을 지정
사용법: PropertyName [A|D][,PropertyName [A|D],…], A=오름차순, D=내림차순 		예: sortby=Field1 D,FieldA (encodeURIComponent 사용)
srsname O/1 응답결과 좌표계 및 bbox 좌표계 EPSG:900913(기본값)
filter O/1 WFS FILTER 1.1 Specification 참고 POST 요청으로 Body에 filter XML(하단 "WFS 요청 예제 URL" 메뉴 예제 XML 참고)을 담아서 요청

WFS 요청 예제 URL

[GET] https://climate.gg.go.kr/ols/api/geoserver/wfs?
apiKey={인증키}&service=WFS&version=1.1.0&request=GetFeature&typeName=spggcee%3A{레이어명}&outputFormat=application/json
[POST] https://climate.gg.go.kr/ols/api/geoserver/wfs?apiKey={인증키}
<wfs:GetFeature service="WFS" version="1.1.0" xmlns:wfs="http://www.opengis.net/wfs" xmlns:ogc="http://www.opengis.net/ogc" xmlns:gml="http://www.opengis.net/gml"> <wfs:Query typeName="spggcee:vgmap"> <ogc:Filter> <ogc:PropertyIsEqualTo> <ogc:PropertyName>uid</ogc:PropertyName> <ogc:Literal>구리_362</ogc:Literal> </ogc:PropertyIsEqualTo> </ogc:Filter> </wfs:Query> </wfs:GetFeature>

WMTS 요청 URL

https://climate.gg.go.kr/ols/api/geoserver/wmts?apiKey={인증키}&url=/rest/{레이어명}/EPSG:3857/{z}/{y}/{x}
WMTS 파라미터
파라미터 선택 설명 유효값
url M/1 WMTS 요청 URL (/rest/{레이어명}/EPSG:3857/{z}/{y}/{x}) TIFF 서비스 영문명 사용
apiKey M/1 발급받은 API Key

WMTS 요청 예제 URL

https://climate.gg.go.kr/ols/api/geoserver/wmts?apiKey={인증키}&url=/rest/spggcee:rst_soil_cbn_strgat/EPSG:3857/12/1588/3496

서비스 대상(총92종)

서비스 대상

레이어리스트 상세보기

레이어리스트 상세보기
구분 한글명칭 WMS명 WFS명 비고