StaticMap API 2.0 레퍼런스
StaticMap API 2.0 레퍼런스입니다.소개
- StaticMap API는 자바스크립트에 의존하지 않고 오픈플랫폼의 배경지도 및 영상지도, 하이브리드 지도를 이용하여 위치표시 및 정보공유가 가능하도록 구현한 API입니다. 현재는 요청횟수에 제한은 없으나 API사용량 및 서버 과부하 여부에 따라 변동될수 있습니다.
요청형식
http://api.vworld.kr/req/image?service=image&request=getmap&key=인증키&[요청파라미터] |
---|
|
요청파라미터
파라미터 | 선택 | 설명 | 유효값 |
---|---|---|---|
service | O/1 | 요청 서비스명 | image(기본값) |
version | O/1 | 요청 서비스 버전 | 2.0(기본값) |
request | M/1 | 요청 서비스 오퍼레이션 | GetMap |
key | M/1 | 발급받은 api key | |
format | O/1 | 응답결과 포맷 | png(기본값), jpeg, bmp |
errorFormat | O/1 | 에러 응답결과 포맷 파라미터 값이 image일 경우 format 파라미터에 지정된 포맷으로 설정 |
json(기본값), xml, image, blank |
basemap | O/1 | 지도 유형 | NONE : 없음(흰배경) GRAPHIC(기본값) : 기본지도 GRAPHIC_GRAY : 회색지도 GRAPHIC_NIGHT : 야간지도 PHOTO : 영상지도 PHOTO_HYBRID : 영상시설물지도 |
center | M/1 | 지도 중심 좌표 | 포맷 : x,y |
crs | O/1 | center의 좌표계 | 지원좌표계표 참고, EPSG:4326(기본값) |
zoom | M/1 | 지도 줌 레벨 | 6 ~ 18 |
size | M/1 | 이미지 크기 | 포맷 : width,height 최대값 : 1024,1024 |
layers | O/n | 요청지도에 Overlay할 주제도의 목록 스타일은 브이월드에 정의되어 있는 스타일을 사용 |
WMS/WFS 레퍼런스 참고 |
styles | O/n | 레이어스타일 | WMS/WFS 레퍼런스 참고 |
marker | O/n | GetMap으로 Static Map 요청시 마커를 표시할 수 있음 [marker 서브 파라미터 참고] |
|
route | O/n | GetMap으로 Static Map 요청시 마커를 표시할 수 있음 [route 서브 파라미터 참고] |
marker 서브 파라미터
파라미터 | 선택 | 설명 | 유효값 |
---|---|---|---|
point | M/n | 마커의 포인트 좌표 | 포맷(WKT Style) : pointX1 pointY1[,pointX2 pointY2] |
label | O/1 | 마커의 라벨 | |
color | O/1 | 라벨 색상 예) color:rgb(255,0,0) | label이 있을 경우에만 유효 black(기본값), white, red, blue, green, rgb(r,g,b) |
font | O/1 | 라벨 글꼴 | label이 있을 경우에만 유효 |
size | O/1 | 라벨 크기(px) | label이 있을 경우에만 유효 |
image | O/1 | 마커의 이미지, 마커ID를 입력 예) image:img01 또는 image:img01s |
![]() |
- marker 예제1. 스타일이 같은 마커들 : 한 개의 marker 파라미터로 여러 개의 포인트를 표현하여 처리
- marker=point:x1 y1, x2 y2,x3 y3|label:마커라벨테스트|color:blue|image:img01
- marker 예제2. 스타일이 다른 마커들 : 여러 개의 marker 파라미터로 각각의 포인트를 표현하여 처리
- marker=point:x1 y1, x2 y2|label:마커라벨테스트|color:red&marker=point:x3 y3|label:마커라벨테스트2|color:blue|image:img01
route 서브 파라미터
파라미터 | 선택 | 설명 | 유효값 |
---|---|---|---|
point | M/n | 경로의 포인트 좌표 | 포맷(WKT Style) : pointX1 pointY1,pointX2 pointY2[,pointX3 pointY3] |
color | O/1 | 선 색상 예) color:rgb(255,0,0) | black(기본값), white, red, blue, green, rgb(r,g,b) |
width | O/1 | 선 너비 | |
style | O/1 | 선 패턴 | solid(기본값), dash, dot, dashdot, dashdotdot, longdash, longdashdot |
- route 예제1. 스타일이 같은 경로들 : 한 개의 route 파라미터로 여러 개의 포인트를 표현하여 처리
- route=point:x1 y1, x2 y2, x3 y3|color:red|width:1|style:dot
- route 예제2. 스타일이 다른 경로들 : 여러 개의 route 파라미터로 각각의 포인트를 표현하여 처리
- route=point:x1 y1, x2 y2, x3 y3|color:red|width:1|style:dot&route=point:x4 y4, x5 y5|color:blue|width:3|style:solid
지원좌표계
좌표계 | 설명 |
---|---|
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 | 알 수 없는 에러가 발생하였습니다. |
사용예제