바로가기 메뉴
본문내용 바로가기
메인메뉴 바로가기
닫기
오픈API

Static Map API 2.0 레퍼런스

Static Map API 2.0 레퍼런스입니다.
소개
  • Static Map API는 자바스크립트에 의존하지 않고 오픈플랫폼의 배경지도 및 영상지도, 하이브리드 지도를 이용하여 위치표시 및 정보공유가 가능하도록 구현한 API입니다. 현재는 요청횟수에 제한은 없으나 API사용량 및 서부 과부하 여부에 따라 변동될수 있습니다.
요청형식
요청형식
http://api.vworld.kr/req/image?service=image&request=getmap&key=인증키&[요청파라미터]
  • Get 방식 요청

  • IE 브라우저 주소창으로 요청시는 브라우저 자체의 문자열 제한으로 2000자 까지만 요청할수 있습니다.

  • IE 이외의 브라우저는 문자열 제한이 없습니다.

  • HTML IMG 태크의 src 경로를 이용할시에는 모든 브라우저에서 문자열 제한이 없습니다.

요청파라미터
요청파라미터
파라미터 선택 설명 유효값
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 응답결과 좌표계 지원좌표계표 참고,
EPSG:4326(기본값)
zoom M/1 지도 줌 레벨 6 ~ 18
size M/1 이미지 크기 포맷 : width,height
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 서브 파라미터
marker 서브 파라미터
파라미터 선택 설명 유효값
point M/n 마커의 포인트 좌표 포맷(WKT Style) : pointX1 pointY1[,pointX2 pointY2]
label O/1 마커의 라벨
color O/1 라벨 색상 label이 있을 경우에만 유효
font O/1 라벨 글꼴 label이 있을 경우에만 유효
size O/1 라벨 크기(px) label이 있을 경우에만 유효
image O/1 마커의 이미지 URL
http://를 제외한 URL만 입력
map.vworld.kr/images/maps/marker.png(기본값)
  • marker 예제1. 스타일이 같은 마커들 : 하나의 marker 파라미터로 여러개의 포인트를 표현하여 처리
  • marker=point:x1 y1, x2 y2,x3 y3|label:마커라벨테스트|color:blue|image:map.vworld.kr/images/maps/marker.png
  •  
  • marker 예제2. 스타일이 다른 마커들 : 여러개의 marker 파라미터로 각각의 포인트를 표현하여 처리
  • marker=point:x1 y1, x2 y2|label:마커라벨테스트|color:red&marker=point:x3 y3|label:마커라벨테스트2|color:blue|image:map.vworld.kr/images/maps/marker.png
route 서브 파라미터
route 서브 파라미터
파라미터 선택 설명 유효값
point M/n 경로의 포인트 좌표 포맷(WKT Style) : pointX1 pointY1,pointX2 pointY2[,pointX3 pointY3]
color O/1 선 색상
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 등록되지 않은 인증키입니다.  
UNAVAILABLE_KEY 2 임시로 인증키를 사용할 수 없는 상태입니다.  
OVER_REQUEST_LIMIT 2 서비스 사용량이 일일 제한량을 초과하여 더 이상 서비스를 사용할 수 없습니다.  
SYSTEM_ERROR 3 시스템 에러가 발생하였습니다.  
UNKNOWN_ERROR 3 알 수 없는 에러가 발생하였습니다.  
사용예제
맨위로