로딩중
You will be automatically logged out after 60 seconds.


In order to use the site safely, if you do not use the site for 20 minutes, you will be automatically logged out.

To extend the login time, click the [Extend Login] button.
EcoBank > Data & Resources > Open API > OpenAPI Guide

User Guide

OpenAPI Introduction

  • Open platform provides background and video map and hybrid map.
  • You can use the request URL by adding it as your source along with the certified key value.
  • Supports OpenLaysers 2.7 through 2.13.
  • Spatial Information

    The issued authentication key can only be used on approved layers.
  • WMS (Web Map Service) service enables you to utilize map images (png, jpeg, gif) generated from geographic data.
  • WFS (Web Feature Service) service allows you to utilize geographic feature data (with vector shapes and attributes).


Authorization key request

  • OpenAPI service is available after issuing the authentication key through the application process.
  • You can apply for open API utilization by logging in from the Data Open > OpenAPI > Terms of Use/Certification Key.
  • The issued authentication key can only be used on approved layers.



Example of creating a request URL

  • OpenAPI request URL is created by combining 'request URL by service' and 'request item'.
  • Refer to the Request Items tab for the requested item by service, and enter a valid authentication key issued after applying for the service key.

Spatial Information

  • https://www.nie-ecobank.kr/ecoapi/Request by Service URL?serviceKey=Authentication Key[&Request Item=Value]


Request by Service URL

Request by Service URL 목록 - 서비스명, 상세기능명, 요청 URL로 구성
Service Details Function Request URL
백두대간_곤충_점 WMS Check /ecoapi/BgtsInfoService/wms/getInsectPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getInsectPointWFS
백두대간_식물상_점 WMS Check /ecoapi/BgtsInfoService/wms/getFlrPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getFlrPointWFS
백두대간_식생_면 WMS Check /ecoapi/BgtsInfoService/wms/getVtnPynWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getVtnPynWFS
백두대간_양서파충류_점 WMS Check /ecoapi/BgtsInfoService/wms/getAmnrpPotinWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getAmnrpPotinWFS
백두대간_어류_점 WMS Check /ecoapi/BgtsInfoService/wms/getFishesPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getFishesPointWFS
백두대간_저서무척추동물_점 WMS Check /ecoapi/BgtsInfoService/wms/getBninPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getBninPointWFS
백두대간_조류_점 WMS Check /ecoapi/BgtsInfoService/wms/getBirdsPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getBirdsPointWFS
백두대간_지의류_점 WMS Check /ecoapi/BgtsInfoService/wms/getIchnPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getIchnPointWFS
백두대간_지형경관_점 WMS Check /ecoapi/BgtsInfoService/wms/getTpscPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getTpscPointWFS
백두대간_포유류_점 WMS Check /ecoapi/BgtsInfoService/wms/getMmlPointWMS
WFS Check /ecoapi/BgtsInfoService/wfs/getMmlPointWFS
생태계정밀조사_균류_점 WMS Check /ecoapi/EcpeInfoService/wms/getFngsPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getFngsPointWFS
생태계정밀조사_생태계_조사_지역_면 WMS Check /ecoapi/EcpeInfoService/wms/getEcsystmExaminAreaPynWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getEcsystmExaminAreaPynWFS
생태계정밀조사_식생_면 WMS Check /ecoapi/EcpeInfoService/wms/getVtnPynWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getVtnPynWFS
생태계정밀조사_식생_점 WMS Check /ecoapi/EcpeInfoService/wms/getVtnPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getVtnPointWFS
생태계정밀조사_양서파충류_점 WMS Check /ecoapi/EcpeInfoService/wms/getAmnrpPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getAmnrpPointWFS
생태계정밀조사_어류 WMS Check /ecoapi/EcpeInfoService/wms/getFishesPynWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getFishesPynWFS
생태계정밀조사_어류_점 WMS Check /ecoapi/EcpeInfoService/wms/getFishesPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getFishesPointWFS
생태계정밀조사_저서무척추동물_점 WMS Check /ecoapi/EcpeInfoService/wms/getBninPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getBninPointWFS
생태계정밀조사_조류_점 WMS Check /ecoapi/EcpeInfoService/wms/getBirdsPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getBirdsPointWFS
생태계정밀조사_포유류_면 WMS Check /ecoapi/EcpeInfoService/wms/getMmlPynWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getMmlPynWFS
생태계정밀조사_포유류_점 WMS Check /ecoapi/EcpeInfoService/wms/getMmlPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getMmlPointWFS
생태정밀조사_곤충 WMS Check /ecoapi/EcpeInfoService/wms/getInsectPynWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getInsectPynWFS
생태정밀조사_곤충_점 WMS Check /ecoapi/EcpeInfoService/wms/getInsectPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getInsectPointWFS
생태정밀조사_식물상 WMS Check /ecoapi/EcpeInfoService/wms/getFlrPynWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getFlrPynWFS
생태정밀조사_식물상_점 WMS Check /ecoapi/EcpeInfoService/wms/getFlrPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getFlrPointWFS
자연환경조사_곤충_점 WMS Check /ecoapi/NteeInfoService/wms/getInsectPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getInsectPointWFS
자연환경조사_식물상_점 WMS Check /ecoapi/NteeInfoService/wms/getFlrPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getFlrPointWFS
자연환경조사_식생_면 WMS Check /ecoapi/NteeInfoService/wms/getVtnPynWMS
WFS Check /ecoapi/NteeInfoService/wfs/getVtnPynWFS
자연환경조사_양서파충류_점 WMS Check /ecoapi/NteeInfoService/wms/getAmnrpPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getAmnrpPointWFS
자연환경조사_어류_점 WMS Check /ecoapi/NteeInfoService/wms/getFishesPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getFishesPointWFS
자연환경조사_저서무척추동물_점 WMS Check /ecoapi/NteeInfoService/wms/getBninPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getBninPointWFS
자연환경조사_조류_점 WMS Check /ecoapi/NteeInfoService/wms/getBirdsPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getBirdsPointWFS
자연환경조사_지형경관 WMS Check /ecoapi/NteeInfoService/wms/getTpscPynWMS
WFS Check /ecoapi/NteeInfoService/wfs/getTpscPynWFS
자연환경조사_지형경관_선 WMS Check /ecoapi/NteeInfoService/wms/getTpscLineWMS
WFS Check /ecoapi/NteeInfoService/wfs/getTpscLineWFS
자연환경조사_포유류_점 WMS Check /ecoapi/NteeInfoService/wms/getMmlPointWMS
WFS Check /ecoapi/NteeInfoService/wfs/getMmlPointWFS
자연환경조사_해안_생물_선 WMS Check /ecoapi/NteeInfoService/wms/getBeachLvbLineWMS
WFS Check /ecoapi/NteeInfoService/wfs/getBeachLvbLineWFS
생태계정밀조사_플랑크톤_점 WMS Check /ecoapi/EcpeInfoService/wms/getPlnkPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getPlnkPointWFS
생태계정밀조사_생태계_조사_지역_점 WMS Check /ecoapi/EcpeInfoService/wms/getEcsystmExaminAreaPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getEcsystmExaminAreaPointWFS
생태계정밀조사_지형경관_점 WMS Check /ecoapi/EcpeInfoService/wms/getTpscPointWMS
WFS Check /ecoapi/EcpeInfoService/wfs/getTpscPointWFS

