WEB JS

웹 개발, 어플리케이션에서 활용될 수 있도록 Javascript로 제공되는 지도 플랫폼 입니다.

routo.maps.Circle

Description

원형 공간정보입니다. (예제)

Constructor

new routo.maps.Circle(circleOptions)

Example

const map = new routo.maps.Map('map', {
   center: { lat: 37.507009, lng: 127.0586339 }, // 지도 초기 위치
   zoom: 15, // 지도 로딩 시 최초 표시 레벨
   maxZoom: 19, // 지도의 최대 표시 레벨
   minZoom: 7, // 지도의 최소 표시 레벨
   enableRotation: true, // 지도의 회전 여부
   keyboardShortcuts: true, // 키보드 단축키 사용 여부
   isFractionalZoomEnabled: false, // 확대/축소 시 고정 축척레벨이 아닌 축척으로 이동 허용 여부
   restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
 });

 let circle = new routo.maps.Circle({
   center: { lat: 37.507009, lng: 127.0406339 },
   radius: 200, 
 });
 circle.setMap(map);

Parameters

Name {Type} Description
circleOptions { Object } 원 옵션입니다.
Properties
Name {Type} Description
center { Object } 원 중심점의 좌표입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
map { routo.maps.Map } Routo Map 객체입니다.
radius { number } 반지름입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.

Extends

Methods

addListener(eventName, handler)

Descript

이벤트를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명 입니다.
handler { function } 이벤트 처리 함수 입니다.
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역 입니다.

Type
LatLngBounds
getCenter() → {Object}

Descript

원의 중심좌표(경위도)를 반환합니다.

Returns

원의 중심 좌표(경위도)

Type
Object
getDraggable() → {boolean}

Descript

드래그 가능 여부 값을 반환합니다.

Returns

가능여부 입니다.

Type
boolean
getEditable() → {boolean}

Descript

편집 가능 여부 값을 반환합니다.

Returns

편집 가능 여부입니다.

Type
boolean
getMap() → {Map}

Descript

Routo Map 객체를 반환합니다.

Returns

Routo Map 객체 입니다.

Type
Map
getRadius() → {number}

Descript

반지름을 반환합니다.

Returns

반지름 입니다.

Type
number
setCenter()

Descript

원의 중심좌표(경위도)를 설정합니다.

setClickable(clickable)

Descript

클릭 가능 여부를 설정합니다.

Parameters

Name {Type} Description
clickable { boolean } 클릭 가능 여부 입니다.
setDraggable(draggable)

Descript

드래그 가능 여부를 설정합니다.

Parameters

Name {Type} Description
draggable { boolean } 드래그 가능 여부 입니다.
setEditable(editable)

Descript

편집 가능 여부를 설정합니다.

Parameters

Name {Type} Description
editable { boolean } 편집 가능 여부입니다.
setMap(map)

Descript

Routo Map 객체를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo Map 객체 입니다.
setOptions(circleOptions)

Descript

그리기(원)에 대한 옵션을 재설정합니다.

Parameters

Name {Type} Description
circleOptions { Object } 그리기(원) 옵션
Properties
Name {Type} Description
center { Object } 원 중심점의 좌표입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
map { routo.maps.Map } Routo Map 객체입니다.
radius { number } 반지름입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
setRadius(radius)

Descript

반지름을 설정합니다.

Parameters

Name {Type} Description
radius { number } 반지름 입니다.
setVisible(visible)

Descript

표시 여부를 설정합니다.

Parameters

Name {Type} Description
visible { boolean } 표시 여부 입니다.
setZIndex(zIndex)

Descript

위상 값을 설정합니다.

Parameters

Name {Type} Description
zIndex { number } 위상입니다.

routo.maps.data.Data

Description

공간 객체를 표시하는 레이어 클래스입니다. 사용자의 점형, 선형, 면형 데이터를 지도에 표시할 수 있습니다. Data는 Features의 집합 객체입니다. (예제)
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.Data(options, opt)

Example

// Map 생성시 기본적으로 Data를 가지고 있습니다.
const myMap = new routo.maps.Map("map", {
  center: { lat: 37.507009, lng: 127.0586339 }, // 지도 초기 위치
  zoom: 15, // 지도 로딩 시 최초 표시 레벨
  maxZoom: 19, // 지도의 최대 표시 레벨
  minZoom: 7, // 지도의 최소 표시 레벨
  enableRotation: true, // 지도의 회전 여부
  keyboardShortcuts: true, // 키보드 단축키 사용 여부
  isFractionalZoomEnabled: true, // 확대/축소 시 고정 축척레벨이 아닌 축척으로 이동 허용 여부
  restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
});
 
// 점형 Feature 생성
const latLng = new routo.maps.LatLng({ lat: 37.507009, lng: 127.0586339 });
const point = new routo.maps.Data.Point(latLng);
point.forEachLatLng((lngLat) => {
  console.log(lngLat.lng());
});
console.log(point.get());

// Data에 점형 Feature 추가
const feature = map.data.add(
  new routo.maps.Data.Feature({
    geometry: point,
    id: 1,
  })
);

Parameters

Name {Type} Description
options { Object } 데이터 옵션입니다.
Properties
Name {Type} Description
map { routo.maps.Map } Routo 지도 입니다.
controlPosition { Object } 기능 위치입니다.
controls { Array.<string> } 기능 목록 입니다.
drawingMode { string } 그리기 모드 입니다.
featureFactory { Object } 공간객체 팩토리 입니다.
style { Object } 스타일입니다.

Extends

Methods

add(feature, opt)

Descript

공간객체를 추가합니다. 공간객체에 id 가 지정되어 있고 Data에 해당 ID가 존재하는 경우, 해당 객체를 교체합니다. 빈 공간 객체를 추가하면 공간 정보(Geometry), 속성(Properties) 모두 null인 신규 공간 객체가 추가됩니다.

Parameters

Name {Type} Description
feature { Object } 공간객체 입니다.
Properties
Name {Type} Description
geometry { Object } 공간정보입니다. ("Point", "MultiPoint", "LineString", "MultiLineString", "LinearRing", "Polygon", "MultiPolygon", "GeometryCollection")
id { number|string } 아이디입니다.
properties { Object } 속성 목록입니다. 키-값 형태로 저장된 속성을 지정할 수 있습니다.
addGeoJson(geoJson, options, opt) → {Array.<Feature>}

Descript

GeoJSON 에 포함된 공간객체 목록을 추가합니다. GeoJSON 객체는 좌표계, 공간객체 목록등을 포함하는 정보의 자바스크립트 객체입니다.

Parameters

Name {Type} Description
geoJson { Object } GeoJSON 객체입니다.
options { Object } GeoJSON 속성입니다.
Properties
Name {Type} Description
idPropertyName { string } 아이디로 사용할 속성명입니다.

Returns

공간객체 목록입니다.

Type
Array.<Feature>
contains(feature) → {boolean}

Descript

공간객체가 목록에 포함되어 있는지 여부를 확인합니다.

Parameters

Name {Type} Description
feature { routo.maps.data.Feature } 공간객체 입니다.

Returns

공간객체 포함 여부 입니다.

Type
boolean
forEach(callback)

Descript

지정한 콜백 함수를 각 공간객체를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백 함수입니다.
getFeatureById(id) → {Feature|undefined}

Descript

아이디로 공간 객체를 가져옵니다.

Parameters

Name {Type} Description
id { number|string } 아이디 입니다.

Returns

공간객체 입니다.

Type
Feature | undefined
getMap() → {Map}

Descript

Routo 지도를 가져옵니다.

Returns

Routo 지도입니다.

Type
Map
getStyle() → {StylingFunction|StyleOptions}

Descript

스타일을 가져옵니다.

Returns

스타일 옵션을 반환하는 함수 또는 스타일 옵션입니다.

Type
StylingFunction | StyleOptions
loadGeoJson(url, options, callback)

Descript

GeoJson 을 반환하는 주소를 호출하여 공간객체 목록을 추가합니다.

Parameters

Name {Type} Description
url { string } GeoJson 주소입니다.
options { Object } GeoJson 옵션입니다.
Properties
Name {Type} Description
idPropertyName { string } 아이디로 사용할 속성명입니다.
callback { function } 콜백 함수입니다.
overrideStyle(feature, style)

Descript

공간객체에 스타일을 적용합니다. Data 에 적용된 스타일보다 우선 적용됩니다.

Parameters

Name {Type} Description
feature { routo.maps.data.Feature } 공간 객체 입니다.
style { Object } 스타일 옵션입니다.
Properties
Name {Type} Description
clickable { boolean } 선택 가능 여부 입니다.
fillColor { string } 채우기 색상 입니다.
fillOpacity { number } 채우기 투명도 입니다.
icon { Object } 아이콘 입니다.
Properties
Name {Type} Description
url { string } 주소입니다.
anchor { routo.maps.Point } 지도에서 마커의 위치에 따라 이미지를 고정할 위치입니다. 위치를 설정하는 경우 왼쪽 상단 모서리를 기준으로 픽셀 단위로 위치를 설정할 수 있습니다. 기본 값은 하단 중앙입니다.
labelOrigin { routo.maps.Point } 레이블의 원점입니다. 중앙 하단을 기준으로 픽섹 단위로 위치를 설정할 수 있습니다. Icon을 사용하는 경우에 레이블은 항상 왼쪽 상단 모서리가 기준이 되므로 labelPosition을 반드시 지정해줘서 위치를 설정해주어야 합니다.
origin { routo.maps.Point } 원점입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자할때 기준이 되는 픽셀입니다.
scale { number } 원본 이미지 대비 표시할 이미지의 비율입니다. 기본 값은 1이며 원본 크기로 표시됩니다. 0.5로 지정하는 경우 원래 크기에 절반 크기로 2로 지정하는 경우 원래 크기의 두 배로 표시됩니다.
size { routo.maps.Size } 이미지의 크기입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자 할때 이미지의 크기입니다.
label { Object } 라벨 입니다.
Properties
Name {Type} Description
text { string } 텍스트입니다.
color { string } 글자색입니다. 기본값은 "#000000" 입니다.
fontFamily { string } 글꼴입니다. 기본값은 "YD_YGO540" 입니다.
fontSize { string } 글자 크기입니다. 기본값은 "14px" 입니다.
fontWeight { string } 글자 굵기입니다. 기본값은 "normal" 입니다.
opacity { number } 점형 공간객체 적용되는 투명도입니다. 0.0 ~ 1.0 사이에 값으로 지정 가능합니다.
strokeColor { string } 테두리 색상 입니다.
strokeOpacity { number } 테두리 투명도 입니다.
strokeWeight { number } 테두리 두께 입니다.
title { string } 점형 공간객체에 표시할 제목입니다. 마우스 오버 시 표현됩니다.
visible { boolean } 표시 여부 입니다.
zIndex { number } 위상입니다. 높을 수록 위에 표시됩니다. 기본값은 3000입니다.
remove(feature)

Descript

공간 객체를 삭제합니다.

Parameters

Name {Type} Description
feature { routo.maps.data.Feature } 삭제할 공간객체 입니다.
revertStyle(feature, opt)

Descript

공간 객체에 적용되어 있는 스타일을 제거하여 Data 의 스타일을 적용합니다. feature 을 지정하지 않는 경우 전체 공간객체의 스타일을 제거합니다.

Parameters

Name {Type} Description
feature { routo.maps.data.Feature } 공간 객체 입니다.
setMap(map)

Descript

Routo 지도를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo 지도입니다.
setStyle(style)

Descript

스타일을 설정합니다.

Parameters

Name {Type} Description
style { Object } 스타일 옵션을 반환하는 함수 또는 스타일 옵션입니다.
toGeoJson(callback)

Descript

GeoJson 객체로 변환합니다.

Parameters

Name {Type} Description
callback { function } 콜백 함수입니다.

routo.maps.data.Feature

Description

공간객체 입니다. (예제)
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.Feature(options, opt)

Example

const options = {
  geometry: new routo.maps.data.Geometry(),
  id: 1,
  properties: {}
};
const feature = new routo.maps.data.Feature(options);

Parameters

Name {Type} Description
options { Object } 공간객체 옵션입니다.
Properties
Name {Type} Description
geometry { Object } 공간정보입니다. ("Point", "MultiPoint", "LineString", "MultiLineString", "LinearRing", "Polygon", "MultiPolygon", "GeometryCollection")
id { number|string } 아이디입니다.
properties { Object } 속성 목록입니다. 키-값 형태로 저장된 속성을 지정할 수 있습니다.

Extends

Methods

addListener(eventName, handler) → {MapsEventListener|null}

Descript

리스너를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명 입니다.
handler { function } 이벤트 처리 함수 입니다.

Returns

지도 이벤트 리스너입니다.

Type
MapsEventListener | null
forEachProperty(callback)

Descript

지정한 콜백 함수를 각 속성을 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백 함수 입니다.
getGeometry() → {Geometry}

Descript

공간정보를 가져옵니다.

Returns

공간정보입니다.

Type
Geometry
getId() → {string}

Descript

아이디를 가져옵니다.

Returns

아이디 입니다.

Type
string
getProperty(name) → {*}

Descript

속성을 가져옵니다.

Parameters

Name {Type} Description
name { string } 속성명 입니다.

Returns

속성 값입니다.

Type
*
removeProperty(name)

Descript

속성을 삭제합니다.

Parameters

Name {Type} Description
name { string } 속성명 입니다.
setGeometry(geometry)

Descript

공간정보를 설정합니다.

Parameters

Name {Type} Description
geometry { Object } 공간정보입니다.
setProperty(name, newValue)

Descript

속성을 설정합니다.

Parameters

Name {Type} Description
name { string } 속성명 입니다.
newValue { * } 새로운 속성 값입니다.
toGeoJson(callback)

Descript

GeoJSON 객체로 변환합니다.

Parameters

Name {Type} Description
callback { function } 콜백 함수 입니다.

routo.maps.data.GeometryCollection

Description

공간정보 콜렉션입니다.
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.GeometryCollection(elements)

Example

const latLng = new routo.maps.LatLng({ lat: 37.507009, lng: 127.0586339 });
const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const innerCoords1 = [
  { lat: 37.497009, lng: 127.0686339 }, // north west
  { lat: 37.492009, lng: 127.0686339 }, // south west
  { lat: 37.492009, lng: 127.0786339 }, // south east
  { lat: 37.497009, lng: 127.0786339 }, // north east
];
const point = new routo.maps.Data.Point(latLng);
const polygon = new routo.maps.Data.Polygon([outerCoords, innerCoords1]);
const collection = [point, polygon];
const geomCollection = new routo.maps.data.GeometryCollection(collection);

Parameters

Name {Type} Description
elements { Object } 공간정보 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<Geometry>}

Descript

면형 공간정보 목록을 가져옵니다.

Returns

공간정보 목록입니다.

Type
Array.<Geometry>
getAt(n) → {Geometry}

Descript

지정한 위치의 면형 공간정보를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치 입니다.

Returns

면형 공간정보입니다.

Type
Geometry
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역

Type
LatLngBounds
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

공간정보 타입입니다.

Type
string

routo.maps.data.LinearRing

Description

선형 링 공간정보입니다. 선형 링은 닫혀있는 선형 공간정보를 말합니다. 닫혀 있다는 의미는 첫 경위도와 마지막 경위도가 같다는 것을 의미합니다.
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.LinearRing(elements)

Example

const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const linearRing = new routo.maps.Data.LinearRing(outerCoords);

Parameters

Name {Type} Description
elements { Object } 경위도 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<LatLng>}

Descript

경위도 목록을 가져옵니다.

Returns

경위도 목록입니다.

Type
Array.<LatLng>
getAt(n) → {LatLng}

Descript

