브이월드란?	오픈플랫폼?
연혁/로드맵
제공데이터
운영기구소개
서비스소개	지도 소개
오픈API 소개
데이터정보 소개
참여 소개
3D데스크톱 소개
커뮤니티매핑 소개
활용사례	활용사례
공모전 수상작
정책	이용약관
개인정보처리방침
이메일무단수집거부
사이트맵

브이월드란?

서비스소개

데이터정보 소개

참여 소개

활용사례

정책

지도보기	WebGL지도 보기
영문지도 보기
사용방법	사용방법안내
오류해결방안
설치방법	플러그인 설치
최소/권장사양

지도보기

사용방법

설치방법

오픈API	오픈API안내
2D지도 API레퍼런스
3D지도 API레퍼런스
배경지도 API레퍼런스
WMS/WFS API레퍼런스
WMTS/TMS API 레퍼런스
데이터 API레퍼런스
지도검색 API레퍼런스
Static Map API레퍼런스
2D모바일 API레퍼런스
3D모바일 API레퍼런스
3D데스크톱 API레퍼런스
인증키	인증키발급
인증키관리
제한사용초과요청
활용	인기 활용 사례
전체 활용 검색
나의 활용
정책	오픈API 이용약관

오픈API

인증키

활용

서비스소개	참여란?
개인 참여방법
참여지도	내참여
개인참여
정책	운영정책

서비스 소개	데이터정보 소개
운영정책
법적고지
데이터 검색	등록자료 조회
나의 관심자료 조회
등록자료 갱신 조회
스토리지 서비스	스토리지서비스 안내
공간정보 현황 관리
공간정보 등록
공간정보 등록 이력 조회
서비스 URL 관리
오류신고	절차안내
나의 오류신고

소개	3D데스크톱 이란?
다운로드	다운로드
최소권장사양
설치/삭제안내
출시노트
사용방법 안내	지도 조작법안내
기본 사용법(2.0)안내
기본 사용법(3.0)안내

서비스소개	커뮤니티란?
커뮤니티 참여방법
운영정책	운영정책
커뮤니티 참여	커뮤니티참여

알림마당	공지사항
FAQ
Q&A
나의 Q&A
자료실
공간정보소식
건의사항
나의 건의사항

배경지도 API 1.0 레퍼런스

배경지도 API 1.0 레퍼런스입니다.

소개

오픈플랫폼이 제공하는 배경지도 및 영상지도, 하이브리드 지도를 제공합니다.
요청URL을 인증받은 키값과 함께 사용자 클라이언트에 Javascript 소스로 추가하시면 사용하실 수 있습니다.
OpenLayers 2.7 ~ 2.13버전을 지원합니다.

요청 URL

요청 URL
http://map.vworld.kr/js/apis.do?type=Base&apiKey=인증키
https나 Flex 등 웹뷰어가 아닌 브라우저에서의 API사용은 요청URL에 도메인정보를 추가하여 서비스를 이용합니다. 예) http://map.vworld.kr/js/apis.do?type=Base&apiKey=인증키&domain=인증받은도메인

서비스대상

서비스대상
배경지도	생성자
배경지도	vworld.Layers.Base
영상지도	vworld.Layers.Satellite
하이브리드지도	vworld.Layers.Hybrid
Gray지도	vworld.Layers.Gray
Midnight지도	vworld.Layers.Midnight

오류메세지

오류메세지
오류메세지	오류 설명
인증키 누락 및 오류	등록되지 않은 API Key입니다.
인증URL 불일치	API Key와 URL이 일치하지 않습니다.

사용예제

<html xmlns="http://www.w3.org/1999/xhtml">
							  <head>
								<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
								<title>2DMap</title>
								<script src="https://map.vworld.kr/js/map/OpenLayers-2.13/OpenLayers-2.13.js"></script>
								<script src="https://map.vworld.kr/js/apis.do?type=Base&apiKey=5616CAD1-5D79-3EE3-87D5-878A4AD0F91F"></script>
								 
								<script>
								  var map;
									var mapBounds = new OpenLayers.Bounds(123 , 32, 134 , 43);
									var mapMinZoom = 7;
									var mapMaxZoom = 19;

// avoid pink tiles
									OpenLayers.IMAGE_RELOAD_ATTEMPTS = 3;
									OpenLayers.Util.onImageLoadErrorColor = "transparent";
									
									function init(){
									var options = {
										controls: [],
										projection: new OpenLayers.Projection("EPSG:900913"),
										displayProjection: new OpenLayers.Projection("EPSG:4326"),
										units: "m",
										controls : [],
										numZoomLevels:21,
										maxResolution: 156543.0339,
										maxExtent: new OpenLayers.Bounds(-20037508.34, -20037508.34, 20037508.34, 20037508.34)
										};
									map = new OpenLayers.Map('map', options);
									
									var options = {serviceVersion : "",
										layername: "",
										isBaseLayer: false,
										opacity : 1,
										type: 'png',
										transitionEffect: 'resize',
										tileSize: new OpenLayers.Size(256,256),
										min_level : 7,
										max_level : 18,
										buffer:0};
									//======================================
									//1. 배경지도 추가하기
									vBase = new vworld.Layers.Base('VBASE');
									if (vBase != null){map.addLayer(vBase);}
									//2. 영상지도 추가하기
									vSAT = new vworld.Layers.Satellite('VSAT');
									if (vSAT != null) {map.addLayer(vSAT);};
									//3. 하이브리드지도 추가하기
									vHybrid = new vworld.Layers.Hybrid('VHYBRID');
									if (vHybrid != null) {map.addLayer(vHybrid);} 
									//4. Gray지도 추가하기
									vGray = new vworld.Layers.Gray('VGRAY');
									if (vGray != null){map.addLayer(vGray);}
									//5. Midnight지도 추가하기
									vMidnight = new vworld.Layers.Midnight('VMIDNIGHT');
									if (vMidnight != null){map.addLayer(vMidnight);}
									//===========================================

var switcherControl = new OpenLayers.Control.LayerSwitcher();
									map.addControl(switcherControl);
									switcherControl.maximizeControl();

map.zoomToExtent( mapBounds.transform(map.displayProjection, map.projection ) );
									map.zoomTo(11);
										
									map.addControl(new OpenLayers.Control.PanZoomBar());
									//map.addControl(new OpenLayers.Control.MousePosition());
									map.addControl(new OpenLayers.Control.Navigation());
									//map.addControl(new OpenLayers.Control.MouseDefaults()); //2.12 No Support
									map.addControl(new OpenLayers.Control.Attribution({separator:" "}))
								}
							   function deleteLayerByName(name){
									for (var i=0, len=map.layers.length; i<len; i++) {
										var layer = map.layers[i];
										if (layer.name == name) {
											map.removeLayer(layer);
											//return layer;
											break;
										}
									}
								}
								
								</script>
								<style> 
									.olControlAttribution{right:20px;}
									.olControlLayerSwitcher{right:20px; top:20px;}
								</style>
							  </head>
							  <body onload="init()">
								<div id="map" style="height:600px;"></div>
								<div >
									<button type="button" onclick="javascript:deleteLayerByName('VHYBRID');" name="rpg_1" >레이어삭제하기</button>
								</div>		   
							  </body>
							</html>

예제파일 다운로드 예제파일 미리보기

브이월드

로그인

포털

지도

오픈API

참여

데이터정보

3D데스크톱

커뮤니티

알림마당

오픈API

배경지도 API 1.0 레퍼런스

브이월드