WMS/WFS API 2.0 레퍼런스입니다.
WMS/WFS API 2.0 레퍼런스입니다.- 오픈플랫폼이 제공하는 다양한 종류의 공간정보를 제공합니다.
- 인증받은 키값과 함께 요청URL을 서버로 전송하면 WMS 1.3.0 / WFS 1.1.0 서비스를 사용하실 수 있습니다.
http://api.vworld.kr/req/wms?key=인증키&[WMS Param] |
---|
![]() 예) http://api.vworld.kr/req/wms?key=인증키&domain=인증받은도메인&[WMS Param] |
http://api.vworld.kr/req/wfs?key=인증키&[WFS Param] |
---|
![]() 예) http://api.vworld.kr/req/wfs?key=인증키&domain=인증받은도메인&[WFS Param] |
경계 : 광역시도, 리, 시군구, 읍면동 (4종)
공공안전 : 보행우선구역 (1종)
관광 : 관광안내소, 전통시장현황 (2종)
교통 : 교통CCTV, 교통노드, 교통링크 (3종)
국가지명 : 국가지명 (1종)
농업·농촌 : 농업진흥지역도, 수리시설, 영농여건불리농지도, 저수지 (4종)
도시계획 : 개발행위허가제한지역, 개발행위허가필지, 기반시설부담구역 등 (15종)
문화재 : 문화재보호도, 박물관미술관, 전통사찰보존 (3종)
문화예술 : 작은도서관 (1종)
사회복지 : 기타보호시설, 노인복지시설, 산후조리원, 아동복지시설, 아동안전지킴이집, 아이돌봄서비스기관 (6종)
산업 : 주요상권, 창업보육센터 (2종)
산업단지 : 단지경계, 단지시설용지, 단지용도지역, 단지유치업종 (4종)
수자원 : 대권역, 중권역, 표준권역, 하천망 (4종)
용도지역지구 : 개발제한구역, 개발진흥지구, 경관지구, 고도지구, 관리지역 등 (17종)
용도지역지구(기타) : 가축사육제한지역, 관광지, 국민임대주택, 급경사재해예방지역 등 (17종)
일반행정 : 도로명주소건물, 도로명주소도로, 무인발급기정보 (3종)
임업·산촌 : 산림입지도, 산지(보안림), 산지(자연휴양림), 산지(채종림) (4종)
자연 : 단층, 배수등급, 수문지질단위, 수질다이어그램, 심토토성, 유효토심, 자갈함량 등 (14종)
재난방재 : 산불위험예측지도, 소방서관할구역, 재해위험지구 (3종)
체육 : 국립자연공원, 군립자연공원, 도립자연공원, 등산로, 산책로, 자전거길, 자전거보관소 (7종)
토지 : 사업지구경계도, 연속지적도 (2종)
항공·공항 : (UA)초경량비행장치공역, 경계구역, 공중급유구역, 공중전투기동훈련장, 관제권 등 (21종)
해양·수산·어촌 : (1차)개발유도연안, (1차)개발조정연안, (1차)이용연안, (1차)절대보전연안 등 (27종)
환경보호 : 골프장현황도, 기타공동처리시설, 농공단지처리시설, 마을하수도 등 (16종)
파라미터 | 선택 | 설명 | 유효값 |
---|---|---|---|
service | O/1 | 요청 서비스명 | WMS(기본값) |
version | O/1 | 요청 서비스 버전 | 1.3.0(기본값) |
request | M/1 | 요청 서비스 오퍼레이션 | GetMap, GetCapabilities |
key | M/1 | 발급받은 api key | |
format | O/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: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(기본값) |
domain | O/1 | API KEY를 발급받을때 입력했던 URL * HTTPS,FLEX등 웹뷰어가 아닌 브라우저에서의 API사용은 DOMAIN을 추가하여 서비스를 이용할 수 있습니다. |
파라미터 | 선택 | 설명 | 유효값 |
---|---|---|---|
service | O/1 | 요청 서비스명 | WMS(기본값) |
version | O/1 | 요청 서비스 버전 | 1.3.0(기본값) |
key | M/1 | 발급받은 api key | |
layers | M/1 | 하나 또는 쉼표(,)로 분리된 지도레이어 목록, 최대 4개 | 레이어 목록 참고 |
styles | O/1 | LAYERS와 1대1 관계의 하나 또는 쉼표(,)로 분리된 스타일 목록 | 레이어 목록 참고 |
crs | O/1 | 응답결과 좌표계와 bbox 파라미터의 좌표계, 지원좌표계 | EPSG:4326(기본값) |
bbox | M/1 | 요청 객체의 Bounding box (xmin,ymin,xmax,ymax) |
예외) EPSG:4326, EPSG:5185, EPSG:5186, EPSG:5187, EPSG:5188 경우 (ymin,xmin,ymax,xmax) |
width | M/1 | 지도의 픽셀 너비 | 숫자 |
height | M/1 | 지도의 픽셀 너비 | 숫자 |
request | M/1 | 요청 서비스 오퍼레이션 | GetFeatueInfo |
query_layers | M/1 | 하나 또는 쉼표(,)로 분리된 지도레이어 목록 | 레이어 목록 참고 |
info_format | O/1 | 응답결과 포맷 | info_format 참조 |
feature_count | O/1 | 출력되는 피처의 최대 개수 | 기본값 : 1 |
i | M/1 | 지도상의 X좌표(왼쪽이 0) | |
j | M/1 | 지도상이 Y좌표(상단이 0) | |
exceptions | O/1 | 에러 응답결과 포맷 | text/xml(기본값) |
Format | Syntax |
---|---|
TEXT | info_format=text/plain(기본값) |
GML 2 | info_format=application/vnd.ogc.gml |
GML 3 | info_format=application/vnd.ogc.gml/3.1.1 |
HTML | info_format=text/html |
JSON | info_format=application/json |
JSONP | info_format=text/javascript |
- http://api.vworld.kr/req/wms?
- SERVICE=WMS&
- REQUEST=GetMap&
- VERSION=1.3.0&
- LAYERS=lp_pa_cbnd_bonbun,lp_pa_cbnd_bubun&
- STYLES=lp_pa_cbnd_bonbun_line,lp_pa_cbnd_bubun_line&
- CRS=EPSG:900913&
- BBOX=14133818.022824,4520485.8511757,14134123.770937,4520791.5992888&
- WIDTH=256&
- HEIGHT=256&
- FORMAT=image/png&
- TRANSPARENT=false&
- BGCOLOR=0xFFFFFF&
- EXCEPTIONS=text/xml&
- KEY=[KEY]&
- DOMAIN=[DOMAIN]
파라미터 | 선택 | 설명 | 유효값 |
---|---|---|---|
service | O/1 | 요청 서비스명 | WFS(기본값) |
version | O/1 | 요청 서비스 버전 | 1.1.0(기본값) |
request | M/1 | 요청 서비스 오퍼레이션 | GetFeature, GetCapabilities |
key | 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 응답 형식의 콜백 함수 이름을 지정합니다. ex) format_options=callback:func_callback |
기본값 : parseResponse |
exceptions | O/1 | 에러 응답결과 포맷 | text/xml(기본값) |
typename | M/1 | 하나 또는 쉼표(,)로 분리된 지도레이어 목록, 최대 4개 | 레이어 목록 참고 |
featureid | O/1 | 요청 FEATURE ID | |
bbox | M/1 | 요청 객체의 Bounding box | EPSG:4326일 경우 (ymin,xmin,ymax,xmax) , 그 외 (xmin,ymin,xmax,ymax) |
propertyname | O/1 | 하나 또는 쉼표(,)로 분리된 속성 목록 | |
maxfeatures | O/1 | 출력되는 피처의 최대 개수 | 숫자 기본값 : 1000, 최소값 : 1, 최대값 : 1000 |
sortby | O/1 | 정렬하고 싶은 속성명을 지정한다. 사용법 : PropertyName [A|D][,PropertyName [A|D],…], A는 오름차순, D는 내림차순에 사용한다. 예 제 : sortby=Field1 D,Field A |
입력값을 encodeURIComponent로 변환 후 요청 |
srsname | O/1 | 응답결과 좌표계와 bbox 파라미터의 좌표계, 지원좌표계 | EPSG:900913(기본값) |
domain | O/1 | API KEY를 발급받을때 입력했던 URL * HTTPS,FLEX등 웹뷰어가 아닌 브라우저에서의 API사용은 DOMAIN을 추가하여 서비스를 이용할 수 있습니다. |
|
filter | O/1 | WFS FILTER 1.1 Specification 참고 | 입력값을 encodeURIComponent로 변환 후 요청 |
- http://api.vworld.kr/req/wfs?
- SERVICE=WFS&
- REQUEST=GetFeature&
- TYPENAME=lt_c_uq111&
- BBOX=13987670,3912271,14359383,4642932&
- PROPERTYNAME=mnum,sido_cd,sigungu_cd,dyear,dnum,ucode,bon_bun,bu_bun,uname,sido_name,sigg_name,ag_geom&
- VERSION=1.1.0&
- MAXFEATURES=40&
- SRSNAME=EPSG:900913&
- OUTPUT=GML2&
- EXCEPTIONS=text/xml&
- KEY=[KEY]&
- DOMAIN=[DOMAIN]&
- FILTER=[WFS FILTER 1.1 참고]
- <ogc:Filter>
- <ogc:PropertyIsEqualTo matchCase="true">
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:PropertyIsEqualTo>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsNotEqualTo matchCase="true">
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:PropertyIsNotEqualTo>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsLessThan matchCase="false">
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:PropertyIsLessThan>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsLessThanOrEqualTo matchCase="false">
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:PropertyIsLessThanOrEqualTo>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsGreaterThan matchCase="true">
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:PropertyIsGreaterThan>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsGreaterThanOrEqualTo matchCase="false">
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:PropertyIsGreaterThanOrEqualTo>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsLike wildCard="*" singleChar="_" escapeChar="\">
- <ogc:PropertyName>sido_name</ogc:PropertyName>
- <ogc:Literal>서울*</ogc:Literal>
- </ogc:PropertyIsLike>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsNull>
- <ogc:PropertyName>remark</ogc:PropertyName>
- </ogc:PropertyIsLike>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:PropertyIsBetween>
- <ogc:PropertyName>dyear</ogc:PropertyName>
- <ogc:LowerBoundary>
- <ogc:Literal>2000</ogc:Literal>
- </ogc:LowerBoundary>
- <ogc:UpperBoundary>
- <ogc:Literal>2005</ogc:Literal>
- </ogc:UpperBoundary>
- </ogc:PropertyIsBetween>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:Intersects>
- <ogc:PropertyName>ag_geom</ogc:PropertyName>
- <Point srsName="EPSG:900913">
- <pos>14132768.287088 4494181.0225382</pos>
- </Point>
- </ogc:Intersects>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:BBOX>
- <ogc:PropertyName>ag_geom</ogc:PropertyName>
- <Envelope srsDimension="2" srsName="EPSG:900913">
- <lowerCorner>14132768.287088 4494181.0225382</lowerCorner>
- <upperCorner>14132777.841717 4494190.5771668</upperCorner>
- </Envelope>
- </ogc:BBOX>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:And>
- <ogc:PropertyIsEqualTo>
- <ogc:PropertyName>sigg_name</ogc:PropertyName>
- <ogc:Literal>안양시동안구</ogc:Literal>
- </ogc:PropertyIsEqualTo>
- <ogc:PropertyIsLessThan>
- <ogc:PropertyName>ucode</ogc:PropertyName>
- <ogc:Literal>UQA112</ogc:Literal>
- </ogc:PropertyIsLessThan>
- </ogc:And>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:Or>
- <ogc:PropertyIsGreaterThan>
- <ogc:PropertyName>ucode</ogc:PropertyName>
- <ogc:Literal>UQA113</ogc:Literal>
- </ogc:PropertyIsGreaterThan>
- <ogc:PropertyIsLessThan>
- <ogc:PropertyName>sigungu_cd</ogc:PropertyName>
- <ogc:Literal>174</ogc:Literal>
- </ogc:PropertyIsLessThan>
- </ogc:Or>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:Not>
- <ogc:PropertyIsEqualTo>
- <ogc:PropertyName>sigg_name</ogc:PropertyName>
- <ogc:Literal>종로구</ogc:Literal>
- </ogc:PropertyIsEqualTo>
- </ogc:Not>
- </ogc:Filter>
- <ogc:Filter>
- <ogc:And>
- <ogc:PropertyIsLessThan>
- <ogc:PropertyName>sigungu_cd</ogc:PropertyName>
- <ogc:Literal>174</ogc:Literal>
- </ogc:PropertyIsLessThan>
- <ogc:Intersects>
- <ogc:PropertyName>ag_geom</ogc:PropertyName>
- <Point srsName="EPSG:900913">
- <pos>14132768.287088 4494181.0225382</pos>
- </Point>
- </ogc:Intersects>
- </ogc:And>
- </ogc:Filter>
좌표계 | 설명 |
---|---|
WGS84 경위도 | EPSG:4326 |
GRS80 경위도 | EPSG:4019 |
Google Mercator | EPSG:3857, EPSG:900913 |
서부원점(GRS80) | EPSG:5180(50만), EPSG:5185 |
중부원점(GRS80) | EPSG:5181(50만), EPSG:5186 |
제주원점(GRS80, 55만) | EPSG:5182 |
동부원점(GRS80) | EPSG:5183(50만), EPSG:5187 |
동해(울릉)원점(GRS80) | EPSG:5184(50만), EPSG:5188 |
UTM-K(GRS80) | EPSG:5179 |
항목명 | 타입 | 설명 | |
---|---|---|---|
service | 문자 | 요청 서비스 정보 Root | |
name | 문자 | 요청 서비스명 | |
version | 숫자 | 요청 서비스 버전 | |
operation | 문자 | 요청 서비스 오퍼레이션 이름 | |
time | 숫자 | 응답결과 생성 시간 | |
status | 문자 | 처리 결과의 상태 표시, 유효값 : OK(성공), NOT_FOUND(결과없음), ERROR(에러) | |
error | 문자 | 에러 정보 Root | |
level | 숫자 | 에러 레벨 | |
code | 문자 | 에러 코드 | |
text | 문자 | 에러 메시지 |
코드 | 레벨 | 메세지 | 비고 |
---|---|---|---|
PARAM_REQUIRED | 1 | 필수 파라미터인 <%S1>가 없어서 요청을 처리할수 없습니다. | %S1 : 파라미터 이름 |
INVALID_TYPE | 1 |
<%S1> 파라미터 타입이 유효하지 않습니다.
유효한 파라미터 타입 : <%S2> 입력한 파라미터 값 : <%S3> |
%S1 : 파라미터 이름
%S2 : 유효한 파라미터 값의 유형 %S3 : 입력한 파라미터 값 |
INVALID_RANGE | 1 | <%S1> 파라미터의 값이 유효한 범위를 넘었습니다.
유효한 파라미터 타입 : <%S2> 입력한 파라미터 값 : <%S3> |
%S1 : 파라미터 이름
%S2 : 유효한 파라미터 값의 범위 %S3 : 입력한 파라미터 값 |
INVALID_KEY | 2 | 등록되지 않은 인증키입니다. |   |
INCORRECT_KEY | 2 | 인증키 정보가 올바르지 않습니다.
(ex. 인증키 발급 시 입력한 도메인이 다를경우) |
  |
UNAVAILABLE_KEY | 2 | 임시로 인증키를 사용할 수 없는 상태입니다. | |
OVER_REQUEST_LIMIT | 2 | 서비스 사용량이 일일 제한량을 초과하여 더 이상 서비스를 사용할 수 없습니다. | |
SYSTEM_ERROR | 3 | 시스템 에러가 발생하였습니다. | |
UNKNOWN_ERROR | 3 | 알 수 없는 에러가 발생하였습니다. |