지정한 위치의 경위도를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치 입니다.

Returns

경위도 입니다.

Type
LatLng
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역 입니다.

Type
LatLngBounds
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

선형 링입니다.

Type
string

routo.maps.data.LineString

Description

선형 공간정보입니다. 경위도 좌표 목록을 포함합니다. (예제)
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.LineString(elements)

Example

const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const lineString = new routo.maps.Data.LineString(outerCoords);

Parameters

Name {Type} Description
elements { Object } 경위도 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<LatLng>}

Descript

경위도 목록을 가져옵니다.

Returns

경위도 목록입니다.

Type
Array.<LatLng>
getAt(n) → {LatLng}

Descript

지정한 위치의 경위도를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치

Returns

경위도 입니다.

Type
LatLng
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역 입니다.

Type
LatLngBounds
getLatLngByFraction(fraction) → {LatLng}

Descript

제공된 분수 위치의 좌표를 가져옵니다. 분수는 0~1로 지정가능합니다. 예를 들어 중심 지점을 가져올려면 0.5를 지정하면 됩니다.

Parameters

Name {Type} Description
fraction { number } 분수 입니다.

Returns

좌표 입니다.

Type
LatLng
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

선형 입니다.

Type
string

routo.maps.data.MultiLineString

Description

다중 선형 공간정보입니다. 선형 공간정보 목록을 포함합니다.
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.MultiLineString(elements)

Example

const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const innerCoords1 = [
  { lat: 37.497009, lng: 127.0686339 }, // north west
  { lat: 37.492009, lng: 127.0686339 }, // south west
  { lat: 37.492009, lng: 127.0786339 }, // south east
  { lat: 37.497009, lng: 127.0786339 }, // north east
];
const multiLineString = new routo.maps.Data.MultiLineString([
  outerCoords,
  innerCoords1,
]);

Parameters

Name {Type} Description
elements { Object } 선형 공간정보 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<LineString>}

Descript

선형 공간정보 목록을 가져옵니다.

Returns

선형 공간 목록입니다.

Type
Array.<LineString>
getAt(n) → {LineString}

Descript

지정한 위치의 선형 공간정보를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치 입니다.

Returns

선형 공간정보입니다.

Type
LineString
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역 입니다.

Type
LatLngBounds
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

다중 선형 입니다.

Type
string

routo.maps.data.MultiPoint

Description

다중 점형 공간정보입니다. 경위도 좌표 목록을 포함합니다.
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.MultiPoint(elements)

Example

const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const multiPoint = new routo.maps.Data.MultiPoint(outerCoords);

Parameters

Name {Type} Description
elements { Object } 경위도 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<LatLng>}

Descript

경위도 목록을 가져옵니다.

Returns

경위도 목록입니다.

Type
Array.<LatLng>
getAt(n) → {LatLng}

Descript

지정한 위치의 경위도를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치입니다.

Returns

경위도 입니다.

Type
LatLng
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역입니다.

Type
LatLngBounds
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

다중 점형 입니다.

Type
string

routo.maps.data.MultiPolygon

Description

다중 면형 공간정보입니다. 면형 공간정보 목록을 포함합니다.
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.MultiPolygon(elements)

Example

const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const innerCoords1 = [
  { lat: 37.497009, lng: 127.0686339 }, // north west
  { lat: 37.492009, lng: 127.0686339 }, // south west
  { lat: 37.492009, lng: 127.0786339 }, // south east
  { lat: 37.497009, lng: 127.0786339 }, // north east
];
const multiPolygon = new routo.maps.Data.MultiPolygon([
  [outerCoords, innerCoords1],
  [innerCoords1],
]);

Parameters

Name {Type} Description
elements { Object } 면형 공간정보 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<Polygon>}

Descript

면형 공간정보 목록을 가져옵니다.

Returns

면형 공간정보 목록입니다.

Type
Array.<Polygon>
getAt(n) → {Polygon}

Descript

지정한 위치의 면형 공간정보를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치입니다.

Returns

면형 공간정보입니다.

Type
Polygon
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역입니다.

Type
LatLngBounds
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

다중면형 입니다.

Type
string

routo.maps.data.Point

Description

점형 공간정보입니다. 한 개의 경위도 좌표를 포함합니다. (예제)
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.Point(latLng)

Example

const latLng = new routo.maps.LatLng({ lat: 37.507009, lng: 127.0586339 });
const point = new routo.maps.data.Point(latLng);

Parameters

Name {Type} Description
latLng { Object } 경위도 좌표입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
get() → {LatLng}

Descript

경위도를 가져옵니다.

Returns

경위도 입니다.

Type
LatLng
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역입니다.

Type
LatLngBounds
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

점형입니다.

Type
string

routo.maps.data.Polygon

Description

면형 공간정보입니다. 면형 공간정보 목록을 포함합니다. 첫번째 면형 공간정보는 면의 외부 영역을 의미하며 다음 면형 공간정보는 면 내부 비어있는 영역을 의미합니다. (예제)
"<script src="https://api.routo.com/v2/maps/js/data.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.Polygon(elements)

Example

const outerCoords = [
  { lat: 37.507009, lng: 127.0586339 }, // north west
  { lat: 37.487009, lng: 127.0586339 }, // south west
  { lat: 37.487009, lng: 127.0886339 }, // south east
  { lat: 37.507009, lng: 127.0886339 }, // north east
];
const innerCoords1 = [
  { lat: 37.497009, lng: 127.0686339 }, // north west
  { lat: 37.492009, lng: 127.0686339 }, // south west
  { lat: 37.492009, lng: 127.0786339 }, // south east
  { lat: 37.497009, lng: 127.0786339 }, // north east
];
const polygon = new routo.maps.data.Polygon([outerCoords, innerCoords1]);

Parameters

Name {Type} Description
elements { Object } 선형 링 공간정보 목록입니다.

Methods

forEachLatLng(callback)

Descript

지정한 콜백 함수를 각 경위도를 반복하며 수행합니다.

Parameters

Name {Type} Description
callback { function } 콜백함수 입니다.
getArray() → {Array.<LinearRing>}

Descript

선형 링 공간정보 목록을 가져옵니다.

Returns

선형 링 공간정보 목록입니다.

Type
Array.<LinearRing>
getAt(n) → {LinearRing}

Descript

지정한 위치의 선형 링 공간정보를 가져옵니다.

Parameters

Name {Type} Description
n { number } 위치입니다.

Returns

선형 링 공간정보입니다.

Type
LinearRing
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역입니다.

Type
LatLngBounds
getLength() → {number}

Descript

목록의 길이를 가져옵니다.

Returns

길이입니다.

Type
number
getType() → {string}

Descript

공간정보 타입을 가져옵니다.

Returns

면형입니다.

Type
string
includeLatLng(latlng) → {boolean}

Descript

Polygon 영역안에 LatLng가 교차되는지 확인합니다.

Parameters

Name {Type} Description
latlng { Object }
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Returns

교차여부

Type
boolean

routo.maps.drawing.DrawingManager

Description

지도에 마커, 다각형, 폴리곤, 직사각형 및 원을 그릴 수 있습니다. (예제)

Constructor

new routo.maps.DrawingManager(drawingManagerOptions)

Example

const map = new routo.maps.Map('map', {
  center: { lat: 37.507009, lng: 127.0586339 }, // 지도 초기 위치
  zoom: 15, // 지도 로딩 시 최초 표시 레벨
  maxZoom: 19, // 지도의 최대 표시 레벨
  minZoom: 7, // 지도의 최소 표시 레벨
  enableRotation: true, // 지도의 회전 여부
  keyboardShortcuts: true, // 키보드 단축키 사용 여부
  isFractionalZoomEnabled: false, // 확대/축소 시 고정 축척레벨이 아닌 축척으로 이동 허용 여부
  restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
});
const drawingManager = new routo.maps.drawing.DrawingManager({
  map: map,
  circleOptions: {
    strokeColor: '#000000',
    strokeOpacity: 0.3,
    strokeWeight: 10,
    fillOpacity: 0.8,
    fillC
  markerOptions: {
    opacity: 0.8,
    label: {
      text: '마커',
      fontFamily: 'Malgun Gothic',
      fontWeight: 'bold',
      fontSize: '17px'
    },
  },
  polygonOptions: {
    strokeColor: '#FF0000',
    strokeOpacity: 0.8,
    strokeWeight: 3,
    fillColor: '#abc',
    fillOpacity: 1,
    arrow:true,
  },
  polylineOptions: {
    strokeColor: '#FF0000',
    strokeOpacity: 0.5,
    strokeWeight: 10,
    arrow: true,
  },
  rectangleOptions: {
    draggable: true,
    strokeColor: '#FF0000',
    strokeOpacity: 0.8,
    strokeWeight: 3,
    fillColor: '#abc',
    fillOpacity: 1,
  }
});
drawingManager.setOptions({
  polylineOptions: {
    strokeColor: '#abc',
    strokeOpacity: 0.5,
    strokeWeight: 10,
    arrow: true,
  }
});
function setDrawingMode(drawingMode) {
  drawingManager.setDrawingMode(drawingMode);
}
// 모든 도형 삭제
const deleteDrawing = () => drawingManager.clear();
$('#deleteBtn').click(e => deleteDrawing());
$('button').click(e => {
  const target = e.currentTarget;
  setDrawingMode($(target).data('type'));
})

Parameters

Name {Type} Description
drawingManagerOptions { Object } 그리기 관리자 옵션입니다.
Properties
Name {Type} Description
circleOptions { Object } 그리기(원) 옵션입니다.
Properties
Name {Type} Description
center { Object } 원 중심점의 좌표입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
map { routo.maps.Map } Routo Map 객체입니다.
radius { number } 반지름입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
drawingControl { boolean } 그리기도구 컨트롤 사용 여부입니다.
drawingControlOptions { Object } 그리기도구 컨트롤 옵션입니다.
Properties
Name {Type} Description
drawingModes { Array<Object> } 그리기 모드입니다.
position { Object } 그리기도구 컨트롤 아이콘의 위치입니다.
drawingMode { Object } 그리기 모드입니다.
map { routo.maps.Map } Routo Map 객체입니다.
markerOptions { Object } 마커 옵션입니다.
Properties
Name {Type} Description
anchorPoint { routo.maps.Point } 마커의 위치에서 마커를 앵커로 사용하여 열린 InfoWindow의 끝 부분까지의 오프셋입니다.
animation { Object } 마커가 지도에 추가될 때 재생할 애니메이션 기본값은 null 입니다.
clickable { boolean } true 인 경우 마커는 마우스 및 터치 이벤트를 수신합니다. 기본값은 true 입니다.
collisionBehavior { string|CollistionBehavior } 벡터 맵의 마커에 대한 충돌 동작을 설정합니다. 기본값은 null 입니다.
crossOnDrag { boolean } false 인 경우 드래그할 때 마커 아래에 나타나는 십자가를 비활성화합니다. 기본값은 true 입니다.
cursor { string } 호버에 표시할 마우스 커서 유형입니다. 기본값은 "pointer" 입니다.
draggable { boolean } true 이면 마커를 드래그할 수 있습니다. 기본값은 false 입니다.
icon { Object } Icon for the foreground. If a string is provided, it is treated as though it were an Icon with the string as url.
Properties
Name {Type} Description
url { string } 주소입니다.
anchor { routo.maps.Point } 지도에서 마커의 위치에 따라 이미지를 고정할 위치입니다. 위치를 설정하는 경우 왼쪽 상단 모서리를 기준으로 픽셀 단위로 위치를 설정할 수 있습니다. 기본 값은 하단 중앙입니다.
labelOrigin { routo.maps.Point } 레이블의 원점입니다. 중앙 하단을 기준으로 픽섹 단위로 위치를 설정할 수 있습니다. Icon을 사용하는 경우에 레이블은 항상 왼쪽 상단 모서리가 기준이 되므로 labelPosition을 반드시 지정해줘서 위치를 설정해주어야 합니다.
origin { routo.maps.Point } 원점입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자할때 기준이 되는 픽셀입니다.
scale { number } 원본 이미지 대비 표시할 이미지의 비율입니다. 기본 값은 1이며 원본 크기로 표시됩니다. 0.5로 지정하는 경우 원래 크기에 절반 크기로 2로 지정하는 경우 원래 크기의 두 배로 표시됩니다.
size { routo.maps.Size } 이미지의 크기입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자 할때 이미지의 크기입니다.
label { Object } 마커에 라벨을 추가합니다. 기본값은 null 입니다.
Properties
Name {Type} Description
text { string } The text to be displayed in the label.
className { string } The className property of the label's element (equivalent to the element's class attribute). Multiple space-separated CSS classes can be added. The font color, size, weight, and family can only be set via the other properties of MarkerLabel. CSS classes should not be used to change the position nor orientation of the label (e.g. using translations and rotations) if also using marker collision management. 기본값은 "" 입니다.
color { string } The color of the label text. 기본값은 "black" 입니다.
fontFamily { string } The font family of the label text (equivalent to the CSS font-family property).
fontSize { string } The font size of the label text (equivalent to the CSS font-size property). 기본값은 "14px" 입니다.
fontWeight { string } The font weight of the label text (equivalent to the CSS font-weight property).
map { routo.maps.Map }
opacity { number } 0.0(투명)과 1.0(불투명) 사이의 숫자입니다. 기본값은 1.0 입니다.
optimized { boolean } 최적화는 많은 마커를 단일 정적 요소로 렌더링하여 성능을 향상시킵니다.
position { Object } 마커 위치를 설정합니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
shape { Object } drag/click 에 사용되는 이미지 맵 영역입니다.
Properties
Name {Type} Description
coords { Array.<number> } The format of this attribute depends on the value of the type and follows the w3 AREA coords specification found at http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. The coords attribute is an array of integers that specify the pixel position of the shape relative to the top-left corner of the target image. The coordinates depend on the value of type as follows: - circle: coords is [x1,y1,r] where x1,y2 are the coordinates of the center of the circle, and r is the radius of the circle. - poly: coords is [x1,y1,x2,y2...xn,yn] where each x,y pair contains the coordinates of one vertex of the polygon. - rect: coords is [x1,y1,x2,y2] where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.
type { string } Describes the shape's type and can be circle, poly or rect.
title { string } 제목은 현재 최적화되지 않은 마커의 접근성 텍스트에만 사용됩니다.
visible { boolean } true 이면 마커가 표시됩니다. 기본값은 true 입니다.
zIndex { number } 모든 마커는 zIndex의 순서로 맵에 표시되며 더 높은 값은 더 낮은 값을 가진 마커 앞에 표시됩니다.
polygonOptions { Object } 그리기(면) 옵션입니다.
Properties
Name {Type} Description
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
geodesic { boolean } 측지선 사용 여부입니다.
map { routo.maps.Map } Routo Map 객체입니다.
paths { Array.<Array.<(Object|null)>>|undefined } 폴리곤의 경위도 좌표입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
arrow { boolean } 화살표 표시 여부입니다.
arrowLength { number } 화살표 두께입니다.
polylineOptions { Object } 그리기(선) 옵션입니다.
Properties
Name {Type} Description
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
geodesic { boolean } 측지선 사용 여부입니다.
map { routo.maps.Map } Routo Map 객체입니다.
path { Array.<(Object|null)>|undefined } 폴리라인의 경위도 좌표입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
arrow { boolean } 화살표 표시 여부입니다.
arrowLength { number } 화살표 두께입니다.
rectangleOptions { Object } 그리기(사각형) 옵션입니다.
Properties
Name {Type} Description
bounds { Array.<number> } 직사각형의 영역입니다.
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
map { routo.maps.Map } Routo Map 객체입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
arrow { boolean } 화살표 표시 여부입니다.
arrowLength { number } 화살표 두께입니다.

