사용안내
오픈API 소개
- 오픈플랫폼이 제공하는 배경지도 및 영상지도, 하이브리드 지도를 제공합니다.
- 요청 URL을 인증받은 키값과 함께 사용자의 소스로 추가하시면 사용하실 수 있습니다.
- OpenLayers 2.7 ~ 2.13 버전을 지원합니다.
-
공간 정보
발급 받은 인증키는 승인된 레이어에 한하여 사용하실 수 있습니다. - WMS (Web Map Service) 서비스는 지리 데이터에서 생성된 맵 이미지(png, jpeg, gif)를 활용할 수 있도록 합니다.
- WFS (Web Feature Service) 서비스는 (벡터 도형 및 속성을 지닌) 지리 피처 데이터를 활용할 수 있도록 합니다.
인증키 발급
- 오픈API서비스는 활용신청 절차를 통해 인증키 발급 후 이용하실 수 있습니다.
- 오픈API 활용신청은 데이터개방 > OpenAPI > 이용약관/인증키 에서 로그인 후 신청하실 수 있습니다.
- 발급 받은 인증키는 승인된 레이어에 한하여 사용하실 수 있습니다.
요청 URL 작성 예시
- 오픈API 요청 URL은 '서비스별 요청 URL' 과 '요청 항목' 을 결합하여 작성합니다.
- 서비스별로 사용되는 요청항목은 [요청항목] 탭을 참고하시고, serviceKey에는 오픈API 활용신청 후 발급받은 유효한 인증키를 입력하세요.
공간 정보
- https://www.nie-ecobank.kr/ecoapi/서비스별 요청 URL?serviceKey=인증키[&요청항목 =값]
서비스별 요청 URL
| 서비스명 | 상세기능명 | 요청 URL |
|---|---|---|
| 백두대간_곤충_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getInsectPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getInsectPointWFS | |
| 백두대간_식물상_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getFlrPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getFlrPointWFS | |
| 백두대간_식생_면 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getVtnPynWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getVtnPynWFS | |
| 백두대간_양서파충류_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getAmnrpPotinWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getAmnrpPotinWFS | |
| 백두대간_어류_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getFishesPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getFishesPointWFS | |
| 백두대간_저서무척추동물_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getBninPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getBninPointWFS | |
| 백두대간_조류_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getBirdsPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getBirdsPointWFS | |
| 백두대간_지의류_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getIchnPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getIchnPointWFS | |
| 백두대간_지형경관_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getTpscPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getTpscPointWFS | |
| 백두대간_포유류_점 | WMS 조회 | /ecoapi/BgtsInfoService/wms/getMmlPointWMS |
| WFS 조회 | /ecoapi/BgtsInfoService/wfs/getMmlPointWFS | |
| 생태계정밀조사_균류_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getFngsPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getFngsPointWFS | |
| 생태계정밀조사_생태계_조사_지역_면 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getEcsystmExaminAreaPynWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getEcsystmExaminAreaPynWFS | |
| 생태계정밀조사_식생_면 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getVtnPynWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getVtnPynWFS | |
| 생태계정밀조사_식생_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getVtnPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getVtnPointWFS | |
| 생태계정밀조사_양서파충류_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getAmnrpPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getAmnrpPointWFS | |
| 생태계정밀조사_어류 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getFishesPynWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getFishesPynWFS | |
| 생태계정밀조사_어류_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getFishesPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getFishesPointWFS | |
| 생태계정밀조사_저서무척추동물_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getBninPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getBninPointWFS | |
| 생태계정밀조사_조류_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getBirdsPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getBirdsPointWFS | |
| 생태계정밀조사_포유류_면 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getMmlPynWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getMmlPynWFS | |
| 생태계정밀조사_포유류_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getMmlPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getMmlPointWFS | |
| 생태정밀조사_곤충 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getInsectPynWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getInsectPynWFS | |
| 생태정밀조사_곤충_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getInsectPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getInsectPointWFS | |
| 생태정밀조사_식물상 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getFlrPynWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getFlrPynWFS | |
| 생태정밀조사_식물상_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getFlrPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getFlrPointWFS | |
| 자연환경조사_곤충_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getInsectPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getInsectPointWFS | |
| 자연환경조사_식물상_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getFlrPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getFlrPointWFS | |
| 자연환경조사_식생_면 | WMS 조회 | /ecoapi/NteeInfoService/wms/getVtnPynWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getVtnPynWFS | |
| 자연환경조사_양서파충류_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getAmnrpPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getAmnrpPointWFS | |
| 자연환경조사_어류_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getFishesPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getFishesPointWFS | |
| 자연환경조사_저서무척추동물_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getBninPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getBninPointWFS | |
| 자연환경조사_조류_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getBirdsPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getBirdsPointWFS | |
| 자연환경조사_지형경관 | WMS 조회 | /ecoapi/NteeInfoService/wms/getTpscPynWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getTpscPynWFS | |
| 자연환경조사_지형경관_선 | WMS 조회 | /ecoapi/NteeInfoService/wms/getTpscLineWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getTpscLineWFS | |
| 자연환경조사_포유류_점 | WMS 조회 | /ecoapi/NteeInfoService/wms/getMmlPointWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getMmlPointWFS | |
| 자연환경조사_해안_생물_선 | WMS 조회 | /ecoapi/NteeInfoService/wms/getBeachLvbLineWMS |
| WFS 조회 | /ecoapi/NteeInfoService/wfs/getBeachLvbLineWFS | |
| 생태계정밀조사_플랑크톤_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getPlnkPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getPlnkPointWFS | |
| 생태계정밀조사_생태계_조사_지역_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getEcsystmExaminAreaPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getEcsystmExaminAreaPointWFS | |
| 생태계정밀조사_지형경관_점 | WMS 조회 | /ecoapi/EcpeInfoService/wms/getTpscPointWMS |
| WFS 조회 | /ecoapi/EcpeInfoService/wfs/getTpscPointWFS |
요청항목
오픈API 서비스별 요청항목
OpenAPI 이용신청유효한 요청 URL의 구성을 위해 아래의 서비스별 요청항목 정보를 참고하여 요청 매개변수를 "요청항목=값"의 형태인 이름/값 쌍으로 추가하여야 합니다.
상세기능별로 존재하는 요청항목은 아래 서비스별 요청항목 화면에서 확인할 수 있습니다.
WMS 서비스 요청항목
| 요청항목 (EN) | 요청항목 (KR) | 항목크기 | 필수여부 | 샘플데이터 | 설명 |
|---|---|---|---|---|---|
| serviceKey | 인증키 | 100 | 필수 | 인증키 (URL Encode) | EcoBank에서 발급받은 인증키를 입력합니다. |
| layers | 레이어 목록 | 50 | 옵션 | tbl_opn_eczm | 화면에 표출할 레이어입니다. 값은 쉼표로 구분한 레이어명의 나열입니다. ([레이어 목록] 탭 참고) |
| srs | 좌표체계 | 20 | 필수 | EPSG:5186 | 좌표 체계를 나타냅니다. 중부원점(GRS80) EPSG:5186 좌표계를 지원합니다. |
| bbox | 크비 범위 | 50 | 필수 | 314548.9311225004 ,401742.29949240043 ,320867.0145135768 ,409072.0397406582 |
크기(extent)를 정의하는 범위(bounding box)입니다. 실수 4개가 쉼표로 구성됩니다. |
| width | 너비 | 4 | 필수 | 663 | 반환 이미지의 너비를 픽셀값으로 설정합니다.(1024 보다 클 경우 1024 적용) |
| height | 높이 | 4 | 필수 | 768 | 반환 이미지의 높이를 픽셀값으로 설정합니다.(1024 보다 클 경우 1024 적용) |
| format | 산출물 형식 | 20 | 옵션 | png | 반환 이미지 형식입니다. png, jpeg, gif 이미지 포맷을 지원합니다. |
| transparent | 투명 여부 | 5 | 옵션 | false | 반환 이미지의 배경이 투명한지 결정합니다. 값은 true 혹은 false로, 기본값은 false입니다. |
| bgcolor | 배경색 | 6 | 옵션 | 0xFFFFFF | 반환 이미지의 배경색을 결정합니다. 값은 0xRRGGBB 형태로, 기본값은 0xFFFFFF(흰색)입니다. |
| exceptions | 예외 보고 | 10 | 옵션 | BLANK | 예외 발생 시 처리 방법을 결정합니다. - BLANK: 빈 이미지 - XML[기본값 ]: 에러 코드, 이름, 설명 정보를 담은 xml - INIMAGE : 에러 정보가 포함된 이미지 |
WFS 서비스 요청항목
| 요청항목 | 요청항목 (국문) | 항목크기 | 필수여부 | 샘플데이터 | 설명 |
|---|---|---|---|---|---|
| serviceKey | 인증키 | 100 | 필수 | 인증키 (URL Encode) | EcoBank에서 발급받은 인증키를 입력합니다. |
| typeName | 피처 유형 목록 | 100 | 옵션 | tbl_opn_eczm | 질의 대상인 하나 이상의 피처 유형 이름의 리스트, 값은 쉼표로 구분한 이름의 나열입니다. ([레이어 목록] 탭 참고) |
| bbox | 검색 범위 | 50 | 옵션 | 314548.9311225004 ,401742.29949240043 ,320867.0145135768 ,409072.0397406582 |
좌표로 이루어진 사각형 안에 담겨 있는 (또는 부분적으로 걸쳐 있는) 피처를 검색합니다. 좌표 순서는 사용되는 좌표 시스템을 따름니다. 일반적 표현은 하단좌표, 상단좌표, 좌표체계 순서입니다. (lc1,lc2,uc1,uc2,좌표체계 ) |
| maxFeatures | 응답 최대값 | 10 | 옵션 | 10 | 요청에 대한 응답으로 WFS가 반환해야하는 피처의 최대 값입니다. (최대 허용값 : 500) |
레이어 목록
오픈API에서 제공하는 상세기능 레이어 목록을 아래에서 확인할 수 있습니다.
| 서비스명 | WMS 레이어명 | WFS 레이어명 | 레이어 한글명 |
|---|---|---|---|
| 생태계정밀조사_어류 | mv_map_ecpe_fishes_pyn | mv_map_ecpe_fishes_pyn | 생태계정밀조사_어류 |
| 생태정밀조사_곤충 | mv_map_ecpe_insect_pyn | mv_map_ecpe_insect_pyn | 생태정밀조사_곤충 |
| 생태정밀조사_식물상 | mv_map_ecpe_flr_pyn | mv_map_ecpe_flr_pyn | 생태정밀조사_식물상 |
| 자연환경조사_지형경관 | mv_map_ntee_tpsc_pyn | mv_map_ntee_tpsc_pyn | 자연환경조사_지형경관 |
| 백두대간_곤충_점 | mv_map_bgts_insect_point | mv_map_bgts_insect_point | 백두대간_곤충_점 |
| 백두대간_식물상_점 | mv_map_bgts_flr_point | mv_map_bgts_flr_point | 백두대간_식물상_점 |
| 백두대간_식생_면 | mv_map_bgts_vtn_pyn | mv_map_bgts_vtn_pyn | 백두대간_식생_면 |
| 백두대간_양서파충류_점 | mv_map_bgts_amnrp_point | mv_map_bgts_amnrp_point | 백두대간_양서파충류_점 |
| 백두대간_어류_점 | mv_map_bgts_fishes_point | mv_map_bgts_fishes_point | 백두대간_어류_점 |
| 백두대간_저서무척추동물_점 | mv_map_bgts_bnin_point | mv_map_bgts_bnin_point | 백두대간_저서무척추동물_점 |
| 백두대간_조류_점 | mv_map_bgts_birds_point | mv_map_bgts_birds_point | 백두대간_조류_점 |
| 백두대간_지의류_점 | mv_map_bgts_lchn_point | mv_map_bgts_lchn_point | 백두대간_지의류_점 |
| 백두대간_지형경관_점 | mv_map_bgts_tpsc_point | mv_map_bgts_tpsc_point | 백두대간_지형경관_점 |
| 백두대간_포유류_점 | mv_map_bgts_mml_point | mv_map_bgts_mml_point | 백두대간_포유류_점 |
| 생태계정밀조사_균류_점 | mv_map_ecpe_fngs_point | mv_map_ecpe_fngs_point | 생태계정밀조사_균류_점 |
| 생태계정밀조사_식생_면 | mv_map_ecpe_vtn_pyn | mv_map_ecpe_vtn_pyn | 생태계정밀조사_식생_면 |
| 생태계정밀조사_식생_점 | mv_map_ecpe_vtn_point | mv_map_ecpe_vtn_point | 생태계정밀조사_식생_점 |
| 생태계정밀조사_양서파충류_점 | mv_map_ecpe_amnrp_point | mv_map_ecpe_amnrp_point | 생태계정밀조사_양서파충류_점 |
| 생태계정밀조사_어류_점 | mv_map_ecpe_fishes_point | mv_map_ecpe_fishes_point | 생태계정밀조사_어류_점 |
| 생태계정밀조사_저서무척추동물_점 | mv_map_ecpe_bnin_point | mv_map_ecpe_bnin_point | 생태계정밀조사_저서무척추동물_점 |
| 생태계정밀조사_조류_점 | mv_map_ecpe_birds_point | mv_map_ecpe_birds_point | 생태계정밀조사_조류_점 |
| 생태계정밀조사_지형경관_점 | mv_map_ecpe_tpsc_point | mv_map_ecpe_tpsc_point | 생태계정밀조사_지형경관_점 |
| 생태계정밀조사_포유류_면 | mv_map_ecpe_mml_pyn | mv_map_ecpe_mml_pyn | 생태계정밀조사_포유류_면 |
| 생태계정밀조사_포유류_점 | mv_map_ecpe_mml_point | mv_map_ecpe_mml_point | 생태계정밀조사_포유류_점 |
| 생태계정밀조사_플랑크톤_점 | mv_map_ecpe_plnk_point | mv_map_ecpe_plnk_point | 생태계정밀조사_플랑크톤_점 |
| 생태정밀조사_곤충_점 | mv_map_ecpe_insect_point | mv_map_ecpe_insect_point | 생태정밀조사_곤충_점 |
| 생태정밀조사_식물상_점 | mv_map_ecpe_flr_point | mv_map_ecpe_flr_point | 생태정밀조사_식물상_점 |
| 자연환경조사_곤충_점 | mv_map_ntee_insect_point | mv_map_ntee_insect_point | 자연환경조사_곤충_점 |
| 자연환경조사_식물상_점 | mv_map_ntee_flr_point | mv_map_ntee_flr_point | 자연환경조사_식물상_점 |
| 자연환경조사_식생_면 | mv_map_ntee_vtn_pyn | mv_map_ntee_vtn_pyn | 자연환경조사_식생_면 |
| 자연환경조사_양서파충류_점 | mv_map_ntee_amnrp_point | mv_map_ntee_amnrp_point | 자연환경조사_양서파충류_점 |
| 자연환경조사_어류_점 | mv_map_ntee_fishes_point | mv_map_ntee_fishes_point | 자연환경조사_어류_점 |
| 자연환경조사_저서무척추동물_점 | mv_map_ntee_bnin_point | mv_map_ntee_bnin_point | 자연환경조사_저서무척추동물_점 |
| 자연환경조사_조류_점 | mv_map_ntee_birds_point | mv_map_ntee_birds_point | 자연환경조사_조류_점 |
| 자연환경조사_지형경관_선 | mv_map_ntee_tpsc_line | mv_map_ntee_tpsc_line | 자연환경조사_지형경관_선 |
| 자연환경조사_포유류_점 | mv_map_ntee_mml_point | mv_map_ntee_mml_point | 자연환경조사_포유류_점 |
| 자연환경조사_해안_생물_선 | mv_map_ntee_beach_lvb_line | mv_map_ntee_beach_lvb_line | 자연환경조사_해안_생물_선 |
| 생태계정밀조사_생태계_조사_지역_면 | mv_map_ecpe_ecsystm_examin_area_pyn | mv_map_ecpe_ecsystm_examin_area_pyn | 생태계정밀조사_생태계_조사_지역_면 |
| 생태계정밀조사_생태계_조사_지역_점 | mv_map_ecpe_ecsystm_examin_area_point | mv_map_ecpe_ecsystm_examin_area_point | 생태계정밀조사_생태계_조사_지역_점 |
샘플코드
조회 하실 샘플 코드 버튼을 클릭하세요