Request Item

OpenAPI Request by Service Topics

Request OpenAPI

To configure a valid request URL, the request parameter must be added as a name/value pair, which is in the form of "request item=value" by referring to the requested item information below.
The requested items that exist by service capability can be found on the Request by Service item screen below.



WMS Service Request Item

Request Item(EN) Request Item(KR) Item Size Required Status Sample Data Explanation
serviceKey 인증키 100 Essential Authentication Key(URL Encode) EcoBank에서 발급받은 인증키를 입력합니다.
layers 레이어 목록 50 Option tbl_opn_eczm The layer to be displayed on the screen.
The value is a comma-separated list of layer names. (See the [List of Layers] tab)
srs 좌표체계 20 Essential EPSG:5186 Indicates the coordinate system.
Central Point (GRS80) EPSG:5186 Coordinate Systems are supported.
bbox 크비 범위 50 Essential 314548.9311225004
,401742.29949240043
,320867.0145135768
,409072.0397406582
This is the bounding box that defines the extent.
Four real numbers consist of commas.
width 너비 4 Essential 663 Set the width of the return image to the pixel value (Apply 1024 if it is greater than 1024).
height 높이 4 Essential 768 Set the Height of the return image to the pixel value (Apply 1024 if it is greater than 1024).
format 산출물 형식 20 Option png Return image format.
It supports png, jpeg, and gif image formats.
transparent 투명 여부 5 Option false Determines whether the background of the return image is transparent.
The value is true or false, and the default is false.
bgcolor 배경색 6 Option 0xFFFFFF Determines the background color of the return image.
The value is in the form 0xRRGGBB, the default is 0xFFFFFF (white).
exceptions 예외 보고 10 Option BLANK Determines how to handle exceptions when they occur.
- BLANK: Blank Image
- XML[Default]: xml containing error code, name, and description information
- INIMAGE : Image with error information

WFS Service Request Item

Request Item Request Item(국문) 항목크기 Required Status Sample Data Explanation
serviceKey 인증키 100 Essential Authentication Key(URL Encode) EcoBank에서 발급받은 인증키를 입력합니다.
typeName 피처 유형 목록 100 Option tbl_opn_eczm A list of the names of one or more feature types being queried,
the values are a comma-separated list of names. (See the [List of layers] tab)
bbox 검색 범위 50 Option 314548.9311225004
,401742.29949240043
,320867.0145135768
,409072.0397406582
Search for features contained within (or partially across) a rectangle of coordinates.
Coordinate order follows the coordinate system used.
The general representation is the order of lower coordinates, upper coordinates, and coordinate system.
(lc1,lc2,uc1,uc2,Coordinate system)
maxFeatures 응답 최대값 10 Option 10 The maximum value of features that WFS should return in response to the request. (Maximum Allowable Value : 500)

List of Layers

You can find a list of top-of-the-line layers available from OpenAPI below.


Service WMS Layer WFS Layer Layer Korean Name
생태계정밀조사_어류 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 생태계정밀조사_생태계_조사_지역_점

Sample Code

Click the sample code button to inquire.