Extends

Methods

addListener(eventName, handler) → {MapsEventListener|null}

Descript

리스너를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명 입니다.
handler { function } 이벤트 처리 함수 입니다.

Returns

지도 이벤트 리스너입니다.

Type
MapsEventListener | null
clear()

Descript

그려진 마커,도형을 전부 삭제합니다.

getDrawingMode() → {string}

Descript

그리기 모드를 반환합니다.

Returns

그리기 모드입니다.

Type
string
getMap() → {Map}

Descript

지도 객체를 반환합니다.

Returns

Routo Map 객체 객체입니다.

Type
Map
setDrawingMode(drawingMode)

Descript

그리기 모드를 설정합니다.

Parameters

Name {Type} Description
drawingMode { string } 그리기 모드입니다.
setMap(map)

Descript

지도 객체를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo Map 객체 입니다.
setOptions(opt)

Descript

옵션을 설정합니다.

Parameters

Name {Type} Description
opt { Object } 옵션입니다.

routo.maps.EventResponse

Description

이벤트 응답입니다.

Constructor

new routo.maps.EventResponse(vb, opt, domEvent, opt, latLng, opt, pixel)

Example

const vb = new routo.maps.Pixel();
const domEvent = {};
const latLng = new routo.maps.LatLng(37.534539, 126.909747);
const pixel = new routo.maps.Pixel();

const eventResponse = new routo.maps.EventResponse(vb, domEvent, latLng, pixel);

Parameters

Name {Type} Description
vb { routo.maps.Pixel }
domEvent { Object } DOM 이벤트 입니다.
latLng { routo.maps.LatLng } latLng 좌표 입니다.
pixel { routo.maps.Pixel } 픽셀 입니다.

routo.maps.InfoWindow

Description

주어진 좌표에 InfoWindow를 표시합니다. (예제)

Constructor

new routo.maps.InfoWindow(options, opt)

Example

const center = {
  lat: 37.532283,
  lng: 126.951886
};

// map 생성
const map = new routo.maps.Map('map', {
  center,
  zoom: 15,
  maxZoom: 19,
  minZoom: 7,
  blockRotation: true,
  keyboardEventTarget: document,
  constrainResolution: true,
  restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
});

// Info Window(Overlay)에 들어갈 텍스트
const content = '<button id="closeInfoWindowBtn" class="btn__overlay--close" style="float : right; cursor:pointer;" onclick="closeInfoWindow();">닫기</button>'
  + '<div id="content">'
  + '<h4>InfoWindow</h4>'
  + '<div>info window 입니다</div>'
  + '</div>';

const infowindow = new routo.maps.InfoWindow({
  content,
  position: center,
});

$('#create-info-window').click(evt => {
  infowindow.open({
    map,
  });
});

$('#delete-info-window').click(evt => {
  infowindow.close();
});

window.closeInfoWindow = () => infowindow.close();

Parameters

Name {Type} Description
options { Object } InfoWindow 옵션입니다.
Properties
Name {Type} Description
ariaLabel { string } InfoWindow에 대한 설명입니다.
content { string } InfoWindow에 표시될 HTML Tag 문자열입니다.
disableAutoPan { boolean } 자동 Panning 사용불가 여부입니다.
maxWidth { number } 최대 너비입니다.
minWidth { number } 최소 너비입니다.
pixelOffset { number } 픽셀 오프셋입니다.
position { Object } InfoWindow가 표시될 위치입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
zIndex { number } 위상 값입니다.

Extends

Methods

addListener(eventName, handler)

Descript

주어진 이벤트 이름에 주어진 리스너 함수를 추가합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명
handler { function } 이벤트 처리 함수
close()

Descript

InfoWindow를 닫습니다.

focus()

Descript

InfoWindow를 포커싱해줍니다.

getContent() → {HTMLElement|undefined}

Descript

InfoWindow의 내용(HTML Tag 문자열)을 반환합니다.

Returns

InfoWindow Content

Type
HTMLElement | undefined
getPosition()

Descript

InfoWindow의 위치를 반환합니다.

getZIndex() → {number}

Descript

위상 값을 설정합니다.

Returns

Type
number
open(openOptions)

Descript

지정된 화면 좌표(x, y) 위치에 InfoWindow를 표시합니다

Parameters

Name {Type} Description
openOptions { Object }
Properties
Name {Type} Description
anchor { routo.maps.MVCObject } 앵커입니다.
map { routo.maps.Map } routo Map 객체입니다.
shouldFocus { boolean } 포커싱 여부입니다.
setContent(content)

Descript

InfoWindow의 내용(HTML Tag 문자열)을 설정합니다.

Parameters

Name {Type} Description
content { string }
setOptions(infoWindowOptions)

Descript

옵션을 재설정한다.

Parameters

Name {Type} Description
infoWindowOptions { Object }
Properties
Name {Type} Description
ariaLabel { string } InfoWindow에 대한 설명입니다.
content { string } InfoWindow에 표시될 HTML Tag 문자열입니다.
disableAutoPan { boolean } 자동 Panning 사용불가 여부입니다.
maxWidth { number } 최대 너비입니다.
minWidth { number } 최소 너비입니다.
pixelOffset { number } 픽셀 오프셋입니다.
position { Object } InfoWindow가 표시될 위치입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
zIndex { number } 위상 값입니다.
setPosition(latlng)

Descript

InfoWindow의 위치를 설정합니다.

Parameters

Name {Type} Description
latlng { Object } Lat, Lng 좌표 객체
setZIndex(zIndex)

Descript

위상 값을 반환합니다.

Parameters

Name {Type} Description
zIndex { number }

routo.maps.interaction.Drag

Description

Feature Drag 상호작용

Constructor

new routo.maps.Drag()

Methods

handleDownEvent(evt)

Descript

도형 Drag Down 이벤트 핸들러

Parameters

Name {Type} Description
evt {}
handleDragEvent(evt)

Descript

도형 Drag 이벤트 핸들러

Parameters

Name {Type} Description
evt {}
handleMoveEvent(evt)

Descript

도형 Drag Move 이벤트 핸들러

Parameters

Name {Type} Description
evt {}
handleUpEvent(evt)

Descript

도형 Drag Up 이벤트 핸들러

Parameters

Name {Type} Description
evt {}

routo.maps.LatLng

Description

경위도입니다.

Constructor

new routo.maps.LatLng(latOrLatLngOrLatLngLiteral, opt, lngOrNoClampNoWrap, opt, noClampNoWrap, opt)

Example

new routo.maps.LatLng(37.534539, 126.909747);
new routo.maps.LatLng(37.534539, 126.909747, true);
new routo.maps.LatLng({lat: 37.534539, lng: 126.909747});
new routo.maps.LatLng({lat: 37.534539, lng: 126.909747}, true);
new routo.maps.LatLng({lat: 37.534539, lng: 126.909747}, null, true);
new routo.maps.LatLng(new routo.maps.LatLng({lat: 37.534539, lng: 126.909747}));
new routo.maps.LatLng(new routo.maps.LatLng({lat: 37.534539, lng: 126.909747}), true);
new routo.maps.LatLng(new routo.maps.LatLng({lat: 37.534539, lng: 126.909747}), null, true);

Parameters

Name {Type} Description
latOrLatLngOrLatLngLiteral { Object } 경도 또는 LatLng 또는 LatLngLiteral 입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
lngOrNoClampNoWrap { number|boolean } 위도 또는 범위 제한 해제 여부입니다.
noClampNoWrap { boolean } 범위 제한 해제 여부입니다.

Methods

equals(other) → {boolean}

Descript

같음 여부를 확인합니다.

Parameters

Name {Type} Description
other { Object } 비교할 경위도입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Returns

같음 여부입니다.

Type
boolean
toJSON() → {LatLngLiteral}

Descript

JSON 객체로 변환합니다.

Returns

경위도 리터럴입니다.

Type
LatLngLiteral
toString() → {string}

Descript

문자열로 변환합니다.

Returns

문자열입니다.

Type
string
toUrlValue(precision, opt) → {string}

Descript

URL 문자열로 변환합니다.

Parameters

Name {Type} Description
precision { number } 정도 (소수점이하 자리수)

Returns

URL 문자열

Type
string

routo.maps.LatLngBounds

Description

경위도 영역입니다.

Constructor

new routo.maps.LatLngBounds(swOrLatLngBounds, opt, ne, opt)

Example

new routo.maps.LatLngBounds(new routo.maps.LatLng({lat: 37.534539, lng: 126.909747}), new routo.maps.LatLng({lat: 37.666666, lng: 126.999999})); 
new routo.maps.LatLngBounds({lat: 37.534539, lng: 126.909747}, {lat: 37.534539, lng: 126.909747});

Parameters

Name {Type} Description
swOrLatLngBounds { Object } 남서쪽 경위도 또는 영역입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
ne { Object } 북동쪽 경위도 입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Methods

contains(latLng) → {boolean}

Descript

지정한 경위도가 영역내에 포함되는지 확인합니다.

Parameters

Name {Type} Description
latLng { Object } 경위도입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Returns

포함 여부

Type
boolean
equals(other) → {boolean}

Descript

같음 여부를 확인합니다.

Parameters

Name {Type} Description
other { Object } 비교할 영역입니다.
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.

Returns

같음 여부입니다.

Type
boolean
extend(point) → {LatLngBounds}

Descript

지정한 경위도를 포함하도록 영역을 확장합니다.

Parameters

Name {Type} Description
point { Object } 경위도입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Returns

확장된 영역입니다.

Type
LatLngBounds
getCenter() → {LatLng}

Descript

영역의 중심점을 가져옵니다.

Returns

중심점입니다.

Type
LatLng
getNorthEast() → {LatLng}

Descript

북동쪽 경위도 가져옵니다.

Returns

경위도입니다.

Type
LatLng
getSouthWest() → {LatLng}

Descript

남서쪽 경위도 가져옵니다.

Returns

경위도입니다.

Type
LatLng
intersects(other) → {boolean}

Descript

교차 여부를 확인합니다.

Parameters

Name {Type} Description
other { Object } 영역입니다.
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.

Returns

교차 여부 입니다.

Type
boolean
isEmpty() → {boolean}

Descript

비어 있는지 여부를 확인합니다.

Returns

비어 있는지 여부입니다.

Type
boolean
toJSON() → {LatLngBoundsLiteral}

Descript

JSON 객체로 변환합니다.

Returns

영역 리터럴입니다.

Type
LatLngBoundsLiteral
toSpan() → {LatLng}

Descript

폭(너비, 높이) 으로 변환합니다.

Returns

영역의 폭(너비, 높이)입니다.

Type
LatLng
toString() → {string}

Descript

문자열로 변환합니다.

Returns

문자열입니다.

Type
string
toUrlValue(precision, opt) → {string}

Descript

URL 문자열로 변환합니다.

Parameters

Name {Type} Description
precision { number } 정도 (소수점이하 자리수)

Returns

URL 문자열

Type
string
union(other) → {LatLngBounds}

Descript

지정한 영역을 포함하도록 경계를 확장합니다.

Parameters

Name {Type} Description
other { Object } 확장할 영역입니다.
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.

Returns

확장된 영역입니다.

Type
LatLngBounds

routo.maps.layer.CustomLayer

Description

타일 이미지 혹은 벡터 지도 서비스를 위한 레이어입니다.
"<script src="https://api.routo.com/v2/maps/js/custom.layer.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.CustomLayer(options)

Example

const map = new routo.maps.Map('map', {
    center: { lat: 37.516509, lng: 126.9000000 }, // 지도 초기 위치
    zoom: 13, // 지도 로딩 시 최초 표시 레벨
    maxZoom: 19, // 지도의 최대 표시 레벨
    minZoom: 7, // 지도의 최소 표시 레벨
    enableRotation: true, // 지도의 회전 여부
    keyboardShortcuts: true, // 키보드 단축키 사용 여부
    isFractionalZoomEnabled: false, // 확대/축소 시 고정 축척레벨이 아닌 축척으로 이동 허용 여부
    restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
});

const customLayer = new routo.maps.layer.CustomLayer({
    zIndex: 20,
    extent: [14127619.46, 4511198.75, 14131130.79, 4513835.83],
    tileUrlFunction: ([z, x, y]) => {
        if (z === 19) {
            return `https://tile.routo.com/webgis_tile01/Detail/v3/${z}/${x}/${y}.png8`
        }
    }
});

map.addLayer_(customLayer);

Parameters

Name {Type} Description
options { Object } 커스텀 레이어 옵션입니다.

routo.maps.Map

Description

Routo 지도입니다. (예제)

Constructor

new routo.maps.Map(target, routoMapOption, opt)

Example

let map = new routo.maps.Map("map", {
  center: { lat: 37.5062764164784, lng: 126.945216460666 }, // 지도 초기 위치
  zoom: 18, // 지도 로딩 시 최초 표시 레벨
  maxZoom: 19, // 지도의 최대 표시 레벨
  minZoom: 7, // 지도의 최소 표시 레벨
  enableRotation: false, // 지도의 회전 여부
  keyboardShortcuts: true, // 키보드 단축키 사용 여부
  isFractionalZoomEnabled: false, // 확대/축소 시 고정 축척레벨이 아닌 축척으로 이동 허용 여부
  restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
  //mapTypeId: "roadmap_vector_basic"
});

Parameters

Name {Type} Description
target { Div|string } Routo 지도를 표시할 Div 또는 Div 의 아이디입니다.
routoMapOption { Object } Routo 지도 옵션입니다.
Properties
Name {Type} Description
center { Object } 초기 지도 위치를 설정합니다. 기본값은 { lat: 37.507009, lng: 127.0586339 } 입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
clickableIcons { boolean } POI 아이콘 선택 가능 여부를 설정합니다. 기본값은 true 입니다.
disableDoubleClickZoom { boolean } 더블 클릭 확대 사용 여부를 설정합니다. 기본값은 false 입니다.
draggableCursor { string } 지도 드래그가 가능할 경우 커서 모양입니다. 기본값은 "auto" 입니다.
draggingCursor { string } 지도를 드래그할때 커서 모양입니다. 기본값은 "auto" 입니다.
fullscreenControl { boolean } 전체화면 기능 사용 여부입니다. 기본값은 false 입니다.
fullscreenControlOptions { Object } 전체화면 기능 옵션입니다. 기본값은 { position: ControlPosition.TOP_RIGHT } 입니다.
Properties
Name {Type} Description
position { Object } 위치 입니다.
heading { number } 초기 지도 방향을 설정합니다. 기본값은 0 입니다.
isFractionalZoomEnabled { boolean } 부분 확대/축소 여부를 설정합니다. 기본값은 false 입니다.
keyboardShortcuts { boolean } 키보드 단축키로 지도 이동 가능 여부입니다. 기본값은 true 입니다.
mapTypeId { string } 지도 타입 아이디 기본값은 Roadmap_Image_Basic 입니다.
maxZoom { number } 최대 축척레벨을 설정합니다. 기본값은 19 입니다.
minZoom { number } 최소 축척레벨을 설정합니다. 기본값은 7 입니다.
noClear { boolean } Map DIV 초기화 여부입니다. true 로 설정하는 경우 지도 DIV 내용을 지우지 않습니다. 기본값은 false 입니다.
restriction { Object } 지도 제한 영역을 설정합니다. 기본값은 { west: 124.6, south: 33.114, east: 131.875, north: 42.59 } 입니다.
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.
scaleControl { boolean } 축척라인 기능 입니다. 기본값은 false 입니다.
scaleControlOptions { Object } 기본값은 { position: ControlPosition.RIGHT_BOTTOM } 입니다.
Properties
Name {Type} Description
position { Object } 위치
scrollwheel { boolean } 스크롤휠로 지도를 확대/축소할지 여부입니다. 기본값은 true 입니다.
styles { Array<Object> } 지도 타입 스타일 목록입니다.
Properties
Name {Type} Description
stylers { Array.<Object> } 스타일 목록입니다.
elementType { string } 객체 타입입니다.
featureType { string } 공간객체 타입입니다. (`busstation`, `restaurant`, `restaurant2`)
zoom { number } 지도 초기 축척레벨을 설정합니다. 기본값은 13 입니다.
zoomControl { number } 축척 (확대/축소) 기능 입니다. 기본값은 false 입니다.
zoomControlOptions { Object } 축척 (확대/축소) 기능 옵션 입니다. 기본값은 { position: ControlPosition.TOP_LEFT } 입니다.
Properties
Name {Type} Description
position { Object } 위치
enableRotation { boolean } 회전 가능 여부를 설정합니다. 기본값은 false 입니다.
stopZoomInOut { boolean } 줌인아웃 여부를 설정합니다.
locationControl { number } 위치 지정 기능 입니다. 기본값은 false 입니다.
locationControlOptions { Object } 위치 지정 기능 옵션 입니다. 기본값은 { markerImageUrl: 'https://tile.routo.com/webgis_tile01/Static/images/marker/1.png', position: ImagePosition.BOTTOM_CENTER } 입니다.
Properties
Name {Type} Description
markerImageUrl { string } 마커 이미지 URL
position { Object } 위치

