사용안내
오픈API 소개
속성 정보
속성정보에 대한 데이터를 외부에서 활용할 수 있도록 XML 또는 JSON 형태로 데이터를 제공하는 API서비스입니다.
공간 정보
OGC(Open Geospatial Consortium)가 제정한 표준 프로토콜을 이용해 지리공간 정보를 두 가지 형태의 API서비스를 제공합니다.
▪ WMS (Web Map Service) 서비스는 지리 데이터에서 생성된 맵 이미지(png, jpeg, gif)를 활용할 수 있도록 합니다.
▪ WFS (Web Feature Service) 서비스는 (벡터 도형 및 속성을 지닌) 지리 피처 데이터를 활용할 수 있도록 합니다.
인증키 발급
오픈API서비스는 활용신청 절차를 통해 인증키 발급 후 이용하실 수 있습니다.
오픈API 활용신청은 공공데이터포털(www.data.go.kr)을 통해 하실 수 있습니다.
공공데이터포털로 이동하여 국가중점데이터 > 생태·자연도 평가정보 > 오픈API 에서 로그인 후 신청하실 수 있습니다.
요청 URL 작성 예시
오픈API 요청 URL은 '서비스별 요청 URL' 과 '요청 항목' 을 결합하여 작성합니다.
서비스별로 사용되는 요청항목은 [요청항목] 탭을 참고하시고, serviceKey에는 오픈API 활용신청 후 발급받은 유효한 인증키를 입력하세요.
속성 정보
서비스 결과는 XML 또는 JSON 형식으로 받을 수 있고, 아래 예시처럼 원하는 응답 결과의 출력 방식을 지정할 수 있습니다.
type 요청항목를 이용하여 원하는 응답 결과의 출력 방식을 지정하며, 응답 결과의 출력 방식을 지정하지 않으면 xml 형식이 기본 적용됩니다.
▪ JSON 형식 : http://apis.data.go.kr/B553084/서비스별 요청 URL?type=json&serviceKey=인증키 [&요청항목=값 ]
▪ XML 형식 : http://apis.data.go.kr/B553084/서비스별 요청 URL?type=xml&serviceKey=인증키 [&요청항목=값 ]
공간 정보
▪ http://apis.data.go.kr/B553084/서비스별 요청 URL?serviceKey=인증키 [&요청항목=값 ]
서비스별 요청 URL
| 서비스명 | 상세기능명 | 요청 URL |
|---|---|---|
| 생태·자연도 | WMS 조회 | ecoapi/EcologyzmpService/wms/getEcologyzmpWMS |
| WFS 조회 | ecoapi/EcologyzmpService/wfs/getEcologyzmpWFS | |
| 속성 조회 | ecoapi/EcologyzmpService/attr/getEcologyzmpAttr | |
| 식생평가 | WMS 조회 | ecoapi/ActvnmapService/wms/getActvnmapWMS |
| WFS 조회 | ecoapi/ActvnmapService/wfs/getActvnmapWFS | |
| 속성 조회 | ecoapi/ActvnmapService/attr/getActvnmapAttr | |
| 습지평가 | WMS 조회 | ecoapi/SmldevalService/wms/getSmldevalWMS |
| WFS 조회 | ecoapi/SmldevalService/wfs/getSmldevalWFS | |
| 속성 조회 | ecoapi/SmldevalService/attr/getSmldevalAttr | |
| 지형평가 | WMS 조회 | ecoapi/TpgrphevalService/wms/getTpgrphevalWMS |
| WFS 조회 | ecoapi/TpgrphevalService/wfs/getTpgrphevalWFS | |
| 속성 조회 | ecoapi/TpgrphevalService/attr/getTpgrphevalAttr |
요청항목
오픈API 서비스별 요청항목
유효한 요청 URL의 구성을 위해 아래의 서비스별 요청항목 정보를 참고하여 요청 매개변수를 "요청항목=값"의 형태인 이름/값 쌍으로 추가하여야 합니다.
상세기능별로 존재하는 요청항목은 아래 서비스별 요청항목 화면에서 확인할 수 있습니다.
WMS 서비스 요청항목
| 요청항목 | 필수여부 | 샘플데이터 | 설명 |
|---|---|---|---|
| serviceKey | 필수 | 인증키 (URL Encode) | 공공데이터포털에서 발급받은 인증키를 입력합니다. |
| layers | 옵션 | tbl_opn_eczm | 화면에 표출할 레이어입니다. 값은 쉼표로 구분한 레이어명의 나열입니다. ([레이어 목록] 탭 참고) |
| srs | 필수 | EPSG:5186 | 좌표 체계를 나타냅니다. 중부원점(GRS80) EPSG:5186 좌표계를 지원합니다. |
| bbox | 필수 | 314548.9311225004 ,401742.29949240043 ,320867.0145135768 ,409072.0397406582 |
크기(extent)를 정의하는 범위(bounding box)입니다. 실수 4개가 쉼표로 구성됩니다. |
| width | 필수 | 663 | 반환 이미지의 너비를 픽셀값으로 설정합니다.(1024 보다 클 경우 1024 적용) |
| height | 필수 | 768 | 반환 이미지의 높이를 픽셀값으로 설정합니다.(1024 보다 클 경우 1024 적용) |
| format | 옵션 | png | 반환 이미지 형식입니다. png, jpeg, gif 이미지 포맷을 지원합니다. |
| transparent | 옵션 | false | 반환 이미지의 배경이 투명한지 결정합니다. 값은 true 혹은 false로, 기본값은 false입니다. |
| bgcolor | 옵션 | 0xFFFFFF | 반환 이미지의 배경색을 결정합니다. 값은 0xRRGGBB 형태로, 기본값은 0xFFFFFF(흰색)입니다. |
| exceptions | 옵션 | BLANK | 예외 발생 시 처리 방법을 결정합니다. - BLANK: 빈 이미지 - XML[기본값 ]: 에러 코드, 이름, 설명 정보를 담은 xml - INIMAGE : 에러 정보가 포함된 이미지 |
WFS 서비스 요청항목
| 요청항목 | 필수여부 | 샘플데이터 | 설명 |
|---|---|---|---|
| serviceKey | 필수 | 인증키 (URL Encode) | 공공데이터포털에서 발급받은 인증키를 입력합니다. |
| typeName | 옵션 | tbl_opn_eczm | 질의 대상인 하나 이상의 피처 유형 이름의 리스트, 값은 쉼표로 구분한 이름의 나열입니다. ([레이어 목록] 탭 참고) |
| bbox | 옵션 | 314548.9311225004 ,401742.29949240043 ,320867.0145135768 ,409072.0397406582 |
좌표로 이루어진 사각형 안에 담겨 있는 (또는 부분적으로 걸쳐 있는) 피처를 검색합니다. 좌표 순서는 사용되는 좌표 시스템을 따름니다. 일반적 표현은 하단좌표, 상단좌표, 좌표체계 순서입니다. (lc1,lc2,uc1,uc2,좌표체계 ) |
| maxFeatures | 옵션 | 10 | 요청에 대한 응답으로 WFS가 반환해야하는 피처의 최대 값입니다. (최대 허용값 : 500) |
| eczmGr | 옵션 | 2 | 평가등급 코드(1: 1등급, 2: 2등급, 3: 3등급)로 서비스별로 요청항목명이 상이합니다. - 생태·자연도 : eczmGr - 식생평가 : vtnEvlGr - 습지평가 : smldEvlGr - 지형평가 : tpgEvlGr |
| ctprvnCd | 옵션 | 47 | 시도 코드(법정동코드 10자리 중 2자리에 해당하는 시도[2] 코드) 시군구/읍면동 코드 입력시 시도 코드는 입력하실 필요가 없습니다. |
| signguCd | 옵션 | 47190 | 시군구 코드(법정동코드 10자리 중 5자리에 해당하는 시도[2]+시군구[3] 코드) 읍면동 코드 입력시 시군구 코드는 입력하실 필요가 없습니다. |
| emdCd | 옵션 | 47190250 | 읍면동 코드(법정동코드 10자리 중 8자리에 해당하는 시도[2]+시군구[3]+읍면동[3] 코드) |
속성 서비스 요청항목
| 요청항목 | 필수여부 | 샘플데이터 | 설명 |
|---|---|---|---|
| serviceKey | 필수 | 인증키 (URL Encode) | 공공데이터포털에서 발급받은 인증키를 입력합니다. |
| numOfRows | 옵션 | 10 | 한 페이지의 결과 수입니다.(기본값 : 10) |
| pageNo | 옵션 | 1 | 페이지 번호 입니다.(기본값 : 1) |
| type | 옵션 | xml | 응답결과의 출력 방식입니다. 값은 xml 또는 json 으로 기본값은 xml 입니다. |
| eczmGr | 옵션 | 2 | 평가등급 코드(1: 1등급, 2: 2등급, 3: 3등급)로 서비스별로 요청항목명이 상이합니다. - 생태·자연도 : eczmGr - 식생평가 : vtnEvlGr - 습지평가 : smldEvlGr - 지형평가 : tpgEvlGr |
| ctprvnCd | 필수 | 47 | 시도 코드(법정동코드 10자리 중 2자리에 해당하는 시도[2] 코드) 시군구/읍면동 코드 입력시 시도 코드는 입력하실 필요가 없습니다. |
| signguCd | 필수 | 47190 | 시군구 코드(법정동코드 10자리 중 5자리에 해당하는 시도[2]+시군구[3] 코드) 읍면동 코드 입력시 시군구 코드는 입력하실 필요가 없습니다. |
| emdCd | 필수 | 47190250 | 읍면동 코드(법정동코드 10자리 중 8자리에 해당하는 시도[2]+시군구[3]+읍면동[3] 코드) |
레이어 목록
오픈API에서 제공하는 상세기능 레이어 목록을 아래에서 확인할 수 있습니다.
| 서비스명 | WMS 레이어명 | WFS 레이어명 | 레이어 한글명 |
|---|---|---|---|
| 생태·자연도 | tbl_opn_eczm | tbl_opn_eczm | 개방_생태자연도 |
| 식생평가 | tbl_opn_vtn_evl | tbl_opn_vtn_evl | 개방_식생_평가 |
| 습지평가 | tbl_opn_smld_evl | tbl_opn_smld_evl | 개방_습지_평가 |
| 지형평가 | tbl_opn_tpgrph_evl | tbl_opn_tpgrph_evl | 개방_지형_평가 |
샘플코드
조회 하실 샘플 코드 버튼을 클릭하세요