Extends

Methods

activeWorkspace(mapType, options)

Descript

Workspace Basemap 활성화

Parameters

Name {Type} Description
mapType { routo.maps.Basemap.Workspace } Workspace Basemap 객체
options { Object } Workspace Basemap 설정 값
addLayer(layer)

Descript

레이어 추가

Parameters

Name {Type} Description
layer { ol.layer.Base } Layer.
addListener(eventName, handler)

Descript

이벤트를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명입니다.
handler { function } 이벤트 핸들러 입니다.
addWorkspace(mapType, options)

Descript

Workspace Basemap 추가

Parameters

Name {Type} Description
mapType { routo.maps.Basemap.Workspace } Workspace Basemap 객체
options { Object } Workspace Basemap 설정 값
clearMeasure()

Descript

측정된 스타일을 초기화합니다.

enableDragPan(active)

Descript

지도 드래그 여부를 설정합니다.

Parameters

Name {Type} Description
active {}
enableMeasure(type)

Descript

측정도구를 활성화합니다.

Parameters

Name {Type} Description
type {}
enableRotation()

Descript

지도 회전 여부를 설정합니다.

fitBounds(bounds, padding)

Descript

지도의 영역을 설정합니다.

Parameters

Name {Type} Description
bounds { Object } 영역
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.
padding { Object } padding
Properties
Name {Type} Description
bottom { number } 아래쪽
left { number } 왼쪽
top { number } 위쪽
right { number } 오른쪽
getBounds(pixelX, pixelY) → {LatLngBounds}

Descript

지도의 영역을 가져옵니다.

Parameters

Name {Type} Description
pixelX { number }
pixelY { number }

Returns

Type
LatLngBounds
getCenter() → {LatLng}

Descript

지도의 중심점을 가져옵니다.

Returns

Type
LatLng
getClickableIcons() → {boolean}

Descript

POI 아이콘 선택 가능 여부를 가져옵니다.

Returns

POI 아이콘 선택 가능 여부

Type
boolean
getDiv() → {HTMLElement}

Descript

지도의 DIV 요소를 가져옵니다.

Returns

Type
HTMLElement
getHeading() → {number}

Descript

지도의 방향을 가져옵니다.

Returns

Type
number
getMapDistance(start, end) → {number}

Descript

지도에서 두 지점사이의 거리를 반환합니다.

Parameters

Name {Type} Description
start { Object }
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
end { Object }
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.

Returns

Type
number
getMapTypeId() → {MapTypeId|string|undefined}

Descript

지도 타입 아이디를 가져옵니다.

Returns

Type
MapTypeId | string | undefined
getMarkerExtent()

Descript

map의 마커들이 포함된 영역을 가져옵니다.

(async) getMeta() → {Meta}

Descript

Meta 정보 가져옵니다.

Returns

Meta 정보입니다.

Type
Meta
getZoom() → {number}

Descript

지도의 축척레벨을 가져옵니다.

Returns

Type
number
handleZoomInOut_()

Descript

줌인아웃 여부를 처리합니다.

mapCapture(filename)

Descript

지도를 캡쳐합니다.

Parameters

Name {Type} Description
filename { string } 파일명입니다.
panBy(x, y)

Descript

지정한 픽셀 단위로 지도를 이동합니다.

Parameters

Name {Type} Description
x { number } X 좌표입니다.
y { number } Y 좌표입니다.
panTo(latLng, opt, zoom, opt, duration, opt)

Descript

지도의 중심을 지정한 경위도로 변경합니다. setCenter 와 유사하지만 부드럽게 이동합니다.

Parameters

Name {Type} Description
latLng { routo.maps.LatLng } 이동할 경위도입니다.
zoom { number } 축척 레벨입니다.
duration { number } 지속 시간입니다.(ms)
panToBounds(bounds, padding)

Descript

지정한 영역으로 지도를 이동합니다. fitBounds 와 유사하지만 부드럽게 이동합니다.

Parameters

Name {Type} Description
bounds { Object } 영역
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.
padding { Object } padding
Properties
Name {Type} Description
bottom { number } 아래쪽
left { number } 왼쪽
top { number } 위쪽
right { number } 오른쪽
removeLayer(layer)

Descript

레이어 삭제

Parameters

Name {Type} Description
layer { ol.layer.Base } Layer.
setActiveLocationMarker(isActive)

Descript

위치 지정 컨트롤 활성화/비활성화 합니다.

Parameters

Name {Type} Description
isActive { boolean } 위치 지정 컨트롤 활성화 여부
setCenter(latLng)

Descript

지도의 중심점을 설정합니다.

Parameters

Name {Type} Description
latLng { routo.maps.LatLng } 경위도
setClickableIcons(clickableIcons)

Descript

POI 아이콘 선택 가능 여부를 설정합니다.

Parameters

Name {Type} Description
clickableIcons { boolean } POI 아이콘 선택 가능 여부
setControlActive(controlName, active)

Descript

기능 활성 여부 설정

Parameters

Name {Type} Description
controlName { string } 기능명
active { boolean } 활성 여부
setHeading(heading)

Descript

지도의 방향을 설정합니다.

Parameters

Name {Type} Description
heading { number } 방향
setLogoPosition(position)

Descript

로고 위치를 설정합니다.

Parameters

Name {Type} Description
position { Object } 위치
setMapTypeId(mapTypeId)

Descript

지도 타입 아이디

Parameters

Name {Type} Description
mapTypeId { string } 지도 타입 아이디
setOptions(options)

Descript

옵션을 설정합니다.

Parameters

Name {Type} Description
options { Object } Routo 지도 옵션입니다.
Properties
Name {Type} Description
center { Object } 초기 지도 위치를 설정합니다. 기본값은 { lat: 37.507009, lng: 127.0586339 } 입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
clickableIcons { boolean } POI 아이콘 선택 가능 여부를 설정합니다. 기본값은 true 입니다.
disableDoubleClickZoom { boolean } 더블 클릭 확대 사용 여부를 설정합니다. 기본값은 false 입니다.
draggableCursor { string } 지도 드래그가 가능할 경우 커서 모양입니다. 기본값은 "auto" 입니다.
draggingCursor { string } 지도를 드래그할때 커서 모양입니다. 기본값은 "auto" 입니다.
fullscreenControl { boolean } 전체화면 기능 사용 여부입니다. 기본값은 false 입니다.
fullscreenControlOptions { Object } 전체화면 기능 옵션입니다. 기본값은 { position: ControlPosition.TOP_RIGHT } 입니다.
Properties
Name {Type} Description
position { Object } 위치 입니다.
heading { number } 초기 지도 방향을 설정합니다. 기본값은 0 입니다.
isFractionalZoomEnabled { boolean } 부분 확대/축소 여부를 설정합니다. 기본값은 false 입니다.
keyboardShortcuts { boolean } 키보드 단축키로 지도 이동 가능 여부입니다. 기본값은 true 입니다.
mapTypeId { string } 지도 타입 아이디 기본값은 Roadmap_Image_Basic 입니다.
maxZoom { number } 최대 축척레벨을 설정합니다. 기본값은 19 입니다.
minZoom { number } 최소 축척레벨을 설정합니다. 기본값은 7 입니다.
noClear { boolean } Map DIV 초기화 여부입니다. true 로 설정하는 경우 지도 DIV 내용을 지우지 않습니다. 기본값은 false 입니다.
restriction { Object } 지도 제한 영역을 설정합니다. 기본값은 { west: 124.6, south: 33.114, east: 131.875, north: 42.59 } 입니다.
Properties
Name {Type} Description
east { number } 동쪽 위도입니다.
north { number } 북쪽 경도입니다.
south { number } 남쪽 경도입니다.
west { number } 서쪽 위도입니다.
scaleControl { boolean } 축척라인 기능 입니다. 기본값은 false 입니다.
scaleControlOptions { Object } 기본값은 { position: ControlPosition.RIGHT_BOTTOM } 입니다.
Properties
Name {Type} Description
position { Object } 위치
scrollwheel { boolean } 스크롤휠로 지도를 확대/축소할지 여부입니다. 기본값은 true 입니다.
styles { Array<Object> } 지도 타입 스타일 목록입니다.
Properties
Name {Type} Description
stylers { Array.<Object> } 스타일 목록입니다.
elementType { string } 객체 타입입니다.
featureType { string } 공간객체 타입입니다. (`busstation`, `restaurant`, `restaurant2`)
zoom { number } 지도 초기 축척레벨을 설정합니다. 기본값은 13 입니다.
zoomControl { number } 축척 (확대/축소) 기능 입니다. 기본값은 false 입니다.
zoomControlOptions { Object } 축척 (확대/축소) 기능 옵션 입니다. 기본값은 { position: ControlPosition.TOP_LEFT } 입니다.
Properties
Name {Type} Description
position { Object } 위치
enableRotation { boolean } 회전 가능 여부를 설정합니다. 기본값은 false 입니다.
stopZoomInOut { boolean } 줌인아웃 여부를 설정합니다.
locationControl { number } 위치 지정 기능 입니다. 기본값은 false 입니다.
locationControlOptions { Object } 위치 지정 기능 옵션 입니다. 기본값은 { markerImageUrl: 'https://tile.routo.com/webgis_tile01/Static/images/marker/1.png', position: ImagePosition.BOTTOM_CENTER } 입니다.
Properties
Name {Type} Description
markerImageUrl { string } 마커 이미지 URL
position { Object } 위치
setScalePosition(position)

Descript

ScaleLine Control 위치를 설정합니다.

Parameters

Name {Type} Description
position { Object } 위치
setZoom(zoom)

Descript

축척 레벨을 설정합니다.

Parameters

Name {Type} Description
zoom { number } 축척 레벨
toLatLngFromPixel(x, y, transform) → {LatLng|undefined}

Descript

픽셀 좌표에 해당하는 경위도 좌표를 가져옵니다.

Parameters

Name {Type} Description
x { number } X 좌표 입니다.
y { number } Y 좌표 입니다.
transform { boolean } 좌표변환 여부입니다.

Returns

경위도 좌표 입니다. 지도가 로딩되기 전에는 undefined 가 반환됩니다.

Type
LatLng | undefined
unableMeasure()

Descript

측정도구를 비활성화합니다.

updateSize()

Descript

map의 사이즈를 변경 업데이트 합니다.

routo.maps.MapsEventListener

Description

지도 이벤트 리스너입니다.

Constructor

new routo.maps.MapsEventListener(instance, eventName, handler)

Example

const instance = {};
const eventName = "";
const handler = function() {};
const mapsEventListener = new routo.maps.MapsEventListener(instance, eventName, handler);

Parameters

Name {Type} Description
instance { Object } 객체입니다.
eventName { string } 이벤트 명칭 입니다.
handler { function } 이벤트 발생시 수행할 함수 입니다.

Methods

remove()

Descript

이벤트를 제거합니다.

routo.maps.MapTypeRegistry

Description

지도 타입 등록자입니다.

Constructor

new routo.maps.MapTypeRegistry()

Example

const mapTypeRegistry = new routo.maps.MapTypeRegistry();

Extends

Methods

has(id) → {boolean}

Descript

지도 타입이 있는지 확인합니다.

Parameters

Name {Type} Description
id { string } 아이디입니다.

Returns

지도 타입 여부

Type
boolean
set(id, mapType)

Descript

지도 타입을 설정합니다.

Parameters

Name {Type} Description
id { string } 아이디입니다.
mapType { Object } 지도 타입의 등록 가능한 모든 객체입니다.
Properties
Name {Type} Description
maxZoom { number } 최대 축척
minZoom { number } 최소 축척
radius { number } 반지름
tileSize { routo.maps.Size } 타일 크기
alt { string } 대체 문자열 (지도 타입 기능에서 마우스 오버 시 표시)
name { string } 명칭 (지도 타입 기능에서 표시)
projection { ol.Projection } 좌표체계

routo.maps.Marker

Description

지정된 옵션으로 마커를 생성합니다. 지도가 지정되면 생성 시 지도에 마커가 추가됩니다. 표시할 마커의 위치를 설정해야 합니다. (예제)

Constructor

new routo.maps.Marker(markerOptions)

Example

const myLatlng = {
  lat: 37.52997778,
  lng: 126.96464444
};
// Marker 생성

let marker = new routo.maps.Marker({
  position : myLatlng,
  map: map,
  label: {text: "마커", font: "'Malgun Gothic'", fontWeight: "bold", fontSize: "17px"},
});

Parameters

Name {Type} Description
markerOptions { Object }
Properties
Name {Type} Description
anchorPoint { routo.maps.Point } 마커의 위치에서 마커를 앵커로 사용하여 열린 InfoWindow의 끝 부분까지의 오프셋입니다.
animation { Object } 마커가 지도에 추가될 때 재생할 애니메이션 기본값은 null 입니다.
clickable { boolean } true 인 경우 마커는 마우스 및 터치 이벤트를 수신합니다. 기본값은 true 입니다.
collisionBehavior { string|CollistionBehavior } 벡터 맵의 마커에 대한 충돌 동작을 설정합니다. 기본값은 null 입니다.
crossOnDrag { boolean } false 인 경우 드래그할 때 마커 아래에 나타나는 십자가를 비활성화합니다. 기본값은 true 입니다.
cursor { string } 호버에 표시할 마우스 커서 유형입니다. 기본값은 "pointer" 입니다.
draggable { boolean } true 이면 마커를 드래그할 수 있습니다. 기본값은 false 입니다.
icon { Object } Icon for the foreground. If a string is provided, it is treated as though it were an Icon with the string as url.
Properties
Name {Type} Description
url { string } 주소입니다.
anchor { routo.maps.Point } 지도에서 마커의 위치에 따라 이미지를 고정할 위치입니다. 위치를 설정하는 경우 왼쪽 상단 모서리를 기준으로 픽셀 단위로 위치를 설정할 수 있습니다. 기본 값은 하단 중앙입니다.
labelOrigin { routo.maps.Point } 레이블의 원점입니다. 중앙 하단을 기준으로 픽섹 단위로 위치를 설정할 수 있습니다. Icon을 사용하는 경우에 레이블은 항상 왼쪽 상단 모서리가 기준이 되므로 labelPosition을 반드시 지정해줘서 위치를 설정해주어야 합니다.
origin { routo.maps.Point } 원점입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자할때 기준이 되는 픽셀입니다.
scale { number } 원본 이미지 대비 표시할 이미지의 비율입니다. 기본 값은 1이며 원본 크기로 표시됩니다. 0.5로 지정하는 경우 원래 크기에 절반 크기로 2로 지정하는 경우 원래 크기의 두 배로 표시됩니다.
size { routo.maps.Size } 이미지의 크기입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자 할때 이미지의 크기입니다.
label { Object } 마커에 라벨을 추가합니다. 기본값은 null 입니다.
Properties
Name {Type} Description
text { string } The text to be displayed in the label.
className { string } The className property of the label's element (equivalent to the element's class attribute). Multiple space-separated CSS classes can be added. The font color, size, weight, and family can only be set via the other properties of MarkerLabel. CSS classes should not be used to change the position nor orientation of the label (e.g. using translations and rotations) if also using marker collision management. 기본값은 "" 입니다.
color { string } The color of the label text. 기본값은 "black" 입니다.
fontFamily { string } The font family of the label text (equivalent to the CSS font-family property).
fontSize { string } The font size of the label text (equivalent to the CSS font-size property). 기본값은 "14px" 입니다.
fontWeight { string } The font weight of the label text (equivalent to the CSS font-weight property).
map { routo.maps.Map }
opacity { number } 0.0(투명)과 1.0(불투명) 사이의 숫자입니다. 기본값은 1.0 입니다.
optimized { boolean } 최적화는 많은 마커를 단일 정적 요소로 렌더링하여 성능을 향상시킵니다.
position { Object } 마커 위치를 설정합니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
shape { Object } drag/click 에 사용되는 이미지 맵 영역입니다.
Properties
Name {Type} Description
coords { Array.<number> } The format of this attribute depends on the value of the type and follows the w3 AREA coords specification found at http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. The coords attribute is an array of integers that specify the pixel position of the shape relative to the top-left corner of the target image. The coordinates depend on the value of type as follows: - circle: coords is [x1,y1,r] where x1,y2 are the coordinates of the center of the circle, and r is the radius of the circle. - poly: coords is [x1,y1,x2,y2...xn,yn] where each x,y pair contains the coordinates of one vertex of the polygon. - rect: coords is [x1,y1,x2,y2] where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.
type { string } Describes the shape's type and can be circle, poly or rect.
title { string } 제목은 현재 최적화되지 않은 마커의 접근성 텍스트에만 사용됩니다.
visible { boolean } true 이면 마커가 표시됩니다. 기본값은 true 입니다.
zIndex { number } 모든 마커는 zIndex의 순서로 맵에 표시되며 더 높은 값은 더 낮은 값을 가진 마커 앞에 표시됩니다.

Extends

Methods

addListener(eventName, handler)

Descript

주어진 이벤트 이름에 주어진 리스너 함수를 추가합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명
handler { function } 이벤트 처리 함수
getClickable() → {boolean}

Descript

마커의 클릭 가능 여부 설정을 반환합니다.

Returns

클릭 가능 여부

Type
boolean
getCursor() → {string}

Descript

마커의 커서 설정을 반환합니다.

Returns

커서

Type
string
getDraggable() → {boolean}

Descript

드래그 가능한 상태를 가져옵니다.

Returns

드래그 상태

Type
boolean
getIcon() → {string}

Descript

마커의 이미지 소스를 반환합니다.

Returns

마커의 이미지 소스

Type
string
getLabel() → {MarkerLabel}

Descript

라벨을 가져옵니다.

Returns

Type
MarkerLabel
getMap() → {Map}

Descript

마커가 렌더링되는 지도를 가져옵니다.

Returns

지도

Type
Map
getOpacity() → {number}

Descript

마커의 투명도를 반환합니다.

Returns

마커 투명도

Type
number
getPosition() → {LatLng|null|undefined}

Descript

마커 위치를 반환합니다.

Returns

마커 경위도 좌표

Type
LatLng | null | undefined
getShape() → {MarkerShape}

Descript

마커의 모양을 가져옵니다.

Returns

Type
MarkerShape
getTitle() → {string}

Descript

마커 툴팁의 제목을 가져옵니다.

Returns

마커 툴팁의 제목

Type
string
getVisible() → {boolean}

Descript

마커의 visible 상태를 가져옵니다.

Returns

visible

Type
boolean
getZIndex() → {number}

Descript

마커의 zIndex 값을 반환합니다.

Returns

마커 zIndex

Type
number
remove()

Descript

마커를 삭제합니다.

setClickable(clickable)

Descript

마커의 클릭 가능 여부를 설정합니다.

Parameters

Name {Type} Description
clickable { boolean } 클릭 가능 여부
setCursor(cursor)

Descript

마커의 거서를 설정합니다.

Parameters

Name {Type} Description
cursor { string } 커서
setDraggable(draggable)

Descript

드래그 가능한 여부를 설정합니다.

Parameters

Name {Type} Description
draggable { boolean }
setIcon(icon)

Descript

마커의 아이콘을 설정합니다.

Parameters

Name {Type} Description
icon { Object } 아이콘
Properties
Name {Type} Description
url { string } 주소입니다.
anchor { routo.maps.Point } 지도에서 마커의 위치에 따라 이미지를 고정할 위치입니다. 위치를 설정하는 경우 왼쪽 상단 모서리를 기준으로 픽셀 단위로 위치를 설정할 수 있습니다. 기본 값은 하단 중앙입니다.
labelOrigin { routo.maps.Point } 레이블의 원점입니다. 중앙 하단을 기준으로 픽섹 단위로 위치를 설정할 수 있습니다. Icon을 사용하는 경우에 레이블은 항상 왼쪽 상단 모서리가 기준이 되므로 labelPosition을 반드시 지정해줘서 위치를 설정해주어야 합니다.
origin { routo.maps.Point } 원점입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자할때 기준이 되는 픽셀입니다.
scale { number } 원본 이미지 대비 표시할 이미지의 비율입니다. 기본 값은 1이며 원본 크기로 표시됩니다. 0.5로 지정하는 경우 원래 크기에 절반 크기로 2로 지정하는 경우 원래 크기의 두 배로 표시됩니다.
size { routo.maps.Size } 이미지의 크기입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자 할때 이미지의 크기입니다.
setLabel(label)

Descript

마커의 라벨을 설정합니다.

Parameters

Name {Type} Description
label { Object } 라벨
Properties
Name {Type} Description
text { string } The text to be displayed in the label.
className { string } The className property of the label's element (equivalent to the element's class attribute). Multiple space-separated CSS classes can be added. The font color, size, weight, and family can only be set via the other properties of MarkerLabel. CSS classes should not be used to change the position nor orientation of the label (e.g. using translations and rotations) if also using marker collision management. 기본값은 "" 입니다.
color { string } The color of the label text. 기본값은 "black" 입니다.
fontFamily { string } The font family of the label text (equivalent to the CSS font-family property).
fontSize { string } The font size of the label text (equivalent to the CSS font-size property). 기본값은 "14px" 입니다.
fontWeight { string } The font weight of the label text (equivalent to the CSS font-weight property).
setMap(map)

Descript

지정된 지도에 마커를 렌더링합니다. 맵이 null로 설정되면 마커가 제거됩니다.

Parameters

Name {Type} Description
map { routo.maps.Map }
setOpacity(opacity)

Descript

마커투명도를 설정합니다.

Parameters

Name {Type} Description
opacity { number } 마커 투명도
setOptions(markerOptions)

Descript

마커에 대한 옵션을 설정합니다.

Parameters

Name {Type} Description
markerOptions { Object }
Properties
Name {Type} Description
anchorPoint { routo.maps.Point } 마커의 위치에서 마커를 앵커로 사용하여 열린 InfoWindow의 끝 부분까지의 오프셋입니다.
animation { Object } 마커가 지도에 추가될 때 재생할 애니메이션 기본값은 null 입니다.
clickable { boolean } true 인 경우 마커는 마우스 및 터치 이벤트를 수신합니다. 기본값은 true 입니다.
collisionBehavior { string|CollistionBehavior } 벡터 맵의 마커에 대한 충돌 동작을 설정합니다. 기본값은 null 입니다.
crossOnDrag { boolean } false 인 경우 드래그할 때 마커 아래에 나타나는 십자가를 비활성화합니다. 기본값은 true 입니다.
cursor { string } 호버에 표시할 마우스 커서 유형입니다. 기본값은 "pointer" 입니다.
draggable { boolean } true 이면 마커를 드래그할 수 있습니다. 기본값은 false 입니다.
icon { Object } Icon for the foreground. If a string is provided, it is treated as though it were an Icon with the string as url.
Properties
Name {Type} Description
url { string } 주소입니다.
anchor { routo.maps.Point } 지도에서 마커의 위치에 따라 이미지를 고정할 위치입니다. 위치를 설정하는 경우 왼쪽 상단 모서리를 기준으로 픽셀 단위로 위치를 설정할 수 있습니다. 기본 값은 하단 중앙입니다.
labelOrigin { routo.maps.Point } 레이블의 원점입니다. 중앙 하단을 기준으로 픽섹 단위로 위치를 설정할 수 있습니다. Icon을 사용하는 경우에 레이블은 항상 왼쪽 상단 모서리가 기준이 되므로 labelPosition을 반드시 지정해줘서 위치를 설정해주어야 합니다.
origin { routo.maps.Point } 원점입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자할때 기준이 되는 픽셀입니다.
scale { number } 원본 이미지 대비 표시할 이미지의 비율입니다. 기본 값은 1이며 원본 크기로 표시됩니다. 0.5로 지정하는 경우 원래 크기에 절반 크기로 2로 지정하는 경우 원래 크기의 두 배로 표시됩니다.
size { routo.maps.Size } 이미지의 크기입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자 할때 이미지의 크기입니다.
label { Object } 마커에 라벨을 추가합니다. 기본값은 null 입니다.
Properties
Name {Type} Description
text { string } The text to be displayed in the label.
className { string } The className property of the label's element (equivalent to the element's class attribute). Multiple space-separated CSS classes can be added. The font color, size, weight, and family can only be set via the other properties of MarkerLabel. CSS classes should not be used to change the position nor orientation of the label (e.g. using translations and rotations) if also using marker collision management. 기본값은 "" 입니다.
color { string } The color of the label text. 기본값은 "black" 입니다.
fontFamily { string } The font family of the label text (equivalent to the CSS font-family property).
fontSize { string } The font size of the label text (equivalent to the CSS font-size property). 기본값은 "14px" 입니다.
fontWeight { string } The font weight of the label text (equivalent to the CSS font-weight property).
map { routo.maps.Map }
opacity { number } 0.0(투명)과 1.0(불투명) 사이의 숫자입니다. 기본값은 1.0 입니다.
optimized { boolean } 최적화는 많은 마커를 단일 정적 요소로 렌더링하여 성능을 향상시킵니다.
position { Object } 마커 위치를 설정합니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
shape { Object } drag/click 에 사용되는 이미지 맵 영역입니다.
Properties
Name {Type} Description
coords { Array.<number> } The format of this attribute depends on the value of the type and follows the w3 AREA coords specification found at http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. The coords attribute is an array of integers that specify the pixel position of the shape relative to the top-left corner of the target image. The coordinates depend on the value of type as follows: - circle: coords is [x1,y1,r] where x1,y2 are the coordinates of the center of the circle, and r is the radius of the circle. - poly: coords is [x1,y1,x2,y2...xn,yn] where each x,y pair contains the coordinates of one vertex of the polygon. - rect: coords is [x1,y1,x2,y2] where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.
type { string } Describes the shape's type and can be circle, poly or rect.
title { string } 제목은 현재 최적화되지 않은 마커의 접근성 텍스트에만 사용됩니다.
visible { boolean } true 이면 마커가 표시됩니다. 기본값은 true 입니다.
zIndex { number } 모든 마커는 zIndex의 순서로 맵에 표시되며 더 높은 값은 더 낮은 값을 가진 마커 앞에 표시됩니다.
setPosition(latlng)

Descript

마커의 위치를 설정합니다.

Parameters

Name {Type} Description
latlng { Object }
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
setShape(shape)

Descript

마커의 모양을 설정합니다.

Parameters

Name {Type} Description
shape { Object }
Properties
Name {Type} Description
coords { Array.<number> } The format of this attribute depends on the value of the type and follows the w3 AREA coords specification found at http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. The coords attribute is an array of integers that specify the pixel position of the shape relative to the top-left corner of the target image. The coordinates depend on the value of type as follows: - circle: coords is [x1,y1,r] where x1,y2 are the coordinates of the center of the circle, and r is the radius of the circle. - poly: coords is [x1,y1,x2,y2...xn,yn] where each x,y pair contains the coordinates of one vertex of the polygon. - rect: coords is [x1,y1,x2,y2] where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.
type { string } Describes the shape's type and can be circle, poly or rect.
setTitle(title)

Descript

마커 툴팁의 제목을 설정합니다.

Parameters

Name {Type} Description
title { string } 마커 툴팁의 제목
setVisible(visible)

Descript

마커의 visible 상태를 설정합니다.

Parameters

Name {Type} Description
visible { boolean }
setZIndex(zIndex)

Descript

마커의 zIndex 값을 설정합니다.

Parameters

Name {Type} Description
zIndex { number } 마커 zIndex
show()

Descript

마커를 지도에서 보여지도록 설정

routo.maps.MarkerClusterer

Description

마커 클러스터를 생성합니다. (예제)

Constructor

new routo.maps.MarkerClusterer(markerClusterOptions)

Example

const markerClusterOptions = {};
const markerClusterer = new routo.maps.MarkerClusterer(markerClusterOptions);

Parameters

Name {Type} Description
markerClusterOptions { Object } MarkerClusterer 옵션입니다.
Properties
Name {Type} Description
map { routo.maps.Map } 지도 객체
minZoom { number } 클러스터가 보여질 최소 줌 레벨
maxZoom { number } 클러스터가 보여질 최대 줌
minCount { number } 마커가 뭉처질 최소 개수
markers { Array.<routo.maps.Marker> } Marker 배열
gridSize { number } 격자 크기
clusterStyles { Array.<Object> } 클러스터 스타일 계산
onClusterClick { function } 클러스터 클릭 함수

Extends

Methods

addListener(eventName, handler)

Descript

클러스터 마커에 이벤트를 연결합니다.

Parameters

Name {Type} Description
eventName { string }
handler { function }
addMarker(marker)

Descript

마커를 추가합니다.

Parameters

Name {Type} Description
marker { routo.maps.Marker }
addMarkers(markers)

Descript

마커 목록을 추가합니다.

Parameters

Name {Type} Description
markers { Array.<routo.maps.Marker> }
clearMarkers()

Descript

마커 목록을 초기화합니다.

hideFeature_(feature)

Descript

feature 를 숨깁니다.

Parameters

Name {Type} Description
feature { * }
removeMarker(marker)

Descript

마커를 삭제합니다.

Parameters

Name {Type} Description
marker { routo.maps.Marker }
removeMarkers(markers)

Descript

마커 목록을 삭제합니다.

Parameters

Name {Type} Description
markers { Array.<routo.maps.Marker> }
render()

Descript

마커 클러스터를 표시합니다.

showFeature_(feature)

Descript

feature 를 보이게 합니다.

Parameters

Name {Type} Description
feature { * }

routo.maps.MVCArray

Description

MVC 배열입니다.

Constructor

new routo.maps.MVCArray(array, opt)

Example

const mvcArray = new routo.maps.MVCArray();

Parameters

Name {Type} Description
array { Array.<T> } 배열입니다.

Extends

Methods

addListener(eventName, handler)

Descript

이벤트 등록

Parameters

Name {Type} Description
eventName { string } 이벤트명
handler { function } 핸들러
clear()

Descript

배열을 초기화 합니다.

forEach(callback)

Descript

제공된 콜백을 호출하여 배열 내의 각 요소를 반복합니다.

Parameters

Name {Type} Description
callback { function } function(T, number) : void
getArray() → {Array.<T>}

Descript

배열을 가져옵니다.

Returns

배열

Type
Array.<T>
getAt(i) → {T}

Descript

주어진 위치의 요소를 가져옵니다.

Parameters

Name {Type} Description
i { number } 위치

Returns

요소

Type
T
getLength() → {number}

Descript

배열의 길이를 가져옵니다.

Returns

길이

Type
number
insertAt(i, elem)

Descript

지정한 위치에 요소를 삽입합니다.

Parameters

Name {Type} Description
i { number } 인덱스
elem { T } 요소
pop() → {T}

Descript

배열의 마지막 요소를 가져옵니다.

Returns

elem 요소

Type
T
push(elem)

Descript

배열의 마지막에 요소를 추가합니다.

Parameters

Name {Type} Description
elem { T } 요소
removeAt(i) → {T}

Descript

지정한 위치의 요소를 삭제 합니다.

Parameters

Name {Type} Description
i { number } 위치

Returns

삭제된 요소

Type
T
setAt(i, elem)

Descript

지정한 위치에 요소를 설정합니다.

Parameters

Name {Type} Description
i { number } 위치
elem { T } 요소

routo.maps.MVCObject

Description

MVCObject 객체입니다.

Constructor

new routo.maps.MVCObject()

Example

const mvcObject = new routo.maps.MVCObject();

Methods

addListener(eventName, handler) → {MapsEventListener}

Descript

이벤트 리스너를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명
handler { function } 핸들러

Returns

지도 이벤트 리스너

Type
MapsEventListener
bindTo(key, target, targetKey, opt, noNotify, opt)

Descript

두 객체 (모델, 뷰)의 속성을 연결합니다.

Parameters

Name {Type} Description
key { string } 키입니다.
target { routo.maps.MVCObject } 목표 객체입니다.
targetKey { string } 목표 키입니다.
noNotify { boolean } 알림 방지 여부입니다.
get(key) → {?}

Descript

값을 가져옵니다.

Parameters

Name {Type} Description
key { string } 키입니다.

Returns

값입니다.

Type
?
notify(key)

Descript

이벤트 발생을 알립니다.

Parameters

Name {Type} Description
key { string } 키입니다.
set(key, value)

Descript

값을 설정합니다.

Parameters

Name {Type} Description
key { string } 키입니다.
value { * } 값입니다.
setValues(values, opt)

Descript

값 목록을 설정합니다.

Parameters

Name {Type} Description
values { Object } 값 목록입니다.
unbind(key)

Descript

두 객체의 연결을 해제합니다.

Parameters

Name {Type} Description
key { string }
unbindAll()

Descript

전체 연결을 해제합니다.

routo.maps.MyDataLayer

Description

MyData 레이어입니다. Workspace 에서 등록한 MyData 를 표시할 수 있습니다.

Constructor

new routo.maps.MyDataLayer(myDataLayerOptions)

Example

const myDataLayerOptions = {};
const myDataLayer = new routo.maps.MyDataLayer(myDataLayerOptions);

Parameters

Name {Type} Description
myDataLayerOptions { Object } MyData 레이어 옵션입니다.
Properties
Name {Type} Description
dataKey { string } 데이터 키 입니다. Workspace 에서 설정 및 확인 가능합니다.
styles { Object } JSON 형태의 스타일입니다. (분류 및 약어가 아닌 전체 명칭 사용 등 상세 정의 필요)
zIndex { number } 레이어 Z-INDEX를 설정합니다. Z-INDEX 가 높을 수록 위에 표시 됩니다.

Methods

getMap() → {routo.map.Map}

Descript

지도를 가져옵니다.

Returns

map Routo 지도 입니다.

Type
routo.map.Map
setMap(map)

Descript

지도를 설정합니다. 지도를 제거 하시려면 null로 설정하십시오.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo 지도입니다.

routo.maps.ParkingLayer

Description

주차장 레이어입니다.
"<script src="https://api.routo.com/v2/maps/js/parking.layer.js"></script>" 추가 후 사용 가능

Constructor

new routo.maps.ParkingLayer(opts)

Example

const map = new routo.maps.Map("map", {
  center: { lat: 37.5062764164784, lng: 126.945216460666 }, // 지도 초기 위치
  zoom: 17, // 지도 로딩 시 최초 표시 레벨
  maxZoom: 19, // 지도의 최대 표시 레벨
  minZoom: 7, // 지도의 최소 표시 레벨
  enableRotation: true, // 지도의 회전 여부
  keyboardShortcuts: true, // 키보드 단축키 사용 여부
  isFractionalZoomEnabled: false, // 확대/축소 시 고정 축척레벨이 아닌 축척으로 이동 허용 여부
  restriction: { latLngBounds: { west: 124.6, south: 33.114, east: 131.875, north: 42.59 }, strictBounds: true }, // 지도가 표시할 영역을 지정(해당 영역 밖으로 이동 불가)
  //mapTypeId: "roadmap_vector_basic"
});

// 롯데월드로 이동
map.setCenter({lat: 37.51031710876248, lng: 127.09476734475439});

// 주차장 지도
const parkingLayer = new routo.maps.ParkingLayer({
  map: map,
});

Parameters

Name {Type} Description
opts { Object } 주차장 레이어 옵션입니다.
Properties
Name {Type} Description
map { routo.maps.Map } Routo 지도 입니다.
floorPosition { Object } 층수 정보 위치
clickCallback { function } 상세 주차장 조회 기능에서 사용되는 주차장 영역 클릭시 콜백 함수입니다.
parkingLotId { String } 상세 주차장 조회 기능에서 사용되는 주차장 ID 입니다.
floorInfos { Object } 상세 주차장 조회 기능에서 사용되는 층수 정보입니다.
parkingLotNameCode { String } 주차장 식별값입니다.
parkingFloor { String } 층 정보입니다.
parkingSlot { String } 주차한 슬롯 정보 입니다.
parkingZone { String } 주차 근처 기둥 정보 입니다.

Extends

Methods

(async) getFindParkingLotID(parkingLotNameCode, options)

Descript

name code값이 있으면 주차장 상세 지도 그리기

Parameters

Name {Type} Description
parkingLotNameCode { String }
options { Object }
getMap() → {Map}

Descript

지도를 가져옵니다.

Returns

Routo 지도입니다.

Type
Map
reset()

Descript

주차장지도 상세보기를 해제하고 초기 상태로 되돌립니다.

setMap(map)

Descript

지도를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo 지도입니다.
setOptions(options)

Descript

주차장 레이어 옵션을 설정합니다.

Parameters

Name {Type} Description
options { Object } 주차장 레이어 옵션입니다.
Properties
Name {Type} Description
map { routo.maps.Map } Routo 지도 입니다.
floorPosition { Object } 층수 정보 위치
clickCallback { function } 상세 주차장 조회 기능에서 사용되는 주차장 영역 클릭시 콜백 함수입니다.
parkingLotId { String } 상세 주차장 조회 기능에서 사용되는 주차장 ID 입니다.
floorInfos { Object } 상세 주차장 조회 기능에서 사용되는 층수 정보입니다.
parkingLotNameCode { String } 주차장 식별값입니다.
parkingFloor { String } 층 정보입니다.
parkingSlot { String } 주차한 슬롯 정보 입니다.
parkingZone { String } 주차 근처 기둥 정보 입니다.

routo.maps.Pixel

Description

픽셀

Constructor

new routo.maps.Pixel(x, opt, y, opt)

Example

const x = 123;
const y = 567;
const pixel = new routo.maps.Pixel(x, y);

Parameters

Name {Type} Description
x { number } X 기본값은 0 입니다.
y { number } Y 기본값은 0 입니다.

routo.maps.Point

Description

지점입니다.

Constructor

new routo.maps.Point(x, y)

Example

const x = 37.112;
const y = 126.513;
const point = new routo.maps.Point(x, y);

Parameters

Name {Type} Description
x { number } X 좌표입니다.
y { number } Y 좌표입니다.

Methods

equals(other) → {boolean}

Descript

같음 여부를 확인합니다.

Parameters

Name {Type} Description
other { routo.maps.Point } 비교할 지점입니다.

Returns

같음 여부입니다.

Type
boolean
toString() → {string}

Descript

문자열로 변환합니다.

Returns

문자열입니다.

Type
string

routo.maps.Polygon

Description

그리기(면) (예제)

Constructor

new routo.maps.Polygon(polygonOptions)

Parameters

Name {Type} Description
polygonOptions { Object } 그리기(면) 옵션입니다.
Properties
Name {Type} Description
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
geodesic { boolean } 측지선 사용 여부입니다.
map { routo.maps.Map } Routo Map 객체입니다.
paths { Array.<Array.<(Object|null)>>|undefined } 폴리곤의 경위도 좌표입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
arrow { boolean } 화살표 표시 여부입니다.
arrowLength { number } 화살표 두께입니다.

Extends

Methods

addListener(eventName, handler)

Descript

이벤트를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명 입니다.
handler { function } 이벤트 처리 함수 입니다.
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역입니다.

Type
LatLngBounds
getDraggable() → {boolean}

Descript

드래그 가능 여부 값을 반환합니다.

Returns

가능여부 입니다.

Type
boolean
getEditable() → {boolean}

Descript

편집 가능 여부 값을 반환합니다.

Returns

편집 가능 여부입니다.

Type
boolean
getMap() → {Map}

Descript

Routo Map 객체를 반환합니다.

Returns

Routo Map 객체 입니다.

Type
Map
getPath() → {Array}

Descript

첫번째 폴리곤 영역을 가져옵니다.

Returns

폴리곤 영역입니다.

Type
Array
getPaths() → {Array.<Array.<LatLng>>}

Descript

폴리곤의 경위도 좌표를 반환합니다.

Returns

폴리곤의 경위도 좌표입니다.

Type
Array.<Array.<LatLng>>
setClickable(clickable)

Descript

클릭 가능 여부를 설정합니다.

Parameters

Name {Type} Description
clickable { boolean } 클릭 가능 여부 입니다.
setDraggable(draggable)

Descript

드래그 가능 여부를 설정합니다.

Parameters

Name {Type} Description
draggable { boolean } 드래그 가능 여부 입니다.
setEditable(editable)

Descript

편집 가능 여부를 설정합니다.

Parameters

Name {Type} Description
editable { boolean } 편집 가능 여부입니다.
setMap(map)

Descript

Routo Map 객체를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo Map 객체 입니다.
setOptions(styleOptions)

Descript

폴리곤 스타일 및 속성 정보를 설정합니다.

Parameters

Name {Type} Description
styleOptions { Object } 폴리곤 옵션입니다.
setPaths(paths)

Descript

폴리곤의 경위도 좌표를 설정합니다.

Parameters

Name {Type} Description
paths { Array.<Array.<(Object|null)>>|undefined } 폴리곤의 경위도 좌표입니다.
setVisible(visible)

Descript

표시 여부를 설정합니다.

Parameters

Name {Type} Description
visible { boolean } 표시 여부입니다.
setZIndex(zIndex)

Descript

위상 값을 설정합니다.

Parameters

Name {Type} Description
zIndex { number } 위상입니다.

routo.maps.Polyline

Description

그리기(선) (예제)

Constructor

new routo.maps.Polyline(polyLineOptions)

Parameters

Name {Type} Description
polyLineOptions { Object } 그리기(선) 옵션입니다.
Properties
Name {Type} Description
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
geodesic { boolean } 측지선 사용 여부입니다.
map { routo.maps.Map } Routo Map 객체입니다.
path { Array.<(Object|null)>|undefined } 폴리라인의 경위도 좌표입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
arrow { boolean } 화살표 표시 여부입니다.
arrowLength { number } 화살표 두께입니다.

Extends

Methods

addListener(eventName, handler)

Descript

이벤트를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명 입니다.
handler { function } 이벤트 처리 함수 입니다.
getBounds() → {LatLngBounds}

Descript

영역을 가져옵니다.

Returns

영역입니다.

Type
LatLngBounds
getDraggable() → {boolean}

Descript

드래그 가능 여부를 반환합니다.

Returns

가능여부 입니다.

Type
boolean
getEditable() → {boolean}

Descript

편집 가능 여부를 반환합니다.

Returns

편집 가능 여부입니다.

Type
boolean
getMap() → {Map}

Descript

Routo Map 객체를 반환합니다.

Returns

Routo Map 객체입니다.

Type
Map
getPath() → {Array.<LatLngLiteral>}

Descript

폴리라인의 경위도 좌표를 반환합니다.

Returns

폴리라인의 경위도 좌표입니다.

Type
Array.<LatLngLiteral>
setClickable(clickable)

Descript

클릭 가능 여부를 설정합니다.

Parameters

Name {Type} Description
clickable { boolean } 클릭 가능 여부 입니다.
setDraggable(draggable)

Descript

드래그 가능 여부를 설정합니다.

Parameters

Name {Type} Description
draggable { boolean } 드래그 가능 여부 입니다.
setEditable(editable)

Descript

편집 가능 여부를 설정합니다.

Parameters

Name {Type} Description
editable { boolean } 편집 가능 여부입니다.
setMap(map)

Descript

Routo Map 객체를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo Map 객체입니다.
setOptions(styleOptions)

Descript

폴리라인 스타일 및 속성 정보를 설정합니다.

Parameters

Name {Type} Description
styleOptions { Object } 폴리라인 옵션입니다.
setPath(latlng)

Descript

폴리라인의 경위도 좌표를 설정합니다.

Parameters

Name {Type} Description
latlng { Array<Object> } 폴리라인의 경위도 좌표입니다.
Properties
Name {Type} Description
lat { number } 경도입니다.
lng { number } 위도입니다.
setVisible(visible)

Descript

표시 여부를 설정합니다.

Parameters

Name {Type} Description
visible { boolean } 표시 여부 입니다.
setZIndex(zIndex)

Descript

위상 값을 설정합니다.

Parameters

Name {Type} Description
zIndex { number } 위상입니다.

routo.maps.Rectangle

Description

그리기(사각형) (예제)

Constructor

new routo.maps.Rectangle(rectangleOptions)

Descript

사각형 옵션입니다.

Parameters

Name {Type} Description
rectangleOptions { Object } 사각형 옵션입니다.
Properties
Name {Type} Description
bounds { Array.<number> } 직사각형의 영역입니다.
clickable { boolean } 클릭 가능 여부입니다.
draggable { boolean } 드래그 가능 여부입니다.
editable { boolean } 편집 가능 여부입니다.
fillColor { string } 채우기 색상입니다.
fillOpacity { number } 채우기 투명도입니다.
map { routo.maps.Map } Routo Map 객체입니다.
strokeColor { string } 선 색상입니다.
strokeOpacity { number } 선 투명도입니다.
strokePosition {} 선 위치입니다.
strokeWeight { number } 선 두께입니다.
visible { boolean } 표시 여부입니다.
zIndex { number } 원 위상 값입니다.
arrow { boolean } 화살표 표시 여부입니다.
arrowLength { number } 화살표 두께입니다.

Extends

Methods

addListener(eventName, handler)

Descript

이벤트를 등록합니다.

Parameters

Name {Type} Description
eventName { string } 이벤트명입니다.
handler { function } 이벤트 처리 함수 입니다.
getBounds() → {Object}

Descript

사각형의 영역을 반환합니다.

Returns

bounds 영역 입니다.

Type
Object
getDraggable() → {boolean}

Descript

드래그 가능 여부를 반환합니다.

Returns

가능여부 입니다.

Type
boolean
getEditable() → {boolean}

Descript

편집 가능 여부를 반환합니다.

Returns

편집 가능 여부입니다.

Type
boolean
getMap() → {Map}

Descript

Routo Map 객체를 반환합니다.

Returns

Routo Map 객체 입니다.

Type
Map
setBounds(bounds)

Descript

사각형의 영역을 설정합니다.

Parameters

Name {Type} Description
bounds { Object } bounds 영역 입니다.
setClickable(clickable)

Descript

클릭 가능 여부를 설정합니다.

Parameters

Name {Type} Description
clickable { boolean } 클릭 가능 여부 입니다.
setDraggable(draggable)

Descript

드래그 가능 여부를 설정합니다.

Parameters

Name {Type} Description
draggable { boolean } 드래그 가능 여부 입니다.
setEditable(editable)

Descript

편집 가능 여부를 설정합니다.

Parameters

Name {Type} Description
editable { boolean } 편집 가능 여부입니다.
setMap(map)

Descript

Routo Map 객체를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo Map 객체 입니다.
setOptions(styleOptions)

Descript

사각형 스타일 및 속성 정보를 설정합니다.

Parameters

Name {Type} Description
styleOptions { Object } 사각형의 옵션입니다.
setVisible(visible)

Descript

표시 여부를 설정합니다.

Parameters

Name {Type} Description
visible { boolean } 표시 여부입니다.
setZIndex(zIndex)

Descript

위상 값을 설정합니다.

Parameters

Name {Type} Description
zIndex { number } 위상입니다.

routo.maps.Size

Description

크기 입니다.

Constructor

new routo.maps.Size(width, height, widthUnit, opt, heightUnit, opt)

Example

const width = 100;
const height = 100;
const size = new routo.maps.Size(width, height);

Parameters

Name {Type} Description
width { number } 너비 기본값은 0 입니다.
height { number } 높이 기본값은 0 입니다.
widthUnit { string } 너비 단위 (단위 상세 분석 후 추가 필요)
heightUnit { string } 높이 단위 (단위 상세 분석 후 추가 필요)

Methods

equals(other) → {boolean}

Descript

같음 여부를 가져옵니다.

Parameters

Name {Type} Description
other { routo.maps.Size } 비교할 크기 객체 입니다.

Returns

같음 여부 입니다.

Type
boolean
toString() → {string}

Descript

문자열로 변환합니다.

Returns

크기 문자열입니다.

Type
string

routo.maps.TrafficLayer

Description

교통정보 레이어입니다.

Constructor

new routo.maps.TrafficLayer(opts)

Example

const opts = {};
const trafficLayer = new routo.maps.TrafficLayer(opts);

Parameters

Name {Type} Description
opts { Object } 교통정보 레이어 옵션입니다.
Properties
Name {Type} Description
autoRefresh { boolean } 자동 갱신 여부입니다. 기본값은 true 입니다.
map { routo.maps.Map } Routo 지도 입니다.
theme { string } 스타일 테마명입니다. 'milk', 'black' 이 지원됩니다.

Extends

Methods

getMap() → {Map}

Descript

지도를 가져옵니다.

Returns

Routo 지도입니다.

Type
Map
setMap(map)

Descript

지도를 설정합니다.

Parameters

Name {Type} Description
map { routo.maps.Map } Routo 지도입니다.
setOptions(options)

Descript

교통정보 레이어 옵션을 설정합니다.

Parameters

Name {Type} Description
options { Object } 교통정보 레이어 옵션입니다.
Properties
Name {Type} Description
autoRefresh { boolean } 자동 갱신 여부입니다. 기본값은 true 입니다.
map { routo.maps.Map } Routo 지도 입니다.
theme { string } 스타일 테마명입니다. 'milk', 'black' 이 지원됩니다.
setVisible(visible)

Descript

교통정보 레이어를 표시여부를 설정합니다.

Parameters

Name {Type} Description
visible { boolean } 표시여부 입니다.

Interfaces

CircleOptions

Properties

Name Type Description
center LatLng | LatLngLiteral 원 중심점의 좌표입니다.
clickable boolean 클릭 가능 여부입니다.
draggable boolean 드래그 가능 여부입니다.
editable boolean 편집 가능 여부입니다.
fillColor string 채우기 색상입니다.
fillOpacity number 채우기 투명도입니다.
map Map Routo Map 객체입니다.
radius number 반지름입니다.
strokeColor string 선 색상입니다.
strokeOpacity number 선 투명도입니다.
strokePosition 선 위치입니다.
strokeWeight number 선 두께입니다.
visible boolean 표시 여부입니다.
zIndex number 원 위상 값입니다.

그리기(원) 옵션

Type

Object

Methods

(inner) StylingFunction(feature) → {StyleOptions}

Descript

스타일 함수 입니다.

Parameters

Name {Type} Description
feature { routo.maps.data.Feature } 공간객체 입니다.

Returns

스타일 옵션입니다.

Type
StyleOptions

AddFeatureEvent

Properties

Name Type Description
feature Feature 공간객체 입니다.

공간객체 추가 이벤트입니다.

Type

Object

DataOptions

Properties

Name Type Attributes Description
map Map Routo 지도 입니다.
controlPosition ControlPosition <optional>
기능 위치입니다.
controls Array.<string> <optional>
기능 목록 입니다.
drawingMode string <optional>
그리기 모드 입니다.
featureFactory Object 공간객체 팩토리 입니다.
style Object 스타일입니다.

데이터 옵션입니다.

Type

Object

GeoJsonOptions

Properties

Name Type Description
idPropertyName string 아이디로 사용할 속성명입니다.

GeoJSON 옵션입니다.

Type

Object

MouseEvent

Properties

Name Type Description
feature Feature 공간객체 입니다.

데이터 마우스 이벤트입니다.

Type

Object

RemoveFeatureEvent

Properties

Name Type Description
feature Feature 공간객체 입니다.

공간객체 삭제 이벤트입니다.

Type

Object

RemovePropertyEvent

Properties

Name Type Description
feature Feature 공간객체 입니다.
name string 명칭입니다.
oldValue * 이전 값입니다.

속성 삭제 이벤트입니다.

Type

Object

SetGeometryEvent

Properties

Name Type Description
feature Feature 공간객체 입니다.
newGeometry Geometry 신규 공간정보입니다.
oldGeometry Geometry 이전 공간정보입니다.

공간정보 설정 이벤트입니다.

Type

Object

SetPropertyEvent

Properties

Name Type Description
feature Feature 공간객체 입니다.
name string 명칭입니다.
newValue * 신규 값입니다.
oldValue * 이전 값입니다.

속성 설정 이벤트입니다.

Type

Object

StyleOptions

Properties

Name Type Attributes Description
clickable boolean <optional>
선택 가능 여부 입니다.
fillColor string <optional>
채우기 색상 입니다.
fillOpacity number <optional>
채우기 투명도 입니다.
icon string | Icon <optional>
아이콘 입니다.
label string | MarkerLabel <optional>
라벨 입니다.
opacity number <optional>
점형 공간객체 적용되는 투명도입니다. 0.0 ~ 1.0 사이에 값으로 지정 가능합니다.
strokeColor string <optional>
테두리 색상 입니다.
strokeOpacity number <optional>
테두리 투명도 입니다.
strokeWeight number <optional>
테두리 두께 입니다.
title string <optional>
점형 공간객체에 표시할 제목입니다. 마우스 오버 시 표현됩니다.
visible boolean <optional>
표시 여부 입니다.
zIndex number <optional>
위상입니다. 높을 수록 위에 표시됩니다. 기본값은 3000입니다.

스타일 옵션입니다.

Type

Object

FeatureOptions

Properties

Name Type Attributes Description
geometry Geometry <optional>
공간정보입니다. ("Point", "MultiPoint", "LineString", "MultiLineString", "LinearRing", "Polygon", "MultiPolygon", "GeometryCollection")
id number | string <optional>
아이디입니다.
properties Object <optional>
속성 목록입니다. 키-값 형태로 저장된 속성을 지정할 수 있습니다.

공간객체 옵션입니다.

Type

Object

DrawingControlOptions

Properties

Name Type Description
drawingModes Array.<OverlayType> 그리기 모드입니다.
position ControlPosition 그리기도구 컨트롤 아이콘의 위치입니다.

그리기도구 컨트롤 옵션

Type

Object

DrawingManagerOptions

Properties

Name Type Description
circleOptions CircleOptions 그리기(원) 옵션입니다.
drawingControl boolean 그리기도구 컨트롤 사용 여부입니다.
drawingControlOptions DrawingControlOptions 그리기도구 컨트롤 옵션입니다.
drawingMode OverlayType 그리기 모드입니다.
map Map Routo Map 객체입니다.
markerOptions MarkerOptions 마커 옵션입니다.
polygonOptions PolygonOptions 그리기(면) 옵션입니다.
polylineOptions PolylineOptions 그리기(선) 옵션입니다.
rectangleOptions RectangleOptions 그리기(사각형) 옵션입니다.

그리기도구 관리자 옵션

Type

Object

OverlayCompleteEvent

Properties

Name Type Description
overlay Marker | Polygon | Polyline | Rectangle | Circle 오버레이입니다.
type OverlayType 오버레이 종류입니다.

그리기도구 오버레이 추가완료 이벤트

Type

Object

ErrorEvent

Properties

Name Type Description
error Error 에러입니다.

에러 이벤트입니다.

Type

Object

Methods

(static) addListener(instance, eventName, handler) → {MapsEventListener}

Descript

이벤트 발생 시 수행할 함수를 추가합니다.

Parameters

Name {Type} Description
instance { Object } 객체입니다.
eventName { string } 이벤트명입니다.
handler { function } 이벤트 발생 시 수행할 함수입니다.

Returns

지도 이벤트 리스너입니다.

Type
MapsEventListener
(static) addListenerOnce(instance, eventName, handler) → {MapsEventListener}

Descript

이벤트 발생 시 수행할 함수를 추가합니다. 한 번 실행되면 제거됩니다.

Parameters

Name {Type} Description
instance { Object } 객체입니다.
eventName { string } 이벤트명입니다.
handler { function } 이벤트 발생 시 수행할 함수입니다.

Returns

지도 이벤트 리스너입니다.

Type
MapsEventListener
(static) clearInstanceListeners(instance)

Descript

객체에 모든 리스너를 제거합니다

Parameters

Name {Type} Description
instance { Object } 객체입니다.
(static) clearListeners(instance, eventName)

Descript

객체에 이벤트명에 해당하는 이벤트 리스너를 제거합니다.

Parameters

Name {Type} Description
instance { Object } 객체입니다.
eventName { string } 이벤트명입니다.
(static) hasListeners(instance, eventName) → {boolean}

Descript

객체에 이벤트명에 해당하는 이벤트 리스너가 존재하는지 확인합니다.

Parameters

Name {Type} Description
instance { Object } 객체입니다.
eventName { string } 이벤트명입니다.

Returns

이벤트 리스너 존재 유무입니다.

Type
boolean
(static) removeListener(listener)

Descript

지도 이벤트 리스너를 제거합니다.

Parameters

Name {Type} Description
listener { routo.maps.MapsEventListener } 지도 이벤트 리스너입니다.
(static) trigger(instance, eventName, …eventArgs)

Descript

객체에 이벤트를 발생합니다.

Parameters

Name {Type} Description
instance { Object } 객체입니다.
eventName { string } 이벤트명입니다.
eventArgs { * } 이벤트 인수 목록입니다.

FullscreenControlOptions

Properties

Name Type Attributes Description
position ControlPosition <optional>
위치 입니다.

전체 화면 기능 옵션입니다.

Icon

Properties

Name Type Attributes Description
url string 주소입니다.
anchor Point <optional>
지도에서 마커의 위치에 따라 이미지를 고정할 위치입니다. 위치를 설정하는 경우 왼쪽 상단 모서리를 기준으로 픽셀 단위로 위치를 설정할 수 있습니다. 기본 값은 하단 중앙입니다.
labelOrigin Point <optional>
레이블의 원점입니다. 중앙 하단을 기준으로 픽섹 단위로 위치를 설정할 수 있습니다. Icon을 사용하는 경우에 레이블은 항상 왼쪽 상단 모서리가 기준이 되므로 labelPosition을 반드시 지정해줘서 위치를 설정해주어야 합니다.
origin Point <optional>
원점입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자할때 기준이 되는 픽셀입니다.
scale number <optional>
원본 이미지 대비 표시할 이미지의 비율입니다. 기본 값은 1이며 원본 크기로 표시됩니다. 0.5로 지정하는 경우 원래 크기에 절반 크기로 2로 지정하는 경우 원래 크기의 두 배로 표시됩니다.
size Size <optional>
이미지의 크기입니다. 하나의 이미지 중 분할하여 아이콘을 표시하고자 할때 이미지의 크기입니다.

아이콘입니다.

Type

Object

InfoWindowOpenOptions

Properties

Name Type Description
anchor MVCObject 앵커입니다.
map Map routo Map 객체입니다.
shouldFocus boolean 포커싱 여부입니다.

InfoWindow 열기 옵션입니다.

Type

Object

InfoWindowOptions

Properties

Name Type Description
ariaLabel string InfoWindow에 대한 설명입니다.
content string InfoWindow에 표시될 HTML Tag 문자열입니다.
disableAutoPan boolean 자동 Panning 사용불가 여부입니다.
maxWidth number 최대 너비입니다.
minWidth number 최소 너비입니다.
pixelOffset number 픽셀 오프셋입니다.
position LatLng | LatLngLiteral InfoWindow가 표시될 위치입니다.
zIndex number 위상 값입니다.

InfoWindow 옵션입니다.

Type

Object

LatLngBoundsLiteral

Properties

Name Type Description
east number 동쪽 위도입니다.
north number 북쪽 경도입니다.
south number 남쪽 경도입니다.
west number 서쪽 위도입니다.

영역 리터럴입니다.

Type

Object

LatLngLiteral

Properties

Name Type Description
lat number 경도입니다.
lng number 위도입니다.

경위도 리터럴입니다.

Type

Object

LocationControlOptions

Properties

Name Type Description
markerImageUrl string 마커 이미지 URL
position ImagePosition 위치

축척 옵션

Type

Object

MapRestriction

Properties

Name Type Description
latLngBounds LatLngBounds | LatLngBoundsLiteral 제한할 영역입니다.
strictBounds boolean 엄격히 제한할지 여부입니다.

지도 제한입니다.

Type

Object

MapTypeStyle

Properties

Name Type Attributes Description
stylers Array.<Object> 스타일 목록입니다.
elementType string <optional>
객체 타입입니다.
featureType string <optional>
공간객체 타입입니다. (`busstation`, `restaurant`, `restaurant2`)

지도 타입 스타일입니다.

Type

Object

Meta

Properties

Name Type Description
reallinkSpeed string 리얼링크 속도 URL입니다.
reallinkToken string 리얼링크 토큰 URL입니다.
serverUrl string 서버주소 입니다.
staticResourceUrl string 정적 리소스 주소입니다.
version string 버전입니다.
workspaceUrl string 워크스페이스 주소입니다.
theme Array.<Theme> 지도타입에 대한 정보 목록입니다.

Routo 정보입니다.

Type

Object

Padding

Properties

Name Type Description
bottom number 아래쪽
left number 왼쪽
top number 위쪽
right number 오른쪽

Padding

Type

Object

RoutoMapOption

Properties

Name Type Attributes Default Description
center LatLng | LatLngLiteral <optional>
{ lat: 37.507009, lng: 127.0586339 } 초기 지도 위치를 설정합니다.
clickableIcons boolean <optional>
true POI 아이콘 선택 가능 여부를 설정합니다.
disableDoubleClickZoom boolean <optional>
false 더블 클릭 확대 사용 여부를 설정합니다.
draggableCursor string <optional>
"auto" 지도 드래그가 가능할 경우 커서 모양입니다.
draggingCursor string <optional>
"auto" 지도를 드래그할때 커서 모양입니다.
fullscreenControl boolean <optional>
false 전체화면 기능 사용 여부입니다.
fullscreenControlOptions FullscreenControlOptions <optional>
{ position: module:maps/ControlPosition.TOP_RIGHT } 전체화면 기능 옵션입니다.
heading number <optional>
0 초기 지도 방향을 설정합니다.
isFractionalZoomEnabled boolean <optional>
false 부분 확대/축소 여부를 설정합니다.
keyboardShortcuts boolean <optional>
true 키보드 단축키로 지도 이동 가능 여부입니다.
mapTypeId string <optional>
Roadmap_Image_Basic 지도 타입 아이디
maxZoom number <optional>
19 최대 축척레벨을 설정합니다.
minZoom number <optional>
7 최소 축척레벨을 설정합니다.
noClear boolean <optional>
false Map DIV 초기화 여부입니다. true 로 설정하는 경우 지도 DIV 내용을 지우지 않습니다.
restriction LatLngBounds | LatLngBoundsLiteral <optional>
{ west: 124.6, south: 33.114, east: 131.875, north: 42.59 } 지도 제한 영역을 설정합니다.
scaleControl boolean <optional>
false 축척라인 기능 입니다.
scaleControlOptions ScaleControlOptions <optional>
{ position: module:maps/ControlPosition.RIGHT_BOTTOM }
scrollwheel boolean <optional>
true 스크롤휠로 지도를 확대/축소할지 여부입니다.
styles Array.<MapTypeStyle> <optional>
지도 타입 스타일 목록입니다.
zoom number <optional>
13 지도 초기 축척레벨을 설정합니다.
zoomControl number <optional>
false 축척 (확대/축소) 기능 입니다.
zoomControlOptions ZoomControlOptions <optional>
{ position: module:maps/ControlPosition.TOP_LEFT } 축척 (확대/축소) 기능 옵션 입니다.
enableRotation boolean <optional>
false 회전 가능 여부를 설정합니다.
stopZoomInOut boolean 줌인아웃 여부를 설정합니다.
locationControl number <optional>
false 위치 지정 기능 입니다.
locationControlOptions LocationControlOptions <optional>
{ markerImageUrl: 'https://tile.routo.com/webgis_tile01/Static/images/marker/1.png', position: module:maps/ImagePosition.BOTTOM_CENTER } 위치 지정 기능 옵션 입니다.

Routo 지도 옵션입니다.

ScaleControlOptions

Properties

Name Type Description
position ControlPosition 위치

축척 옵션

Type

Object

Theme

Properties

Name Type Description
version string 버전입니다.
theme string 지도타입 아이디입니다.
imageTileUrl string 이미지 타일 URL입니다.
notSupportedTileUrl string 지원되지 않는 타일 URL입니다.
preImageUrl string 배경 이미지 URL입니다.
vectorTileUrl string 벡터타일 URL입니다.
vectorIconImageUrl string 벡터타일 아이콘 이미지 URL입니다.
vectorStyleUrl string 벡터 스타일 URL입니다.
vectorStyleExceptionUrl string 벡터 스타일 예외 URL입니다.
vectorIconPositionUrl string 벡터 아이콘 위치 URL입니다.

지도타입에 대한 정보입니다.

Type

Object

WorkspaceOption

Properties

Name Type Description
prefix string 사용자 PREFIX 값
roomKey string MY ROOM 키
styleKey string MY STYLE 키

워크스페이스 옵션

Type

Object

ZoomControlOptions

Properties

Name Type Description
position ControlPosition 위치

축척 옵션

Type

Object

MapType

Properties

Name Type Attributes Description
maxZoom number 최대 축척
minZoom number 최소 축척
radius number 반지름
tileSize Size 타일 크기
alt string <optional>
대체 문자열 (지도 타입 기능에서 마우스 오버 시 표시)
name string <optional>
명칭 (지도 타입 기능에서 표시)
projection ol.Projection <optional>
좌표체계

지도 타입

Type

Object

Icon

Properties

Name Type Description
url string The URL of the image or sprite sheet.
anchor Point The position at which to anchor an image in correspondence to the location of the marker on the map. By default, the anchor is located along the center point of the bottom of the image.
labelOrigin Point The origin of the label relative to the top-left corner of the icon image, if a label is supplied by the marker. By default, the origin is located in the center point of the image.
origin Point The position of the image within a sprite, if any. By default, the origin is located at the top left corner of the image (0, 0).
scaledSize Size The size of the entire image after scaling, if any. Use this property to stretch/shrink an image or a sprite.
size Size The display size of the sprite or image. When using sprites, you must specify the sprite size. If the size is not provided, it will be set when the image loads.
rotation number 아이콘 회전각도 0~360 값을 입력합니다. 0 은 북쪽을 가르킵니다.

아이콘

Type

Object

MarkerLabel

Properties

Name Type Attributes Default Description
text string The text to be displayed in the label.
className string <optional>
"" The className property of the label's element (equivalent to the element's class attribute). Multiple space-separated CSS classes can be added. The font color, size, weight, and family can only be set via the other properties of MarkerLabel. CSS classes should not be used to change the position nor orientation of the label (e.g. using translations and rotations) if also using marker collision management.
color string <optional>
"black" The color of the label text.
fontFamily string The font family of the label text (equivalent to the CSS font-family property).
fontSize string <optional>
"14px" The font size of the label text (equivalent to the CSS font-size property).
fontWeight string The font weight of the label text (equivalent to the CSS font-weight property).

마커 라벨

Type

Object

MarkerOptions

Properties

Name Type Attributes Default Description
anchorPoint Point 마커의 위치에서 마커를 앵커로 사용하여 열린 InfoWindow의 끝 부분까지의 오프셋입니다.
animation Animation <optional>
null 마커가 지도에 추가될 때 재생할 애니메이션
clickable boolean <optional>
true true 인 경우 마커는 마우스 및 터치 이벤트를 수신합니다.
collisionBehavior string | CollistionBehavior <optional>
null 벡터 맵의 마커에 대한 충돌 동작을 설정합니다.
crossOnDrag boolean <optional>
true false 인 경우 드래그할 때 마커 아래에 나타나는 십자가를 비활성화합니다.
cursor string <optional>
"pointer" 호버에 표시할 마우스 커서 유형입니다.
draggable boolean <optional>
false true 이면 마커를 드래그할 수 있습니다.
icon string | Icon | Symbol Icon for the foreground. If a string is provided, it is treated as though it were an Icon with the string as url.
label string | MarkerLabel <optional>
null 마커에 라벨을 추가합니다.
map Map
opacity number <optional>
1.0 0.0(투명)과 1.0(불투명) 사이의 숫자입니다.
optimized boolean 최적화는 많은 마커를 단일 정적 요소로 렌더링하여 성능을 향상시킵니다.
position LatLng | LatLngLiteral 마커 위치를 설정합니다.
shape MarkerShape drag/click 에 사용되는 이미지 맵 영역입니다.
title string <optional>
제목은 현재 최적화되지 않은 마커의 접근성 텍스트에만 사용됩니다.
visible boolean <optional>
true true 이면 마커가 표시됩니다.
zIndex number 모든 마커는 zIndex의 순서로 맵에 표시되며 더 높은 값은 더 낮은 값을 가진 마커 앞에 표시됩니다.

마커에 설정할 수 있는 속성을 정의하는 데 사용되는 MarkerOptions 개체입니다.

MarkerShape

Properties

Name Type Description
coords Array.<number> The format of this attribute depends on the value of the type and follows the w3 AREA coords specification found at http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. The coords attribute is an array of integers that specify the pixel position of the shape relative to the top-left corner of the target image. The coordinates depend on the value of type as follows: - circle: coords is [x1,y1,r] where x1,y2 are the coordinates of the center of the circle, and r is the radius of the circle. - poly: coords is [x1,y1,x2,y2...xn,yn] where each x,y pair contains the coordinates of one vertex of the polygon. - rect: coords is [x1,y1,x2,y2] where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.
type string Describes the shape's type and can be circle, poly or rect.

마커 도형

Type

Object

Symbol

Properties

Name Type Attributes Default Description
path SymbolPath | string The symbol's path, which is a built-in symbol path, or a custom path expressed using SVG path notation. Required.
anchor Point The position of the symbol relative to the marker or polyline. The coordinates of the symbol's path are translated left and up by the anchor's x and y coordinates respectively. The position is expressed in the same coordinate system as the symbol's path.
fillColor string The symbol's fill color. All CSS3 colors are supported except for extended named colors. For symbol markers, this defaults to 'black'. For symbols on polylines, this defaults to the stroke color of the corresponding polyline.
fillOpacity number <optional>
0 The symbol's fill opacity.
labelOrigin Point The origin of the label relative to the origin of the path, if label is supplied by the marker. The origin is expressed in the same coordinate system as the symbol's path. This property is unused for symbols on polylines.
rotation number <optional>
0 The angle by which to rotate the symbol, expressed clockwise in degrees. A symbol in an IconSequence where fixedRotation is false is rotated relative to the angle of the edge on which it lies.
scale number The amount by which the symbol is scaled in size. For symbol markers, this defaults to 1; after scaling, the symbol may be of any size. For symbols on a polyline, this defaults to the stroke weight of the polyline; after scaling, the symbol must lie inside a square 22 pixels in size centered at the symbol's anchor.
strokeColor string The symbol's stroke color. All CSS3 colors are supported except for extended named colors. For symbol markers, this defaults to 'black'. For symbols on a polyline, this defaults to the stroke color of the polyline.
strokeOpacity number The symbol's stroke opacity. For symbol markers, this defaults to 1. For symbols on a polyline, this defaults to the stroke opacity of the polyline.
strokeWeight number The symbol's stroke weight.

심볼

Type

Object

SymbolPath

Properties

Name Type Description
BACKWARD_CLOSED_ARROW * 뒤를 가리키는 닫힌 화살표입니다.
BACKWARD_OPEN_ARROW * 뒤를 가리키는 열린 화살표입니다.
CIRCLE * 원입니다.
FORWARD_CLOSED_ARROW * 앞을 가르키는 닫힌 화살표입니다.
FORWARD_OPEN_ARROW * 앞을 가르치는 열린 화살표입니다.

MarkerClusterOptions

Properties

Name Type Description
map Map 지도 객체
minZoom number 클러스터가 보여질 최소 줌 레벨
maxZoom number 클러스터가 보여질 최대 줌
minCount number 마커가 뭉처질 최소 개수
markers Array.<Marker> Marker 배열
gridSize number 격자 크기
clusterStyles Array.<Object> 클러스터 스타일 계산
onClusterClick function 클러스터 클릭 함수

MarkerClusterer 옵션입니다.

Type

Object

MarkerLabel

Properties

Name Type Attributes Default Description
text string 텍스트입니다.
color string <optional>
"#000000" 글자색입니다.
fontFamily string <optional>
"YD_YGO540" 글꼴입니다.
fontSize string <optional>
"14px" 글자 크기입니다.
fontWeight string <optional>
"normal" 글자 굵기입니다.

마커 라벨입니다.

Type

Object

MyDataLayerOptions

Properties

Name Type Description
dataKey string 데이터 키 입니다. Workspace 에서 설정 및 확인 가능합니다.
styles Object JSON 형태의 스타일입니다. (분류 및 약어가 아닌 전체 명칭 사용 등 상세 정의 필요)
zIndex number 레이어 Z-INDEX를 설정합니다. Z-INDEX 가 높을 수록 위에 표시 됩니다.

MyData 레이어 옵션입니다.

Type

Object

ParkingLayerOptions

Properties

Name Type Attributes Description
map Map <optional>
Routo 지도 입니다.
floorPosition ControlPosition 층수 정보 위치
clickCallback function 상세 주차장 조회 기능에서 사용되는 주차장 영역 클릭시 콜백 함수입니다.
parkingLotId String 상세 주차장 조회 기능에서 사용되는 주차장 ID 입니다.
floorInfos Object 상세 주차장 조회 기능에서 사용되는 층수 정보입니다.
parkingLotNameCode String 주차장 식별값입니다.
parkingFloor String 층 정보입니다.
parkingSlot String 주차한 슬롯 정보 입니다.
parkingZone String 주차 근처 기둥 정보 입니다.

주차장 레이어 옵션입니다.

Type

Object

PolygonOptions

Properties

Name Type Description
clickable boolean 클릭 가능 여부입니다.
draggable boolean 드래그 가능 여부입니다.
editable boolean 편집 가능 여부입니다.
fillColor string 채우기 색상입니다.
fillOpacity number 채우기 투명도입니다.
geodesic boolean 측지선 사용 여부입니다.
map Map Routo Map 객체입니다.
paths Array.<Array.<(Object|null)>> | undefined 폴리곤의 경위도 좌표입니다.
strokeColor string 선 색상입니다.
strokeOpacity number 선 투명도입니다.
strokePosition 선 위치입니다.
strokeWeight number 선 두께입니다.
visible boolean 표시 여부입니다.
zIndex number 원 위상 값입니다.
arrow boolean 화살표 표시 여부입니다.
arrowLength number 화살표 두께입니다.

그리기(면) 옵션입니다.

Type

Object

PolylineOptions

Properties

Name Type Description
clickable boolean 클릭 가능 여부입니다.
draggable boolean 드래그 가능 여부입니다.
editable boolean 편집 가능 여부입니다.
fillColor string 채우기 색상입니다.
fillOpacity number 채우기 투명도입니다.
geodesic boolean 측지선 사용 여부입니다.
map Map Routo Map 객체입니다.
path Array.<(Object|null)> | undefined 폴리라인의 경위도 좌표입니다.
strokeColor string 선 색상입니다.
strokeOpacity number 선 투명도입니다.
strokePosition 선 위치입니다.
strokeWeight number 선 두께입니다.
visible boolean 표시 여부입니다.
zIndex number 원 위상 값입니다.
arrow boolean 화살표 표시 여부입니다.
arrowLength number 화살표 두께입니다.

그리기(선) 옵션입니다.

Type

Object

RectangleOptions

Properties

Name Type Description
bounds Array.<number> 직사각형의 영역입니다.
clickable boolean 클릭 가능 여부입니다.
draggable boolean 드래그 가능 여부입니다.
editable boolean 편집 가능 여부입니다.
fillColor string 채우기 색상입니다.
fillOpacity number 채우기 투명도입니다.
map Map Routo Map 객체입니다.
strokeColor string 선 색상입니다.
strokeOpacity number 선 투명도입니다.
strokePosition 선 위치입니다.
strokeWeight number 선 두께입니다.
visible boolean 표시 여부입니다.
zIndex number 원 위상 값입니다.
arrow boolean 화살표 표시 여부입니다.
arrowLength number 화살표 두께입니다.

사각형 옵션입니다.

Type

Object

TileExtent

Properties

Name Type Description
level number 레벨
xmin number bottom
ymin number left
xmax number top
ymax number right

타일 영역 정보

Type

Object

TrafficLayerOptions

Properties

Name Type Attributes Default Description
autoRefresh boolean <optional>
true 자동 갱신 여부입니다.
map Map <optional>
Routo 지도 입니다.
theme string <optional>
스타일 테마명입니다. 'milk', 'black' 이 지원됩니다.

교통정보 레이어 옵션입니다.

Type

Object

ZoomControlOptions

Properties

Name Type Attributes Description
position ControlPosition <optional>
위치 입니다.

확대/축소 기능 옵션입니다.

Type

Object