setProjectionId getProjectionId addOverlayMapTypeId removeOverlayMapTypeId setKeyboardShortcuts getKeyboardShortcuts setCopyrightPosition maptypeid_changed pointFromCoords coordsFromPoint containerPointFromCoords coordsFromContainerPoint getViewpointWithPanoId viewpoint_changed position_changed getNearestPanoId coord2RegionCode getMinClusterSize setMinClusterSize getAverageCenter setAverageCenter clusterdblclick clusterrightclick getClusterMarker setStrokeWeight kakao.maps.load kakao.maps.disableHD Map Methods Events kakao.maps.Map(container, options) 지도를 생성한다. 지도 생성하기 샘플보기 container Node : 지도가 표시될 HTML element options Object center LatLng : 중심 좌표 (필수) level Number : 확대 수준 (기본값: 3) mapTypeId MapTypeId : 지도 종류 (기본값: 일반 지도) draggable Boolean : 마우스 드래그, 휠, 모바일 터치를 이용한 시점 변경(이동, 확대, 축소) 가능 여부 scrollwheel Boolean : 마우스 휠, 모바일 터치를 이용한 확대 및 축소 가능 여부 disableDoubleClick Boolean : 더블클릭 이벤트 및 더블클릭 확대 가능 여부 disableDoubleClickZoom Boolean : 더블클릭 확대 가능 여부 projectionId String : 투영법 지정 (기본값: kakao.maps.ProjectionId. WCONG ) tileAnimation Boolean : 지도 타일 애니메이션 설정 여부 (기본값: true) keyboardShortcuts Boolean | Object : 키보드의 방향키와 +, – 키로 지도 이동,확대,축소 가능 여부 (기본값: false) speed Number : 지도 이동 속도 center LatLng : 중심 좌표 (필수) level Number : 확대 수준 (기본값: 3) mapTypeId MapTypeId : 지도 종류 (기본값: 일반 지도) draggable Boolean : 마우스 드래그, 휠, 모바일 터치를 이용한 시점 변경(이동, 확대, 축소) 가능 여부 scrollwheel Boolean : 마우스 휠, 모바일 터치를 이용한 확대 및 축소 가능 여부 disableDoubleClick Boolean : 더블클릭 이벤트 및 더블클릭 확대 가능 여부 disableDoubleClickZoom Boolean : 더블클릭 확대 가능 여부 projectionId String : 투영법 지정 (기본값: kakao.maps.ProjectionId. WCONG ) tileAnimation Boolean : 지도 타일 애니메이션 설정 여부 (기본값: true) keyboardShortcuts Boolean | Object : 키보드의 방향키와 +, – 키로 지도 이동,확대,축소 가능 여부 (기본값: false) speed Number : 지도 이동 속도 speed Number : 지도 이동 속도 setCenter(latlng) 지도의 중심 좌표를 설정한다. 지도 이동시키기 샘플보기 지도의 중심 좌표를 반환한다. 지도 정보 얻어오기 샘플보기 setLevel(level, options) 지도의 확대 수준을 설정한다. MapTypeId 의 종류에 따라 설정 범위가 다르다. SKYVIEW , HYBRID 일 경우 0 ~ 14, ROADMAP 일 경우 1 ~ 14. 지도 레벨바꾸기 샘플보기 options Object animate Boolean | Object : 지도 확대수준 변경 시 애니메이션 효과 여부 (현재 지도 레벨과의 차이가 2 이하인 경우에만 애니메이션 효과 가능) duration Number : 애니메이션 효과 지속 시간 (단위: ms) anchor LatLng : 지도 확대수준 변경 시 기준 좌표 animate Boolean | Object : 지도 확대수준 변경 시 애니메이션 효과 여부 (현재 지도 레벨과의 차이가 2 이하인 경우에만 애니메이션 효과 가능) duration Number : 애니메이션 효과 지속 시간 (단위: ms) duration Number : 애니메이션 효과 지속 시간 (단위: ms) anchor LatLng : 지도 확대수준 변경 시 기준 좌표 지도의 확대 수준을 반환한다. 지도 정보 얻어오기 샘플보기 setMapTypeId(mapTypeId) 지도의 타입을 설정한다. 지도 타입 바꾸기1 샘플보기 지도 타입 바꾸기2 샘플보기 mapTypeId MapTypeId 지도의 타입을 반환한다. 지도 정보 얻어오기 샘플보기 setBounds(bounds[, paddingTop, paddingRight, paddingBottom, paddingLeft]) 주어진 영역이 화면 안에 전부 나타날 수 있도록 지도의 중심 좌표와 확대 수준을 설정한다. 주어진 영역외에 추가로 padding값을 지정할 수 있다. 2번째 파라메터부터 top, right, bottom, left값이며 파라메터를 1개 이상 지정한 경우 지정하지 않은 파라메터에 대해서는 CSS의 padding rule을 따른다. (ex. paddingTop:100, paddingRight:50 을 지정한 경우. top, right, bottom, left 순서로 100 50 100 50) padding값을 지정하지 않으면 기본값으로 상하좌우 32가 적용된다. 지도 범위 재설정 하기 샘플보기 bounds LatLngBounds paddingTop Number paddingRight Number paddingBottom Number paddingLeft Number 지도의 영역을 반환한다. 지도 정보 얻어오기 샘플보기 setMinLevel(minLevel) 지도의 최저 레벨 값을 설정한다. 기본적으로 레벨 값이 작을수록 지도는 확대되는데 이 함수로 설정한 레벨까지만 확대할 수 있게 된다. minLevel Number setMaxLevel(maxLevel) 지도의 최고 레벨 값을 설정한다. 기본적으로 레벨 값이 클수록 지도는 축소되는데 이 함수로 설정한 레벨까지만 축소할 수 있게 된다. maxLevel Number 중심 좌표를 지정한 픽셀 만큼 부드럽게 이동한다. 만약 이동할 거리가 지도 화면의 크기보다 클 경우 애니메이션 없이 이동한다. panTo(latlng_or_bounds[, padding]) 중심 좌표를 지정한 좌표 또는 영역으로 부드럽게 이동한다. 필요하면 확대 또는 축소도 수행한다. 만약 이동할 거리가 지도 화면의 크기보다 클 경우 애니메이션 없이 이동한다. 첫 번째 매개변수로 좌표나 영역을 지정할 수 있으며, 영역(bounds)을 지정한 경우에만 padding 옵션이 유효하다. padding 값을 지정하면 그 값만큼의 상하좌우 픽셀이 확보된 영역으로 계산되어 이동한다. padding의 기본값은 32. 지도 이동시키기 샘플보기 latlng_or_bounds LatLng | LatLngBounds jump(center, level, options) 지정한 중심좌표와 레벨로 지도를 이동시킨다. 만약 이동 거리가 큰 경우 타일 로딩이 생겨 순간적으로 투명 배경이 보일 수 있다. animate Boolean | Object : 지도 중심 좌표와 레벨 변경 시 애니메이션 효과 여부 duration Number : 애니메이션 효과 지속 시간 (단위: ms) duration Number : 애니메이션 효과 지속 시간 (단위: ms) addControl(control, position) 지도에 컨트롤을 추가한다. 지도에 컨트롤 올리기 샘플보기 control MapTypeControl | ZoomControl position ControlPosition removeControl(control) 지도에서 컨트롤을 제거한다. control MapTypeControl | ZoomControl setDraggable(draggable) 마우스 드래그와 모바일 터치를 이용한 지도 이동 가능 여부를 설정한다. 지도 이동 막기 샘플보기 draggable Boolean 마우스 드래그와 모바일 터치를 이용한 지도 이동 가능 여부를 반환한다. setZoomable(zoomable) 마우스 휠과 모바일 터치를 이용한 지도 확대, 축소 가능 여부를 설정한다. 지도 객체 함수 호출을 통한 확대, 축소는 동작한다. 지도 확대 축소 막기 샘플보기 zoomable Boolean 마우스 휠과 모바일 터치를 이용한 지도 확대, 축소 가능 여부를 반환한다. setProjectionId(projectionId) 지도의 projectionId를 지정한다. 이 메소드로 API 내부의 좌표계의 투영 방법을 설정할 수 있다. 기본값은 kakao.maps.ProjectionId. WCONG projectionId ProjectionId getProjectionId() 지도의 projectionId를 반환한다. 지도를 표시하는 HTML elemente의 크기를 변경한 후에는 반드시 이 함수를 호출해야 한다. 단, window의 resize 이벤트에 대해서는 자동으로 호출한다. 지도 영역 크기 동적 변경하기 샘플보기 addOverlayMapTypeId(mapTypeId) 지도에 로드뷰, 교통정보 등의 오버레이 타입의 타일 이미지를 올린다. 로드뷰 타일 이미지를 추가할 경우 RoadviewOverlay 와 동일한 기능을 수행한다. 지도에 교통정보 표시하기 샘플보기 지도에 로드뷰 도로 표시하기 샘플보기 지도에 지형도 표시하기 샘플보기 mapTypeId MapTypeId removeOverlayMapTypeId(mapTypeId) 지도에 로드뷰, 교통정보 등의 오버레이 타입의 타일 이미지를 삭제한다. mapTypeId MapTypeId setKeyboardShortcuts(active) 키보드의 방향키와 +,-키로 지도 이동,확대,축소 가능여부를 설정한다. getKeyboardShortcuts() 키보드의 방향키와 +,-키로 지도 이동,확대,축소 가능여부를 반환한다. setCopyrightPosition(copyrightPosition[, reversed]) copyright의 위치를 설정한다 copyrightPosition CopyrightPosition reversed Boolean getProjection() 지도의 좌표 변환 객체를 반환한다. setCursor(style) 지도 위에 마우스 커서가 위치할 경우 보여지는 커서의 스타일을 지정한다. 중심 좌표가 변경되면 발생한다. 중심좌표 변경 이벤트 등록하기 샘플보기 확대 수준이 변경되기 직전 발생한다. 확대 수준이 변경되면 발생한다. 확대, 축소 이벤트 등록하기 샘플보기 지도 영역이 변경되면 발생한다. 영역 변경 이벤트 등록하기 샘플보기 지도를 클릭하면 발생한다. 클릭 이벤트 등록하기 샘플보기 클릭한 위치에 마커 표시하기 샘플보기 지도를 더블클릭하면 발생한다. 지도를 마우스 오른쪽 버튼으로 클릭하면 발생한다. 지도에서 마우스 커서를 이동하면 발생한다. 드래그를 시작할 때 발생한다. 드래그를 하는 동안 발생한다. 드래그가 끝날 때 발생한다. 중심 좌표나 확대 수준이 변경되면 발생한다. 단, 애니메이션 도중에는 발생하지 않는다. 확대수준이 변경되거나 지도가 이동했을때 타일 이미지 로드가 모두 완료되면 발생한다. 지도이동이 미세하기 일어나 타일 이미지 로드가 일어나지 않은경우 발생하지 않는다. 타일로드 이벤트 등록하기 샘플보기 maptypeid_changed 지도 기본 타일(일반지도, 스카이뷰, 하이브리드)이 변경되면 발생한다. kakao . maps . event . addListener ( map , 'maptypeid_changed' , function () { // do something }); 일반 지도/하이브리드 간 지도 타입 전환 컨트롤을 생성한다. Map 객체의 addControl 또는 removeControl 메소드의 인자로 사용된다. 현재는 일반 지도/하이브리드 간 전환 컨트롤만 지원되며 다른 지도 타입을 제어하는 컨트롤이 필요할 경우에는 직접 구현해야 한다. 지도에 컨트롤 올리기 샘플보기 kakao.maps.MapTypeControl() 주어진 객체로 확대·축소 컨트롤을 생성한다. Map 객체의 addControl 또는 removeControl 메소드의 인자로 사용된다. 지도에 컨트롤 올리기 샘플보기 kakao.maps.ZoomControl() kakao.maps.MapTypeId 객체 kakao.maps.MapTypeId. MAP_TYPE_ID 지도의 타입이 상수 값으로 정의되어 있다. MAP_TYPE_ID 값으로 사용 가능한 목록은 다음과 같다. ROADMAP : 일반 지도 HYBRID : 하이브리드(스카이뷰 + 레이블) BICYCLE_HYBRID : 스카이뷰를 위한 자전거 (어두운 지도에서 활용) USE_DISTRICT : 지적편집도 지도의 타입은 용도에 따라 두 가지로 분류한다. 베이스 타입 : ROADMAP SKYVIEW HYBRID 오버레이 타입 : OVERLAY TERRAIN TRAFFIC BICYCLE BICYCLE_HYBRID USE_DISTRICT 기본 타일은 베이스 타입 을 사용한다. Map.setMapTypeId 함수를 통해 지정 가능하다. 기본 타일 위에 얹는 타일은 오버레이 타입 을 사용한다. Map.addOverlayMapTypeId 함수를 통해 지정한 타일을 지도 위에 올릴 수 있다. 그리고 Map.removeOverlayMapTypeId 함수로 언제든 올렸던 오버레이 타일을 걷어낼 수도 있다. 지적편집도 오버레이 타입은 현행 지적 정보와 일치하지 않을 수 있으며 참고 이외의 용도로 사용하실 수 없습니다. 지도 타입 바꾸기1 샘플보기 지도 타입 바꾸기2 샘플보기 kakao.maps.ProjectionId 객체 kakao.maps.ProjectionId. PROJECTION_ID 지도의 projectionId 값이 상수 값으로 정의되어 있다. PROJECTION_ID 값으로 사용 가능한 목록은 다음과 같다. NONE : 투영 없는 API 내부의 좌표계 자체. left-bottom을 (0,0)으로 하는 픽셀단위의 좌표계. WCONG : API 내부 좌표계를 WCongnamul좌표계로 투영. 외부에서 WCongnamul 좌표를 받아 사용가능. ControlPosition kakao.maps.ControlPosition 객체 kakao.maps.ControlPosition. CONTROL_POSITION 컨트롤 위치가 상수 값으로 정의되어 있다. CONTROL_POSITION 값으로 사용 가능한 목록은 다음과 같다. TOP : 위 가운데를 의미한다. 아래로 쌓인다. TOPLEFT : 왼쪽 위를 의미한다. 오른쪽으로 쌓인다. TOPRIGHT : 오른쪽 위를 의미한다. 왼쪽으로 쌓인다. LEFT : 왼쪽 위를 의미한다. 아래로 쌓인다. (주의: 왼쪽 중앙을 의미하는 것이 아니다.) RIGHT : 오른쪽 위를 의미한다. 아래로 쌓인다. (주의: 오른쪽 중앙을 의미하는 것이 아니다.) BOTTOMLEFT : 왼쪽 아래를 의미한다. 오른쪽으로 쌓인다. BOTTOM : 아래 가운데를 의미한다. 위로 쌓인다. BOTTOMRIGHT : 오른쪽 아래를 의미한다. 왼쪽으로 쌓인다. 다음과 같이 접근한다. kakao . maps . ControlPosition . TOPLEFT ; 지도 컨트롤 올리기 샘플보기 CopyrightPosition kakao.maps.CopyrightPosition 객체 kakao.maps.CopyrightPosition. COPYRIGHT_POSITION copyright의 위치가 상수값으로 정의되어 있다. COPYRIGHT_POSITION 값으로 사용 가능한 목록은 다음과 같다. BOTTOMLEFT : 왼쪽 아래를 의미한다. BOTTOMRIGHT : 오른쪽 아래를 의미한다. 다음과 같이 접근한다. kakao . maps . CopyrightPosition . BOTTOMRIGHT ; Tileset Static Methods 주어진 객체로 타일셋을 생성한다. 커스텀 타일셋1 샘플보기 커스텀 타일셋2 샘플보기 kakao.maps.Tileset(width, height, urlFunc, copyright, dark, minZoom, maxZoom) width Number : 타일의 가로 크기 height Number : 타일의 세로 크기 urlFunc Function : 타일 주소를 반환하는 함수. 세 개의 파라메터를 가진다. copyright Array.<TilesetCopyright> : 생성할 타일의 카피라이트(기본값: []) dark Boolean : 어두운 타일인지 여부 minZoom Number : 최소 레벨 maxZoom Number : 최대 레벨 getTile Function : 타일 Element를 반환하는 함수. 세개의 파라미터를 가진다. urlFunc 옵션 대신 사용한다. add(id, tileset) 타일셋에 ID를 지정해 추가한다. 추가되면 kakao.maps.[지정한ID] 로 타일셋을 사용할 수 있다. id String : 지정할 타일셋의 ID tileset Tileset : 생성한 Tileset 객체 TilesetCopyright 주어진 객체로 타일셋 카피라이트를 생성한다. kakao.maps.TilesetCopyright(msg, shortMsg, minZoom) msg String : 기본적으로 출력되는 카피라이트 shortMsg String : 지도 영역이 작아졌을 때 출력되는 짧은 카피라이트 minZoom Number : 해당 카피라이트가 노출될 최소 줌 레벨(기본값: 0) Wcongnamul 좌표 정보를 가지고 있는 객체를 생성한다. kakao.maps.Coords(x, y) x Number : x 좌표 y Number : y 좌표 객체가 가지고 있는 좌표와 같은 좌표를 가지고 있는 객체인지 비교한다. 객체가 가지고 있는 좌표를 문자열로 반환한다. 객체가 가지고 있는 좌표를 WGS84 좌표로 반환한다. var coords = new kakao . maps . Coords ( 400207.5 , - 11710 ); coords . toLatLng (). toString (); // (33.45067375096625, 126.5706721005115) WGS84 좌표 정보를 가지고 있는 객체를 생성한다. kakao.maps.LatLng(latitude, longitude) latitude Number : 위도 longitude Number : 경도 객체가 가지고 있는 좌표와 같은 좌표를 가지고 있는 객체인지 비교한다. 객체가 가지고 있는 좌표를 문자열로 반환한다. 객체가 가지고 있는 좌표를 Wcongnamul 좌표로 반환한다. LatLngBounds Methods WGS84 좌표계에서 사각영역 정보를 표현하는 객체를 생성한다. 지도 범위 재설정 하기 샘플보기 kakao.maps.LatLngBounds(sw, ne) sw LatLng : 사각 영역에서 남서쪽 좌표 ne LatLng : 사각 영역에서 북동쪽 좌표 equals(latlngBounds) 객체가 가지고 있는 영역 정보와 같은 영역 정보를 가지고 있는 객체인지 비교한다. latlngBounds LatLngBounds 객체가 가지고 있는 영역 정보를 문자열로 반환한다. 영역의 남서쪽 좌표를 반환한다. 영역의 북동쪽 좌표를 반환한다. 영역 정보가 비어있는지 확인한다. 인수로 주어진 좌표를 포함하도록 영역 정보를 확장한다. contain(latlng) 영역 객체가 인수로 주어진 좌표를 포함하는지 확인한다. 화면 좌표(픽셀 단위) 정보를 담고 있는 객체 kakao.maps.Point(x, y) 화면 좌표 정보를 담고 있는 포인트 객체를 생성한다. 포인트 객체와 같은 좌표를 가지고 있는 객체인지 비교한다. 포인트 객체가 가지고 있는 좌표를 문자열로 반환한다. 크기 정보(픽셀 단위)를 담고 있는 객체 kakao.maps.Size(width, height) 크기 정보를 담고 있는 사이즈 객체를 생성한다. 사이즈 객체가 가지고 있는 크기와 같은 크기를 가지고 있는 객체인지 비교한다. 사이즈 객체가 가지고 있는 크기를 문자열로 반환한다. event Static Methods 지도 객체의 이벤트 관련 함수를 담은 네임스페이스 addListener(target, type, handler) 다음 지도 API 객체에 이벤트를 등록한다. target EventTarget : 이벤트를 지원하는 다음 지도 API 객체 type String : 이벤트 이름 handler Function : 이벤트를 처리할 함수 removeListener(target, type, handler) 다음 지도 API 객체에 등록된 이벤트를 제거한다. target EventTarget : 이벤트를 지원하는 다음 지도 API 객체 type String : 이벤트 이름 handler Function : 이벤트를 처리하던 함수 trigger(target, type, data) 다음 지도 API 객체에 등록된 이벤트를 발생시킨다. target EventTarget : 이벤트를 지원하는 다음 지도 API 객체 type String : 이벤트 이름 data * : 이벤트를 처리하는 함수에 넘길 변수 다음 Map 객체의 이벤트를 막는다. 보통 CustomOverlay의 content 혹은 외부 Element의 이벤트 핸들러에서 지도의 이벤트를 막고 싶을 경우 사용한다. 이벤트의 핸들러 내부에서 이 함수를 사용하며, 이벤트의 핸들링이 끝나면 Map 객체의 이벤트는 다시 정상 동작하게 된다. 마우스 이벤트로 넘겨 받는 인자 직접 생성할 수는 없으며 이벤트 핸들러에서 내부적으로 생성된 객체를 parameter로 받아 사용한다. Marker Methods Events kakao.maps.Marker(options) 주어진 객체로 마커를 생성한다. 지도 뿐만 아니라 로드뷰 위에도 올릴 수 있다. 마커 생성하기 샘플보기 로드뷰에 마커와 인포윈도우 올리기 샘플보기 마커의 고도와 반경 조절하기 샘플보기 options Object map Map | Roadview : 마커가 올라갈 지도 또는 로드뷰 position LatLng | Viewpoint : 마커의 좌표 또는 로드뷰에서의 시점 image MarkerImage : 마커의 이미지 title String : 마커 엘리먼트의 타이틀 속성 값 (툴팁) draggable Boolean : 드래그 가능한 마커, 로드뷰에 올릴 경우에는 유효하지 않다 clickable Boolean : 클릭 가능한 마커 zIndex Number : 마커 엘리먼트의 z-index 속성 값 opacity Number : 마커 투명도 (0-1) altitude Number : 로드뷰에 올라있는 마커의 높이 값(m 단위) range Number : 로드뷰 상에서 마커의 가시반경(m 단위), 두 지점 사이의 거리가 지정한 값보다 멀어지면 마커는 로드뷰에서 보이지 않게 된다 map Map | Roadview : 마커가 올라갈 지도 또는 로드뷰 position LatLng | Viewpoint : 마커의 좌표 또는 로드뷰에서의 시점 image MarkerImage : 마커의 이미지 title String : 마커 엘리먼트의 타이틀 속성 값 (툴팁) draggable Boolean : 드래그 가능한 마커, 로드뷰에 올릴 경우에는 유효하지 않다 clickable Boolean : 클릭 가능한 마커 zIndex Number : 마커 엘리먼트의 z-index 속성 값 opacity Number : 마커 투명도 (0-1) altitude Number : 로드뷰에 올라있는 마커의 높이 값(m 단위) range Number : 로드뷰 상에서 마커의 가시반경(m 단위), 두 지점 사이의 거리가 지정한 값보다 멀어지면 마커는 로드뷰에서 보이지 않게 된다 setMap(map_or_roadview) 지도 또는 로드뷰에 마커를 올린다. null 을 지정하면 마커를 제거한다. 마커 생성하기 샘플보기 여러개 마커 제어하기 샘플보기 map_or_roadview Map | Roadview 마커가 올라가있는 지도를 반환한다. setImage(image) 마커에 새 MarkerImage를 지정한다. 다른 이미지로 마커 생성하기 샘플보기 image MarkerImage 마커의 MarkerImage를 반환한다. setPosition(position) 마커의 좌표를 지정한다. 로드뷰의 특정 시점에 고정하기 위해서 Viewpoint 객체를 사용할 수도 있다. panoId를 지정한 Viewpoint 를 사용하면 panoId에 해당하는 로드뷰 위치에서만 보이게 된다. position LatLng | Viewpoint setZIndex(zIndex) 마커의 z-index를 설정한다. 마커의 z-index를 반환한다. setVisible(visible) 마커의 표시 여부를 지정한다. visible Boolean 마커의 표시 여부를 반환한다. setTitle(title) setDraggable(draggable) 드래그 가능 여부를 지정한다. 로드뷰에 올라가 있을 경우에는 마커의 드래그 기능을 비활성화 되기 때문에 지도에 올라가 있을 경우에만 의미가 있다. draggable Boolean 드래그 가능 여부를 반환한다. setClickable(clickable) 클릭 가능 여부를 지정한다. true 로 지정하게 되면 마커를 클릭 했을 때, 지도의 클릭 이벤트가 발생하지 않도록 막아준다. clickable Boolean 클릭 가능 여부를 반환한다. setAltitude(altitude) 로드뷰상에서 마커의 높이(위치)를 지정한다. 단위는 m(미터)이며 현재 로드뷰의 바닥 높이를 기준으로 떨어져있는 높이를 말한다. altitude Number 현재 보고있는 시점이 지면으로부터 약 1.7m 떨어져 있다고 가정하고 지면의 높이값을 0으로 계산한다. 때문에 높이값이 정확하지 않을 수 있다. 또한 로드뷰를 찍은 위치의 정보(해발 고도, 기울어짐)는 고려하지 않기 때문에 마커가 찍힌 위치가 어색하거나 부정확할 수 있다. 보통은 2층 이상에 존재하는 장소를 로드뷰에 대략적으로 표시하기 위해서 사용한다. 마커의 높이(위치)를 반환한다. 단위는 m(미터). setRange(range) 마커의 가시반경을 설정한다. 로드뷰의 위치와 마커의 위치 사이의 거리가 가시반경 이내일 경우에만 로드뷰상에 노출된다. 단위는 m(미터)이며 기본값은 500m이다. 마커의 가시반경을 반환한다. 단위는 m(미터). setOpacity(opacity) 마커를 클릭하면 발생한다. 마커에 클릭 이벤트 등록하기 샘플보기 마커에 마우스 커서를 올리면 발생한다. 마커에 마우스 이벤트 등록하기 샘플보기 마우스 커서가 마커에서 벗어나면 발생한다. 마커에 마우스 이벤트 등록하기 샘플보기 마커를 오른쪽 버튼으로 클릭하면 발생한다. 드래그를 시작하면 발생한다. draggable 마커 이벤트 적용하기 샘플보기 드래그를 종료하면 발생한다. draggable 마커 이벤트 적용하기 샘플보기 기본 마커가 아닌, 별도의 이미지를 이용하여 마커를 만들기 위한 이미지 생성 객체 다른 이미지로 마커 생성하기 샘플보기 다양한 이미지 마커 표시하기 샘플보기 kakao.maps.MarkerImage(src, size[, options]) 마커에 사용할 이미지를 생성한다. 세 번째 파라메터로 offset을 사용할 경우 네 번째 파라메터로 shape, 다섯 번째 파라메터로 coords를 넣을 수 있다. src String : 이미지 주소 size Size : 마커의 크기 options Obejct alt String : 마커 이미지의 alt 속성값을 정의한다. coords String : 마커의 클릭 또는 마우스오버 가능한 영역을 표현하는 좌표값 offset Point : 마커의 좌표에 일치시킬 이미지 안의 좌표 (기본값: 이미지의 가운데 아래) shape String : 마커의 클릭 또는 마우스오버 가능한 영역의 모양 spriteOrigin Point : 스프라이트 이미지 중 사용할 영역의 좌상단 좌표 spriteSize Size : 스프라이트 이미지의 전체 크기 alt String : 마커 이미지의 alt 속성값을 정의한다. coords String : 마커의 클릭 또는 마우스오버 가능한 영역을 표현하는 좌표값 offset Point : 마커의 좌표에 일치시킬 이미지 안의 좌표 (기본값: 이미지의 가운데 아래) shape String : 마커의 클릭 또는 마우스오버 가능한 영역의 모양 spriteOrigin Point : 스프라이트 이미지 중 사용할 영역의 좌상단 좌표 spriteSize Size : 스프라이트 이미지의 전체 크기 옵션으로 지정한 shape와 coords의 값은 각각 실제 HTML에서 <area>의 shape와 coords 속성에 대응한다. 예를 들어 설명하자면 아래와 같다. 아래의 이미지로 MarkerImage를 만들어 보자. 이미지의 크기는 31×35이다. 추가 옵션없이 생성해보자. var icon = new kakao . maps . MarkerImage ( 'https://i1.daumcdn.net/dmaps/apis/n_local_blit_04.png' , new kakao . maps . Size ( 31 , 35 )); 이렇게 만들어진 MarkerImage의 HTML 마크업을 단순화하면 다음과 같다. // Result < img width = "31" height = "35" src = "https://i1.daumcdn.net/dmaps/apis/n_local_blit_04.png" alt = "" > 이 MarkerImage로 생성한 Marker에 클릭 이벤트를 등록하면 이미지 크기에 해당하는 영역 전체에서 클릭 이벤트가 발생한다. 다음과 같은 특정 영역에서만 클릭 이벤트가 발생하도록 해 보자. 옵션으로 shape와 coords값을 주어 MarkerImage를 만든다. var icon = new kakao . maps . MarkerImage ( 'https://i1.daumcdn.net/dmaps/apis/n_local_blit_04.png' , new kakao . maps . Size ( 31 , 35 ), { shape : 'poly' , coords : '16,0,20,2,24,6,26,10,26,16,23,22,17,25,14,35,13,35,9,25,6,24,2,20,0,16,0,10,2,6,6,2,10,0' }); 위의 코드로 만들어진 HTML 마크업의 대략적인 구조는 다음과 같다. // Result < img width = "31" height = "35" src = "https://i1.daumcdn.net/dmaps/apis/n_local_blit_04.png" alt = "" usemap = "#Marker" > < map name = "Marker" > < area alt = "" shape = "poly" coords = "16,0,20,2,24,6,26,10,26,16,23,22,17,25,14,35,13,35,9,25,6,24,2,20,0,16,0,10,2,6,6,2,10,0" > </ map > 위와 같이 생성된 Marker는 아래 그림에서 보이는 푸른색 영역에서만 클릭 이벤트가 발생한다. 자세한 내용은 Image Maps 관련 W3C 문서 를 참조한다. InfoWindow Methods kakao.maps.InfoWindow(options) 주어진 객체로 인포윈도우를 생성한다. 지도 뿐만 아니라 로드뷰 위에도 올릴 수 있다. 인포윈도우 생성하기 샘플보기 로드뷰에 마커와 인포윈도우 올리기 샘플보기 마커의 고도와 반경 조절하기 샘플보기 options Object content Node | String : 엘리먼트 또는 HTML 문자열 형태의 내용 disableAutoPan Boolean : 인포윈도우를 열 때 지도가 자동으로 패닝하지 않을지의 여부 (기본값: false) map Map | Roadview : 인포윈도우가 올라갈 지도 또는 로드뷰 position LatLng : 인포윈도우의 좌표 removable Boolean : 삭제 가능한 인포윈도우 zIndex Number : 인포윈도우 엘리먼트의 z-index 속성 값 altitude Number : 로드뷰에 올라있는 인포윈도우의 높이 값(m 단위) range Number : 로드뷰 상에서 인포윈도우의 가시반경(m 단위), 두 지점 사이의 거리가 지정한 값보다 멀어지면 인포윈도우는 보이지 않게 된다 content Node | String : 엘리먼트 또는 HTML 문자열 형태의 내용 disableAutoPan Boolean : 인포윈도우를 열 때 지도가 자동으로 패닝하지 않을지의 여부 (기본값: false) map Map | Roadview : 인포윈도우가 올라갈 지도 또는 로드뷰 position LatLng : 인포윈도우의 좌표 removable Boolean : 삭제 가능한 인포윈도우 zIndex Number : 인포윈도우 엘리먼트의 z-index 속성 값 altitude Number : 로드뷰에 올라있는 인포윈도우의 높이 값(m 단위) range Number : 로드뷰 상에서 인포윈도우의 가시반경(m 단위), 두 지점 사이의 거리가 지정한 값보다 멀어지면 인포윈도우는 보이지 않게 된다 open(map_or_roadview [, marker]) 지도에 인포윈도우를 올린다. marker가 주어지면, 해당 마커에서 열린 효과를 낸다. 로드뷰에서도 같은 동작을 한다. 마커에 인포윈도우 표시하기 샘플보기 map_or_roadview Map | Roadview 인포윈도우가 올라가있는 지도를 반환한다. setPosition(position) 인포윈도우의 좌표를 지정한다. 로드뷰의 특정 시점에 고정하기 위해서 Viewpoint 객체를 사용할 수도 있다. panoId를 지정한 Viewpoint 를 사용하면 panoId에 해당하는 로드뷰 위치에서만 보이게 된다. position LatLng | Viewpoint 인포윈도우의 좌표를 반환한다. setContent(content) 인포윈도우의 내용을 지정한다. 엘리먼트 또는 HTML 문자열을 지정할 수 있다. content Node | String 인포윈도우의 내용을 지정했던 형태로 반환한다. setZIndex(zIndex) 인포윈도우의 z-index를 설정한다. 인포윈도우의 z-index를 반환한다. setAltitude(altitude) 로드뷰상에서 인포윈도우의 높이(위치)를 지정한다. 단위는 m(미터)이며 현재 로드뷰의 바닥 높이를 기준으로 떨어져있는 높이를 말한다. altitude Number 현재 보고있는 시점이 지면으로부터 약 1.7m 떨어져 있다고 가정하고 지면의 높이값을 0으로 계산한다. 때문에 높이값이 정확하지 않을 수 있다. 또한 로드뷰를 찍은 위치의 정보(해발 고도, 기울어짐)는 고려하지 않기 때문에 인포윈도우가 찍힌 위치가 어색하거나 부정확할 수 있다. 보통은 로드뷰에 보이는 2층 이상의 장소정보를 대략적으로 표시하기 위해서 사용한다. 인포윈도우의 높이(위치)를 반환한다. 단위는 m(미터). setRange(range) 인포윈도우의 가시반경을 설정한다. 로드뷰의 위치와 인포윈도우의 위치 사이의 거리가 가시반경 이내일 경우에만 로드뷰상에 노출된다. 단위는 m(미터)이며 기본값은 500m이다. 인포윈도우의 가시반경을 반환한다. 단위는 m(미터). CustomOverlay Methods 커스텀한 엘리먼트를 담아 지도위에 올릴 수 있는 오버레이 객체. Infowindow 보다는 담을 수 있는 컨텐츠가 자유롭고 AbstractOverlay 보다 사용하기 쉽다는 장점이 있다. kakao.maps.CustomOverlay(options) 주어진 객체로 커스텀 오버레이를 생성한다. 지도 뿐만 아니라 로드뷰 위에도 올릴 수 있다. 커스텀 오버레이 생성하기1 샘플보기 커스텀 오버레이 생성하기2 샘플보기 로드뷰에 커스텀 오버레이 올리기 샘플보기 로드뷰에 이미지 올리기 샘플보기 커스텀오버레이를 드래그 하기 샘플보기 options Object clickable Boolean : true 로 설정하면 컨텐츠 영역을 클릭했을 경우 지도 이벤트를 막아준다. content Node | String : 엘리먼트 또는 HTML 문자열 형태의 내용 map Map | Roadview : 커스텀 오버레이가 올라갈 지도 또는 로드뷰 position LatLng | Viewpoint : 커스텀 오버레이의 좌표 또는 로드뷰에서의 시점 xAnchor Number : 컨텐츠의 x축 위치. 0_1 사이의 값을 가진다. 기본값은 0.5 yAnchor Number : 컨텐츠의 y축 위치. 0_1 사이의 값을 가진다. 기본값은 0.5 zIndex Number : 커스텀 오버레이의 z-index clickable Boolean : true 로 설정하면 컨텐츠 영역을 클릭했을 경우 지도 이벤트를 막아준다. content Node | String : 엘리먼트 또는 HTML 문자열 형태의 내용 map Map | Roadview : 커스텀 오버레이가 올라갈 지도 또는 로드뷰 position LatLng | Viewpoint : 커스텀 오버레이의 좌표 또는 로드뷰에서의 시점 xAnchor Number : 컨텐츠의 x축 위치. 0_1 사이의 값을 가진다. 기본값은 0.5 yAnchor Number : 컨텐츠의 y축 위치. 0_1 사이의 값을 가진다. 기본값은 0.5 zIndex Number : 커스텀 오버레이의 z-index setMap(map_or_roadview) 지도 또는 로드뷰에 커스텀 오버레이를 올린다. null 을 지정하면 오버레이를 제거한다. map_or_roadview Map | Roadview 커스텀 오버레이가 올라가있는 지도를 반환한다. setPosition(position) 커스텀 오버레이의 좌표를 지정한다. 로드뷰의 특정 시점에 고정하기 위해서 Viewpoint 객체를 사용할 수도 있다. panoId를 지정한 Viewpoint 를 사용하면 panoId에 해당하는 로드뷰 위치에서만 보이게 된다. position LatLng | Viewpoint 커스텀 오버레이의 좌표를 반환한다. setContent(content) 커스텀 오버레이의 내용을 지정한다. 엘리먼트 또는 HTML 문자열을 지정할 수 있다. content Node | String 커스텀 오버레이의 내용을 지정했던 형태로 반환한다. setVisible(visible) 커스텀 오버레이의 표시 여부를 지정한다. visible Boolean 커스텀 오버레이의 표시 여부를 반환한다. setZIndex(zIndex) 커스텀 오버레이의 z-index를 설정한다. 커스텀 오버레이의 z-index를 반환한다. setAltitude(altitude) 로드뷰상에서 커스텀 오버레이의 높이(위치)를 지정한다. 단위는 m(미터)이며 현재 로드뷰의 바닥 높이를 기준으로 떨어져있는 높이를 말한다. altitude Number 현재 보고있는 시점이 지면으로부터 약 1.7m 떨어져 있다고 가정하고 지면의 높이값을 0으로 계산한다. 때문에 높이값이 정확하지 않을 수 있다. 또한 로드뷰를 찍은 위치의 정보(해발 고도, 기울어짐)는 고려하지 않기 때문에 커스텀 오버레이가 찍힌 위치가 어색하거나 부정확할 수 있다. 보통은 2층 이상에 존재하는 장소를 로드뷰에 대략적으로 표시하기 위해서 사용한다. 커스텀 오버레이의 높이(위치)를 반환한다. 단위는 m(미터). setRange(range) 커스텀 오버레이의 가시반경을 설정한다. 로드뷰의 위치와 커스텀 오버레이의 위치 사이의 거리가 가시반경 이내일 경우에만 로드뷰상에 노출된다. 단위는 m(미터)이며 기본값은 500m이다. 커스텀 오버레이의 가시반경을 반환한다. 단위는 m(미터). AbstractOverlay Methods kakao.maps.AbstractOverlay() API 사용자가 직접 정의할 수 있는 오버레이. AbstractOverlay를 상속 받아 사용할 객체를 생성하고 prototype을 연결해 준다. 온전히 동작하는 오버레이를 만들고자 한다면 3가지 인터페이스 메소드( onAdd , draw , onRemove )를 구현해야 한다. 지도 영역 밖의 마커위치 추적하기 샘플보기 위치를 재조정할 필요가 있을 때 호출된다. 이 함수 내에서 엘리먼트의 위치를 잡아주어야 한다. 지도에 올릴 때 호출된다. setMap(map) 을 실행하면 이 함수가 실행된다. 이 함수 내에서 생성된 DOM 객체를 MapPanels에 자식 노드로 넣어주도록 한다. 지도에서 제거할 때 호출된다. setMap(null) 을 실행하면 이 함수가 실행된다. 이 함수 내에서 MapPanels에 자식 노드로 넣어준 엘리먼트를 제거하도록 한다. 지도에 사용자 오버레이를 올린다. null 을 지정하면 오버레이를 제거한다. 사용자 오버레이가 올라가있는 지도를 반환한다. 붙어있는 지도의 패널을 반환한다. getProjection() 붙어있는 지도의 좌표 변환 객체를 반환한다. 지도의 패널을 담당하는 객체. 오버레이를 올릴 수 있는 HTML 엘리먼트 MapProjection Methods 지도와 화면 사이의 좌표 변환을 담당한다. 지도 또는 지도에 올라온 오버레이 객체가 가진 getProjection() 메소드로 얻을 수 있다. 별도의 생성자는 제공하지 않는다. pointFromCoords(latlng) 지도 좌표에 해당하는 위치 좌표(pixel)를 반환한다. 해당 위치 좌표는 지도 엘리먼트 내부의 레이어 위치를 반영한 좌표이다. 지도 영역 밖의 마커위치 추적하기 샘플보기 coordsFromPoint(point) 위치 좌표(pixel)에 해당하는 지도 좌표를 반환한다. 해당 위치 좌표는 지도 엘리먼트 내부의 타일 레이어 위치를 반영한 좌표이다. 지도 영역 밖의 마커위치 추적하기 샘플보기 containerPointFromCoords(latlng) 지도 좌표에 해당하는 화면 좌표(pixel)를 반환한다. 해당 화면 좌표는 지도 엘리먼트의 좌상단을 기준으로 한 좌표이다. 커스텀오버레이를 드래그 하기 샘플보기 coordsFromContainerPoint(point) 화면 좌표(pixel)에 해당하는 지도 좌표를 반환한다. 해당 화면 좌표는 지도 엘리먼트의 좌상단을 기준으로 한 좌표이다. 커스텀오버레이를 드래그 하기 샘플보기 Polyline Methods Events kakao.maps.Polyline(options) 주어진 객체로 폴리라인을 생성한다. 원, 선, 사각형, 다각형 표시하기 샘플보기 options Object endArrow Boolean : 화살표 여부 path Array.< LatLng > | Array.<Array.< LatLng >> : 폴리라인을 구성하는 좌표의 배열 또는 좌표 배열의 배열 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 선의 z-index 속성 값 endArrow Boolean : 화살표 여부 path Array.< LatLng > | Array.<Array.< LatLng >> : 폴리라인을 구성하는 좌표의 배열 또는 좌표 배열의 배열 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 선의 z-index 속성 값 지도에 폴리라인을 올린다. null 을 지정하면 폴리라인을 제거한다. 폴리라인이 올라가있는 지도를 반환한다. setOptions(options) 폴리라인의 옵션을 설정한다. options : Object 폴리라인의 경로를 지정한다. 경로는 좌표의 배열로 표현한다. path : Array.< LatLng > : 좌표의 배열 폴리라인의 경로를 반환한다. Array.< LatLng > 폴리라인의 총 길이를 m(미터)단위로 반환한다. 선의 거리 계산하기 샘플보기 폴리라인의 z-index를 설정한다. 폴리라인의 z-index를 반환한다. 안드로이드 2.3버전 이하에서는 Event를 지원하지 않습니다. 폴리라인에 마우스 커서를 올리면 발생한다. 마우스 커서가 폴리라인에서 벗어나면 발생한다. 폴리라인에서 마우스가 움직이면 발생한다. 폴리라인에서 마우스 버튼을 누르면 발생한다. 폴리라인을 클릭하면 발생한다 Polygon Methods Events kakao.maps.Polygon(polygonOptions) 주어진 객체로 다각형을 생성한다. 원, 선, 사각형, 다각형 표시하기 샘플보기 구멍난 다각형 만들기 샘플보기 options Object fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) path Array.< LatLng > | Array.<Array.< LatLng >> : 다각형을 구성하는 좌표의 배열 혹은 좌표 배열의 배열 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 다각형의 z-index 속성 값 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) path Array.< LatLng > | Array.<Array.< LatLng >> : 다각형을 구성하는 좌표의 배열 혹은 좌표 배열의 배열 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 다각형의 z-index 속성 값 지도에 다각형을 올린다. null 을 지정하면 다각형을 제거한다. 다각형이 올라가있는 지도를 반환한다. setOptions(options) 다각형의 경로를 지정한다. 경로는 좌표의 배열로 표현한다. path Array.< LatLng > : 좌표의 배열 Array.< LatLng > 다각형의 총 길이를 m(미터)단위로 반환한다. 다각형으로 둘러싸인 영역의 넓이를 ㎡(제곱미터)단위로 반환한다. 다각형의 z-index를 설정한다. 다각형의 z-index를 반환한다. 안드로이드 2.3버전 이하에서는 Event를 지원하지 않습니다. 다각형에 마우스 커서를 올리면 발생한다. 다각형에 이벤트 등록하기1 샘플보기 다각형에 이벤트 등록하기2 샘플보기 마우스 커서가 다각형에서 벗어나면 발생한다. 다각형에 이벤트 등록하기1 샘플보기 다각형에 이벤트 등록하기2 샘플보기 다각형에서 마우스를 움직이면 발생한다. 다각형에 이벤트 등록하기2 샘플보기 다각형에서 마우스 버튼을 누르면 발생한다. 다각형에 이벤트 등록하기1 샘플보기 다각형에 이벤트 등록하기2 샘플보기 다각형을 클릭하면 발생한다. 다각형에 이벤트 등록하기2 샘플보기 Circle Methods Events kakao.maps.Circle(options) 주어진 객체로 원을 생성한다. 원, 선, 사각형, 다각형 표시하기 샘플보기 options Object center LatLng : 중심 좌표 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) radius Number : 미터 단위의 반지름 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 원의 z-index 속성 값 center LatLng : 중심 좌표 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) radius Number : 미터 단위의 반지름 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 원의 z-index 속성 값 지도에 원을 올린다. null 을 지정하면 원을 제거한다. 원이 올라가있는 지도를 반환한다. setOptions(options) setPosition(position) 원의 중심 좌표를 지정한다. position LatLng 원 중심의 좌표를 반환한다. setRadius(radius) 원의 반지름을 m(미터)단위로 지정한다. 원을 포함하는 최소의 사각형 영역을 구한다. 원의 z-index를 설정한다. 원의 z-index를 반환한다. 안드로이드 2.3버전 이하에서는 Event를 지원하지 않습니다. 원에 마우스 커서를 올리면 발생한다.

마우스 커서가 원에서 벗어나면 발생한다. 원에서 마우스를 움직이면 발생한다. 원에서 마우스 버튼을 누르면 발생한다. Ellipse Methods Events kakao.maps.Ellipse(options) 주어진 객체로 타원을 생성한다. options Object center LatLng : 중심 좌표 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) rx Number : 미터 단위의 x축 반지름 ry Number : 미터 단위의 y축 반지름 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 타원의 z-index 속성 값 center LatLng : 중심 좌표 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) rx Number : 미터 단위의 x축 반지름 ry Number : 미터 단위의 y축 반지름 strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 타원의 z-index 속성 값 지도에 타원을 올린다. null 을 지정하면 타원을 제거한다. 타원이 올라가있는 지도를 반환한다. setOptions(options) setPosition(position) 타원의 중심 좌표를 지정한다. position LatLng 타원 중심의 좌표를 반환한다. setRadius(rx, ry) 타원의 반지름을 m(미터)단위로 지정한다. 타원의 x, y축 반지름을 반환한다. Object rx Number : x축 반지름 ry Number : y축 반지름 rx Number : x축 반지름 ry Number : y축 반지름 타원의 x축 반지름을 반환한다. 타원의 y축 반지름을 반환한다. 타원을 포함하는 최소의 사각형 영역을 구한다. 타원의 z-index를 설정한다. 타원의 z-index를 반환한다. 안드로이드 2.3버전 이하에서는 Event를 지원하지 않습니다. 타원에 마우스 커서를 올리면 발생한다. 마우스 커서가 타원에서 벗어나면 발생한다. 타원에서 마우스를 움직이면 발생한다. 타원에서 마우스 버튼을 누르면 발생한다. Rectangle Methods Events kakao.maps.Rectangle(options) 주어진 객체로 사각형를 생성한다. 원, 선, 사각형, 다각형 표시하기 샘플보기 options Object bounds LatLngBounds : 사각형의 영역 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 사각형의 z-index 속성 값 bounds LatLngBounds : 사각형의 영역 fillColor String : #xxxxxx 형태의 채움 색 (기본값: ‘#F10000’) fillOpacity Number : 채움 불투명도 (0-1) (기본값: 0) strokeWeight Number : 픽셀 단위의 선 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선 불투명도 (0-1) (기본값: 0.6) strokeStyle String : 선 스타일 (기본값: ‘solid’) zIndex Number : 사각형의 z-index 속성 값 지도에 사각형을 올린다. null 을 지정하면 사각형을 제거한다. 사각형이 올라가있는 지도를 반환한다. setOptions(options) setBounds(bounds) bounds LatLngBounds 사각형의 z-index를 설정한다. 사각형의 z-index를 반환한다. 안드로이드 2.3버전 이하에서는 Event를 지원하지 않습니다. 사각형에 마우스 커서를 올리면 발생한다. 마우스 커서가 사각형에서 벗어나면 발생한다. 사각형에서 마우스를 움직이면 발생한다. 사각형에서 마우스 버튼을 누르면 발생한다. 사각형을 클릭하면 발생한다. Roadview Methods Events kakao.maps.Roadview(container[, options]) 주어진 객체로 로드뷰를 생성한다. options로 넣을 수 있는 속성들 중 pan, tilt, zoom, jsNamespace는 PC와 모바일 공통이다. 그 외의 속성들은 PC에서만 사용 가능하다. 각종 오버레이 객체도 올릴 수 있다. 로드뷰 생성하기 샘플보기 로드뷰 도로를 이용하여 로드뷰 생성하기 샘플보기 로드뷰에 커스텀 오버레이 올리기 샘플보기 container Node : 로드뷰를 생성할 엘리먼트 options Object panoId Number : 로드뷰 시작 지역의 고유 아이디 값. panoX Number : panoId가 유효하지 않을 경우 지도좌표를 기반으로 데이터를 요청할 수평 좌표값. panoY Number : panoId가 유효하지 않을 경우 지도좌표를 기반으로 데이터를 요청할 수직 좌표값. pan Number : 로드뷰 처음 실행시에 바라봐야 할 수평 각. 0이 정북방향. (0_360) tilt Number : 로드뷰 처음 실행시에 바라봐야 할 수직 각.(-90_90) zoom Number : 로드뷰 줌 초기값.(-3_3) disableZoomControl Boolean : 로드뷰 줌/방위 컨트롤러 비활성화 여부.(기본값: false) panoId Number : 로드뷰 시작 지역의 고유 아이디 값. panoX Number : panoId가 유효하지 않을 경우 지도좌표를 기반으로 데이터를 요청할 수평 좌표값. panoY Number : panoId가 유효하지 않을 경우 지도좌표를 기반으로 데이터를 요청할 수직 좌표값. pan Number : 로드뷰 처음 실행시에 바라봐야 할 수평 각. 0이 정북방향. (0_360) tilt Number : 로드뷰 처음 실행시에 바라봐야 할 수직 각.(-90_90) zoom Number : 로드뷰 줌 초기값.(-3_3) disableZoomControl Boolean : 로드뷰 줌/방위 컨트롤러 비활성화 여부.(기본값: false) setPanoId(panoId, position) 파노라마 ID를 지정한다. 지도 좌표도 함께 넘겨야 한다. position LatLng setViewpoint(viewpoint) viewpoint Viewpoint Viewpoint pan Number tilt Number zoom Number getViewpointWithPanoId() 로드뷰 시점과panoId를 함께 반환한다. Viewpoint pan Number tilt Number zoom Number panoId Number 로드뷰가 보여주는 지점의 지도 좌표를 반환한다. 로드뷰 엘리먼트의 크기를 변경한 후에는 반드시 이 함수를 호출해야 한다. 플래시 로드뷰는 자동으로 영역을 잡는 경우가 있으나 모바일 로드뷰는 꼭 호출하도록 하자. 단, window의 resize 이벤트에 대해서는 자동으로 호출된다. 로드뷰가 초기화를 끝내면 발생한다. 파노라마 ID가 바뀌면 발생한다. viewpoint_changed 시점이 바뀌면 발생한다. 동동이를 이용하여 로드뷰와 지도 연동하기 샘플보기 position_changed 지도 좌표가 바뀌면 발생한다. RoadviewClient Methods 로드뷰의 데이터를 다루는 객체 kakao.maps.RoadviewClient() 특정 좌표 근처의 파노라마 ID 등 로드뷰와 관련된 데이터를 다룬다. getNearestPanoId(position, radius, callback) 특정 좌표에서 반경 내 가장 가까운 로드뷰 파노라마 ID를 구한다. position LatLng : 좌표 radius Number : 반경(미터 단위) callback Function : 첫 번째 인자로 파노라마 ID가 넘어온다. 결과가 없으면 null 이 반환된다. RoadviewOverlay Methods 로드뷰가 존재하는 경로를 표시하는 선이 그려진 오버레이 kakao.maps.RoadviewOverlay() 지도 위에 로드뷰 선이 그려진 타일을 올린다. 지도에 로드뷰 선을 그린다. null 을 지정하면 선을 제거한다. 로드뷰 선이 그려져있는 지도를 반환한다. #yaml 블럭의 id값은 prefix(doc_)을 제외한 파일명과 동일하게 해주세요. #grunt make.doc 명령어로 파일을 생성하였다면 자동으로 맞춰집니다. 로드뷰의 시점 정보를 담고 있는 객체를 생성한다. kakao.maps.Viewpoint(pan, tilt, zoom[, panoId]) pan Number : 가로 각도, 0부터 360 사이의 값으로 북쪽부터 시계방향으로 대응한다. tilt Number : 세로 각도, -90부터 90 사이의 값으로 위쪽부터 아래쪽으로 대응한다. zoom Number : 확대 수준, -3부터 3 사이의 정수이다. panoId Number : 특정 위치의 로드뷰 고유의 아이디 값 각 속성들은 . 표기법(dot notation) 혹은 [ ] 표기법(bracket notation)으로 직접 접근하여 값을 가져오거나 지정할 수 있다. StaticMap Methods 이미지 지도를 생성한다. 이미지 지도의 최대 크기는 2048×2048이고 이 이상 큰 이미지를 요청하는 경우 무시된다. 이미지 지도 생성하기 샘플보기 이미지 지도에 마커 표시하기 샘플보기 마커와 텍스트 표시하기 샘플보기 kakao.maps.StaticMap(container, options) container Node : 이미지 지도가 표시될 HTML element options Object center LatLng : 중심 좌표 (필수) level Number : 확대 수준 (기본값: 3) mapTypeId MapTypeId : 지도 종류 (기본값: 일반 지도) marker Object : 이미지 지도에 표시할 마커 center LatLng : 중심 좌표 (필수) level Number : 확대 수준 (기본값: 3) mapTypeId MapTypeId : 지도 종류 (기본값: 일반 지도) marker Object : 이미지 지도에 표시할 마커 setCenter(latlng) 이미지 지도의 중심 좌표를 설정한다. 이미지 지도의 중심 좌표를 반환한다. setLevel(level) 이미지 지도의 확대 수준을 설정한다. 0부터 14까지의 정수이며, 값이 작을수록 확대된다. 이미지 지도의 확대 수준을 반환한다. 0부터 14까지의 정수이며, 지도가 확대되어 있을수록 작은 값을 반환한다. setMapTypeId(mapTypeId) 이미지 지도 타입을 설정한다. mapTypeId MapTypeId 이미지 지도 타입을 반환한다. position LatLng : 마커의 좌표. 지정하지 않으면 지도의 중심좌표로 대체된다. text String : 마커의 툴팁 텍스트로 마커 위에 표시된다. 이미지 지도에 표시되는 마커는 Object 형태이며 위와 같이 두 가지 속성을 가진다. services 라이브러리 네임스페이스. 장소 검색 및 주소-좌표 간 변환 서비스를 포함하고 있다. 라이브러리를 사용하기 위해서는 반드시 별도 로드 해야 한다. kakao.maps.services.Status. STATUS 응답 코드가 상수로 정의되어 있다. STATUS 값으로 사용 가능한 목록은 다음과 같다. ZERO_RESULT : 정상적으로 응답 받았으나 검색 결과는 없음 ERROR : 서버 응답에 문제가 있는 경우 kakao.maps.services.SortBy. SORT_BY 정렬을 위한 옵션 값이 상수로 정의되어 있다. 장소 검색( keywordSearch , categorySearch )에서 결과의 정렬을 위해 사용한다. SORT_BY 값으로 사용 가능한 목록은 다음과 같다. ACCURACY : 정확도 순 DISTANCE : 거리 순 이 중, DISTANCE 을 사용하기 위해서는 또 다른 옵션 중 하나인 location 이 함께 지정되어 있어야 한다. kakao.maps.services.Coords. COORDS 좌표 변환을 지원하는 좌표계가 상수로 정의되어 있다. 좌표 변환( transCoord )에서 변환을 위해, 좌표→주소 변환( coord2RegionCode , coord2Address )에서 입력한 좌표의 좌표계를 지정하거나 또는 받을 출력 좌표계를 지정하기 위해 사용한다. Coords 값으로 사용 가능한 목록은 다음과 같다. WGS84 : WGS84 좌표계 WCONGNAMUL : WCONGNAMUL 좌표계 CONGNAMUL : CONGNAMUL 좌표계 kakao.maps.services.AnalyzeType. ANALYZE_TYPE 주소-좌표 검색( addressSearch )에서 검색 방식을 지정하기 위해 사용한다. ANALYZE_TYPE 값으로 사용 가능한 목록은 다음과 같다. SIMILAR : 건물명이 일부 매칭될 경우에도 검색 결과를 사용 EXACT : 정확한 주소 패턴일 경우에만 검색 결과를 사용 services.Places Methods kakao.maps.services.Places([map]) 장소 검색 서비스 객체를 생성한다. 지도 객체를 인자로 넣을경우, 검색에 필요한 옵션들 중 location 이 자동으로 현재 지도의 중심 좌표로 설정되어 검색을 시도한다. 필요에 따라서는 useMapBounds 옵션을 통해 현재 지도에 보여지는 영역을 자동 지정할 수 있다. map Map : 지도 객체 지도 객체를 설정한다. 이미 설정되어 있는 지도는 setMap(null) 로 해제 가능하다. keywordSearch(keyword, callback, options) keyword String : 검색할 키워드 callback Function : 검색 결과를 받을 콜백함수 options Object category_group_code String : 키워드 필터링을 위한 카테고리 코드 location LatLng : 중심 좌표. 특정 지역을 기준으로 검색한다. x Number : x 좌표, longitude, location 값이 있으면 무시된다. y Number : y 좌표, latitude, location 값이 있으면 무시된다. radius Number : 중심 좌표로부터의 거리(반경) 필터링 값. location / x , y / useMapCenter 중 하나와 같이 써야 의미가 있음. 미터(m) 단위. 기본값은 5000, 0~20000까지 가능 bounds LatLngBounds : 검색할 사각형 영역 rect String : 사각 영역. 좌x,좌y,우x,우y 형태를 가짐. bounds 값이 있으면 무시된다. size Number : 한 페이지에 보여질 목록 개수. 기본값은 15, 1~15까지 가능 page Number : 검색할 페이지. 기본값은 1, size 값에 따라 1~45까지 가능 sort SortBy : 정렬 옵션. DISTANCE 일 경우 지정한 좌표값에 기반하여 동작함. 기본값은 ACCURACY (정확도 순) useMapCenter Boolean : 지정한 Map 객체의 중심 좌표를 사용할지의 여부. 참일 경우, location 속성은 무시된다. 기본값은 false useMapBounds Boolean : 지정한 Map 객체의 영역을 사용할지의 여부. 참일 경우, bounds 속성은 무시된다. 기본값은 false category_group_code String : 키워드 필터링을 위한 카테고리 코드 location LatLng : 중심 좌표. 특정 지역을 기준으로 검색한다. x Number : x 좌표, longitude, location 값이 있으면 무시된다. y Number : y 좌표, latitude, location 값이 있으면 무시된다. radius Number : 중심 좌표로부터의 거리(반경) 필터링 값. location / x , y / useMapCenter 중 하나와 같이 써야 의미가 있음. 미터(m) 단위. 기본값은 5000, 0~20000까지 가능 bounds LatLngBounds : 검색할 사각형 영역 rect String : 사각 영역. 좌x,좌y,우x,우y 형태를 가짐. bounds 값이 있으면 무시된다. size Number : 한 페이지에 보여질 목록 개수. 기본값은 15, 1~15까지 가능 page Number : 검색할 페이지. 기본값은 1, size 값에 따라 1~45까지 가능 sort SortBy : 정렬 옵션. DISTANCE 일 경우 지정한 좌표값에 기반하여 동작함. 기본값은 ACCURACY (정확도 순) useMapCenter Boolean : 지정한 Map 객체의 중심 좌표를 사용할지의 여부. 참일 경우, location 속성은 무시된다. 기본값은 false useMapBounds Boolean : 지정한 Map 객체의 영역을 사용할지의 여부. 참일 경우, bounds 속성은 무시된다. 기본값은 false result Array : 결과 목록 결과 상세는 로컬 REST API 키워드로 장소 검색 의 응답결과 참고 결과 상세는 로컬 REST API 키워드로 장소 검색 의 응답결과 참고 status Status : 응답 코드 pagination Pagination : Pagination 객체 categorySearch(code, callback, options) 주어진 카테고리 코드로 검색한다. 카테고리 검색은 영역 검색이 기본이므로 옵션에 명세된 x , y 또는 rect 를 직접 지정하거나, location 또는 bounds 값을 넣어 주어야 한다. 아니면 지정한 Map 객체를 이용하는 옵션인 useMapCenter 또는 useMapBounds 을 참으로 설정하여 지도의 영역이 자동으로 관련 값에 할당되도록 해도 된다. code String : 검색할 카테고리 코드 callback Function : 검색 결과를 받을 콜백함수 options Object location LatLng : 중심 좌표. 특정 지역을 기준으로 검색한다. 카테고리 검색에서는 필수. x Number : x 좌표, longitude, location 값이 있으면 무시된다. y Number : y 좌표, latitude, location 값이 있으면 무시된다. radius Number : 중심 좌표로부터의 거리(반경) 필터링 값. location / x , y / useMapCenter 중 하나와 같이 써야 의미가 있음. 미터(m) 단위. 기본값은 5000, 0~20000까지 가능 bounds LatLngBounds : 검색할 사각형 영역 rect String : 사각 영역. 좌x,좌y,우x,우y 형태를 가짐. bounds 값이 있으면 무시된다. size Number : 한 페이지에 보여질 목록 개수. 기본값은 15, 1~15까지 가능 page Number : 검색할 페이지. 기본값은 1, size 값에 따라 1~45까지 가능 sort SortBy : 정렬 옵션. DISTANCE 일 경우 지정한 좌표값에 기반하여 동작함. 기본값은 ACCURACY (정확도 순) useMapCenter Boolean : 지정한 Map 객체의 중심 좌표를 사용할지의 여부. 참일 경우, location 속성은 무시된다. 기본값은 false useMapBounds Boolean : 지정한 Map 객체의 영역을 사용할지의 여부. 참일 경우, bounds 속성은 무시된다. 기본값은 false location LatLng : 중심 좌표. 특정 지역을 기준으로 검색한다. 카테고리 검색에서는 필수. x Number : x 좌표, longitude, location 값이 있으면 무시된다. y Number : y 좌표, latitude, location 값이 있으면 무시된다. radius Number : 중심 좌표로부터의 거리(반경) 필터링 값. location / x , y / useMapCenter 중 하나와 같이 써야 의미가 있음. 미터(m) 단위. 기본값은 5000, 0~20000까지 가능 bounds LatLngBounds : 검색할 사각형 영역 rect String : 사각 영역. 좌x,좌y,우x,우y 형태를 가짐. bounds 값이 있으면 무시된다. size Number : 한 페이지에 보여질 목록 개수. 기본값은 15, 1~15까지 가능 page Number : 검색할 페이지. 기본값은 1, size 값에 따라 1~45까지 가능 sort SortBy : 정렬 옵션. DISTANCE 일 경우 지정한 좌표값에 기반하여 동작함. 기본값은 ACCURACY (정확도 순) useMapCenter Boolean : 지정한 Map 객체의 중심 좌표를 사용할지의 여부. 참일 경우, location 속성은 무시된다. 기본값은 false useMapBounds Boolean : 지정한 Map 객체의 영역을 사용할지의 여부. 참일 경우, bounds 속성은 무시된다. 기본값은 false result Array : 결과 목록 결과 상세는 로컬 REST API 카테고리로 장소 검색 의 응답결과 참고 결과 상세는 로컬 REST API 카테고리로 장소 검색 의 응답결과 참고 status Status : 응답 코드 pagination Pagination : Pagination 객체 services.Geocoder Methods kakao.maps.services.Geocoder() 주소-좌표간 변환 서비스 객체를 생성한다. addressSearch(addr, callback, options) 주소 정보에 해당하는 좌표값을 요청한다. addr String : 변환할 주소명 callback Function : 검색 결과를 받을 콜백함수 options Object page Number : 검색할 페이지. 기본값은 1 size Number : 검색할 페이지. 기본값은 10, 1~30 까지 가능 analyze_type AnalyzeType : 검색어 매칭 방식 선택 옵션. SIMILAR 일 경우 입력한 것과 유사한 검색어도 검색결과에 포함시킨다. EXACT 일 경우 입력한 주소 문자열과 정확하게 매칭되는 주소만을 찾아준다. 기본값은 SIMILAR page Number : 검색할 페이지. 기본값은 1 size Number : 검색할 페이지. 기본값은 10, 1~30 까지 가능 analyze_type AnalyzeType : 검색어 매칭 방식 선택 옵션. SIMILAR 일 경우 입력한 것과 유사한 검색어도 검색결과에 포함시킨다. EXACT 일 경우 입력한 주소 문자열과 정확하게 매칭되는 주소만을 찾아준다. 기본값은 SIMILAR result Array : 결과 목록 결과 상세는 로컬 REST API 주소 검색 의 응답결과 참고 결과 상세는 로컬 REST API 주소 검색 의 응답결과 참고 status Status : 응답 코드 pagination Pagination : Pagination 객체 coord2Address(x, y, callback, options) 좌표 값에 해당하는 구 주소와 도로명 주소 정보를 요청한다. 도로명 주소는 좌표에 따라서 표출되지 않을 수 있다. x Number : x 좌표, 경위도인 경우 longitude y Number : y 좌표, 경위도인 경우 latitude callback Function : 검색 결과를 받을 콜백함수 options Object input_coord Coords : 입력 좌표 체계. 기본값은 WGS84 input_coord Coords : 입력 좌표 체계. 기본값은 WGS84 result Array : 결과 목록 결과 상세는 로컬 REST API 좌표를 주소로 변환 의 응답결과 참고 결과 상세는 로컬 REST API 좌표를 주소로 변환 의 응답결과 참고 status Status : 응답 코드 coord2RegionCode(x, y, callback, options) 좌표 값에 해당하는 행정동, 법정동 정보를 얻는다. x Number : x 좌표, 경위도인 경우 longitude y Number : y 좌표, 경위도인 경우 latitude callback Function : 검색 결과를 받을 콜백함수 options Object input_coord Coords : 입력 좌표 체계. 기본값은 WGS84 output_coord Coords : 출력 좌표 체계. 기본값은 WGS84 input_coord Coords : 입력 좌표 체계. 기본값은 WGS84 output_coord Coords : 출력 좌표 체계. 기본값은 WGS84 result Array : 결과 목록 결과 상세는 로컬 REST API 좌표를 행정구역정보로 변환 의 응답결과 참고 결과 상세는 로컬 REST API 좌표를 행정구역정보로 변환 의 응답결과 참고 status Status : 응답 코드 transCoord(x, y, callback, options) 입력한 좌표를 다른 좌표계의 좌표로 변환한다. x Number : 변환할 x 좌표 y Number : 변환할 y 좌표 callback Function : 변환 결과를 받을 콜백함수 options Object input_coord Coords : 입력 좌표 체계. 기본값은 WGS84 output_coord Coords : 출력 좌표 체계. 기본값은 WGS84 input_coord Coords : 입력 좌표 체계. 기본값은 WGS84 output_coord Coords : 출력 좌표 체계. 기본값은 WGS84 result Array : 변환된 좌표 결과 결과 상세는 로컬 REST API 좌표계 변환 의 응답결과 참고 결과 상세는 로컬 REST API 좌표계 변환 의 응답결과 참고 status Status : 응답 코드 Pagination Methods 검색 결과의 페이징을 담당하는 클래스. 하나의 검색 결과에 대해 페이지 이동을 쉽게 할 수 있도록 도와준다. 직접 선언은 불가능하며 검색 결과를 다루는 콜백함수의 인자로 인스턴스가 생성되어 넘어온다. 가장 처음 페이지를 검색한다. 가장 마지막 페이지를 검색한다. 현재 검색의 결과 목록의 총 갯수 현재 검색 결과 기준, 다음 페이지가 있는지 여부 현재 검색 결과 기준, 이 전 페이지가 있는지 여부 MarkerClusterer Methods Events 마커 클러스터링을 담당하는 객체. clusterer 라이브러리를 별도 로드 해야 사용 가능하다. 마커 클러스터러 사용하기 샘플보기 kakao.maps.MarkerClusterer(options) 마커 클러스터링을 담당하는 객체를 생성한다. options Object map Map : 클러스터링 마커를 표시할 지도 객체 markers Array.< Marker > : 클러스터링 할 마커 배열 gridSize Number : 클러스터의 격자 크기. 화면 픽셀 단위이며 해당 격자 영역 안에 마커가 포함되면 클러스터에 포함시킨다 (default : 60) averageCenter Boolean : 마커들의 좌표 평균을 클러스터 좌표 설정 여부 (default : false) minLevel Number : 클러스터링 할 지도의 최소 레벨 값. 지정한 숫자에 해당하는 레벨 미만에서는 클러스터링 하지 않는다 (default : 0) minClusterSize Number : 클러스터링 할 최소 마커 수 (default: 2) styles Array.< Object > : 클러스터의 스타일. 여러개를 선언하면 calculator 로 구분된 사이즈 구간마다 서로 다른 스타일을 적용시킬 수 있다 texts Array.< String > | Function : 클러스터에 표시할 문자열 또는 문자열 생성 함수. (default : 클러스터에 포함된 숫자) calculator Array.< Number > | Function : 클러스터 크기를 구분하는 값을 가진 배열 또는 구분값 생성함수 (default : [10, 100, 1000, 10000]) disableClickZoom Boolean : 클러스터 클릭 시 지도 확대 여부. true로 설정하면 클러스터 클릭 시 확대 되지 않는다 (default: false) clickable Boolean : 클러스터 클릭 가능 여부 지정 옵션. false일 경우 클러스터의 clusterclick , clusterdblclick , clusterrightclick 이벤트가 발생하지 않으며, 커서가 변경되지 않는다. (default: true) hoverable Boolean : 클러스터에 마우스 over/out 가능 여부 지정 옵션. false일 경우 클러스터의 clusterover , clusterout 이벤트가 발생하지 않는다. (default: true) map Map : 클러스터링 마커를 표시할 지도 객체 markers Array.< Marker > : 클러스터링 할 마커 배열 gridSize Number : 클러스터의 격자 크기. 화면 픽셀 단위이며 해당 격자 영역 안에 마커가 포함되면 클러스터에 포함시킨다 (default : 60) averageCenter Boolean : 마커들의 좌표 평균을 클러스터 좌표 설정 여부 (default : false) minLevel Number : 클러스터링 할 지도의 최소 레벨 값. 지정한 숫자에 해당하는 레벨 미만에서는 클러스터링 하지 않는다 (default : 0) minClusterSize Number : 클러스터링 할 최소 마커 수 (default: 2) styles Array.< Object > : 클러스터의 스타일. 여러개를 선언하면 calculator 로 구분된 사이즈 구간마다 서로 다른 스타일을 적용시킬 수 있다 texts Array.< String > | Function : 클러스터에 표시할 문자열 또는 문자열 생성 함수. (default : 클러스터에 포함된 숫자) calculator Array.< Number > | Function : 클러스터 크기를 구분하는 값을 가진 배열 또는 구분값 생성함수 (default : [10, 100, 1000, 10000]) disableClickZoom Boolean : 클러스터 클릭 시 지도 확대 여부. true로 설정하면 클러스터 클릭 시 확대 되지 않는다 (default: false) clickable Boolean : 클러스터 클릭 가능 여부 지정 옵션. false일 경우 클러스터의 clusterclick , clusterdblclick , clusterrightclick 이벤트가 발생하지 않으며, 커서가 변경되지 않는다. (default: true) hoverable Boolean : 클러스터에 마우스 over/out 가능 여부 지정 옵션. false일 경우 클러스터의 clusterover , clusterout 이벤트가 발생하지 않는다. (default: true) addMarker(marker[, nodraw]) 클러스터에 마커 하나를 추가한다. marker Marker : 추가할 마커 nodraw Boolean : 클러스터 redraw 여부. true인 경우 클러스터를 다시 그리지 않는다. removeMarker(marker[, nodraw]) 클러스터에 추가된 마커 중 하나를 삭제한다. marker Marker : 삭제할 마커 nodraw Boolean : 클러스터 redraw 여부. true인 경우 클러스터를 다시 그리지 않는다. addMarkers(markers[, nodraw]) markers Array.< Marker > : 추가할 마커 객체 배열 nodraw Boolean : 클러스터 redraw 여부. true인 경우 클러스터를 다시 그리지 않는다. removeMarkers(markers[, nodraw]) 추가된 마커 중 여러개의 마커를 삭제한다. markers Array.< Marker > : 삭제할 마커 객체 배열 nodraw Boolean : 클러스터 redraw 여부. true인 경우 클러스터를 다시 그리지 않는다. 추가된 모든 마커를 삭제한다. 클러스터를 다시 그린다. 주로 옵션을 변경한 이후 클러스터를 다시 그릴 때 사용한다. 클러스터의 격자 크기를 반환한다. setGridSize(size) 클러스터의 격자 크기를 설정한다. (단위 : 화면픽셀) size Number : 격자 크기 getMinClusterSize() 클러스터를 만들기 위해 필요한 최소 마커 개수를 반환한다. setMinClusterSize(size) 클러스터를 만들기 위해 필요한 최소 마커 개수를 설정한다. size Number : 마커 개수 getAverageCenter() 현재 설정되어있는 클러스터 마커의 위치 결정 방식을 반환한다. 반환 값이 true 일 경우 클러스터가 포함하는 마커들의 위치 평균값을 사용하고 있음을 의미하고 false 일 경우에는 기준이 되는 특정 마커의 위치를 사용하고 있음을 의미한다. setAverageCenter(bool) 현재 설정되어있는 클러스터 마커의 위치 결정 방식을 설정한다. true 로 설정하면 클러스터가 포함하는 마커들의 위치 평균값을 사용하여 클러스터 마커의 위치를 결정하고 false 로 설정하면 기준이 되는 특정 마커의 위치를 클러스터 마커의 위치로 결정한다. 클러스터링 할 지도의 최소 레벨 값을 반환한다. setMinLevel(level) 클러스터링 할 지도의 최소 레벨 값을 설정한다. level Number : 지도의 레벨 클러스터 내부에 표시할 문자열의 배열 또는 문자열 생성 합수를 반환한다. Array.< String > | Function setTexts(texts) 클러스터 내부에 표시할 문자열 배열 또는 문자열 생성 함수를 설정한다. 클러스터 마커에 텍스트 표시하기 샘플보기 texts Array.< String > | Function : 클러스터 내부에 표시할 문자열 배열 또는 문자열 생성 함수 getCalculator() 클러스터 크기를 구분하는 값을 가진 배열 혹은 구분값 생성 함수를 반환한다. Array.< Number > | Function setCalculator(calculator) 클러스터 크기를 구분하는 값을 가진 배열 혹은 구분값 생성 함수를 설정한다. 별도로 지정하지 않으면 기본값은 [10, 100, 1000, 10000] 이다. 배열로 지정할 경우에는 반드시 오름차순으로 정렬해야 하며, 생성함수로 지정할 경우에는 클러스터의 스타일 배열 인덱스 또는 텍스트(texts) 배열의 인덱스를 반환해야 한다. 클러스터 마커에 텍스트 표시하기 샘플보기 calculator Array.< Number > | Function : 클러스터의 크기를 구분하는 값의 배열 또는 구분값을 생성하는 함수 클러스터 마커에 설정된 스타일 배열을 반환한다. Array.< Object > setStyles(styles) 클러스터 마커에 스타일을 설정한다. 여러개를 선언하면 calculator 로 구분된 사이즈 구간마다 서로 다른 스타일을 적용시킬 수 있다 styles Array.< Object > : 클러스터 마커에 설정할 스타일 배열 클러스터 마커를 클릭 했을 때 발생한다. 이벤트 핸들러 함수 인자로는 Cluster 객체가 넘어온다. 클러스터 마커 클릭 시 지도가 줌인 되는 경우 원하는 Cluster 객체를 얻지 못할 수도 있다. 때문에 MarkerClusterer 를 생성할 때 disableClickZoom 옵션을 true로 설정하여 클러스터 마커를 클릭했을 때 지도가 줌인되지 않도록 설정 후 사용한다. 마커 클러스터러에 클릭이벤트 추가하기 샘플보기 cluster Cluster : 클릭한 클러스터 객체 클러스터 마커를 마우스 오버 했을 때 발생한다 이벤트 핸들러 함수 인자로는 마우스 오버한 Cluster 객체가 넘어온다. cluster Cluster : 마우스 오버한 클러스터 객체 클러스터 마커를 마우스 아웃 했을 때 발생한다 이벤트 핸들러 함수 인자로는 마우스 아웃된 Cluster 객체가 넘어온다. cluster Cluster : 마우스 아웃한 클러스터 객체 clusterdblclick 클러스터 마커를 더블클릭 했을 때 발생한다 이벤트 핸들러 함수 인자로는 더블클릭한 Cluster 객체가 넘어온다. MarkerClusterer 를 생성할 때 disableClickZoom 옵션을 true로 설정해야만 이벤트가 발생한다. cluster Cluster : 더블클릭한 클러스터 객체 clusterrightclick 클러스터 마커를 오른쪽 클릭 했을 때 발생한다 이벤트 핸들러 함수 인자로는 오른쪽 클릭한 Cluster 객체가 넘어온다. cluster Cluster : 오른쪽 클릭한 클러스터 객체 클러스터링이 완료됐을 때 발생한다. 이벤트 핸들러 함수 인자로는 생성된 Cluster 객체 전체가 배열로 넘어온다. clusters Array.< Cluster > : 클러스터링 완료된 Cluster 객체 전체 배열 Cluster Methods 클러스터 객체. 클러스터링 된 마커들과 클러스터 오버레이의 정보를 가지고 있다. 직접 선언은 불가능하며 MarkerClusterer 의 이벤트 핸들러의 인자로 인스턴스가 생성되어 넘어온다. 클러스터의 좌표를 반환한다. 클러스터의 영역을 반환한다. 클러스터에 포함된 마커의 개수를 반환한다. 클러스터에 포함된 마커들을 배열로 반환한다. Array.< Marker > getClusterMarker() 클러스터 오버레이를 반환한다. 리턴값은 CustomOverlay 이다. drawing 라이브러리 네임스페이스. 지도 API의 마커객체와 그리기 요소를 쉽게 지도 위에 그릴 수 있도록 기능을 제공한다 라이브러리를 사용하기 위해서는 반드시 별도 로드 해야 한다. kakao.maps.drawing.OverlayType. OverlayType drawing 라이브러리로 그리기를 제공할 오버레이 타입이 상수로 정의되어 있다. OverlayType 값으로 사용 가능한 목록은 다음과 같다. RECTANGLE : 사각형 ARROW : 끝점에 화살표가 표시된 선 drawing.DrawingManager Methods Events kakao.maps.drawing.DrawingManager(options) 그리기 관리자 객체를 생성한다. drawing Library 사용하기 샘플보기 drawing Library에서 데이터 얻기 샘플보기 options Object map Map : 마커와 그리기 요소를 그릴 지도 객체 guideTooltip Array.<String> : 마우스 오버 시 가이드 툴팁 표시 여부. ‘draw’, ‘drag’, ‘edit’ 3가지를 지정할 수 있다 (기본값: 모두 표시 안함) 예를들어 [‘draw’]로 설정하면 객체를 그릴때 가이드 툴팁이 표시된다 drawingMode Array.< OverlayType > : 사용할 그리기 요소 지정한다 (기본값: 모든 그리기 요소) markerOptions Object : 마커 그리기 옵션 rectangleOptions Object : 사각형 그리기 옵션 circleOptions Object : 원 그리기 옵션 ellipseOptions Object : 타원 그리기 옵션 polylineOptions Object : 선 그리기 옵션 arrowOptions Object : 화살표 선 그리기 옵션 polygonOptions Object : 다각형 그리기 옵션 map Map : 마커와 그리기 요소를 그릴 지도 객체 guideTooltip Array.<String> : 마우스 오버 시 가이드 툴팁 표시 여부. ‘draw’, ‘drag’, ‘edit’ 3가지를 지정할 수 있다 (기본값: 모두 표시 안함) 예를들어 [‘draw’]로 설정하면 객체를 그릴때 가이드 툴팁이 표시된다 drawingMode Array.< OverlayType > : 사용할 그리기 요소 지정한다 (기본값: 모든 그리기 요소) markerOptions Object : 마커 그리기 옵션 rectangleOptions Object : 사각형 그리기 옵션 circleOptions Object : 원 그리기 옵션 ellipseOptions Object : 타원 그리기 옵션 polylineOptions Object : 선 그리기 옵션 arrowOptions Object : 화살표 선 그리기 옵션 polygonOptions Object : 다각형 그리기 옵션 DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 markerOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 마커 removable Boolean : 삭제가 가능한 마커 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) markerImages Array.< Object > : 그릴 마커의 이미지를 설정한다 (기본값: API 기본 마커 이미지) MarkerImageOptions 마커 그리기 옵션인 markerOptions 객체에 마커 마커 이미지를 설정하는 markerImages 에 설정 가능한 항목들을 설명한다. src String : 마커 이미지 URL width Number : 마커의 너비 height Number : 마커의 높이 offsetX Number : 마커의 좌표에 일치시킬 이미지 안의 X 좌표 offsetY Number : 마커의 좌표에 일치시킬 이미지 안의 Y 좌표 spriteWidth Number : 스프라이트 이미지의 전체 너비 spriteHeight Number : 스프라이트 이미지의 전체 높이 spriteOriginX Number : 스프라이트 이미지에서 사용할 영역의 좌측 좌표 spriteOriginY Number : 스프라이트 이미지에서 사용할 영역의 상단 좌표 shape String : 마커의 클릭 또는 마우스오버 가능한 영역의 모양 coords String : 마커의 클릭 또는 마우스오버 가능한 영역을 표현하는 좌표값 hoverImage Object : 위에 설명된 항목들로 구성된다 (src, width, offsetX, offsetY, …) dragImage Object : 위에 설명된 항목들로 구성된다 (src, width, offsetX, offsetY, …) RectangleOptions DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 rectangleOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 사각형 removable Boolean : 삭제 가능한 사각형 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) editable Boolean : 수정 가능한 사각형 (true로 설정하면 마우스 오버 시 수정할 수 있는 작은 사각형이 표시된다) strokeWeight Number : 외각선의 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 외곽선 색 (기본값: ‘#F10000’) strokeOpacity Number : 외곽선의 불투명도 (0-1, 기본값: 1.0) strokeStyle String : 외곽선선 스타일 (기본값: ‘solid’) fillColor String : #xxxxxx 형태의 채우기 색 (기본값: ‘#F10000’) fillOpacity Number : 채우기 불토명도 (0-1, 기본값: 0) DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 circleOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 원 removable Boolean : 삭제 가능한 원 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) editable Boolean : 수정 가능한 원 (true로 설정하면 마우스 오버 시 수정할 수 있는 작은 사각형이 표시된다) strokeWeight Number : 외각선의 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 외곽선 색 (기본값: ‘#F10000’) strokeOpacity Number : 외곽선의 불투명도 (0-1, 기본값: 1.0) strokeStyle String : 외곽선 스타일 (기본값: ‘solid’) fillColor String : #xxxxxx 형태의 채우기 색 (기본값: ‘#F10000’) fillOpacity Number : 채우기 불토명도 (0-1, 기본값: 0) DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 ellipseOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 타원 removable Boolean : 삭제 가능한 타원 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) editable Boolean : 수정 가능한 타원 (true로 설정하면 마우스 오버 시 수정할 수 있는 작은 사각형이 표시된다) strokeWeight Number : 외각선의 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 외곽선 색 (기본값: ‘#F10000’) strokeOpacity Number : 외곽선의 불투명도 (0-1, 기본값: 1.0) strokeStyle String : 외곽선 스타일 (기본값: ‘solid’) fillColor String : #xxxxxx 형태의 채우기 색 (기본값: ‘#F10000’) fillOpacity Number : 채우기 불토명도 (0-1, 기본값: 0) PolylineOptions DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 polylineOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 선 removable Boolean : 삭제 가능한 선 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) editable Boolean : 수정 가능한 선 (true로 설정하면 마우스 오버 시 수정할 수 있는 작은 사각형이 표시된다) strokeWeight Number : 선의 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 선의 불투명도 (0-1, 기본값: 1.0) strokeStyle String : 선 스타일 (기본값: ‘solid’) hintStrokeStyle String : 그리기 중, 마우스를 따라다니는 보조선의 스타일 (기본값: ‘solid’) hintStrokeOpacity Number : 그리기 중, 마우스를 따라다니는 보조선의 투명도. (기본값: 0.5) DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 arrowOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 화살표 선 removable Boolean : 삭제 가능한 화살표 선 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) editable Boolean : 수정 가능한 화살표 선 (true로 설정하면 마우스 오버 시 수정할 수 있는 작은 사각형이 표시된다) strokeWeight Number : 화살표 선의 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 화살표 선 색 (기본값: ‘#F10000’) strokeOpacity Number : 화살표 선의 불투명도 (0-1, 기본값: 1.0) strokeStyle String : 화살표 선 스타일 (기본값: ‘solid’) hintStrokeStyle String : 그리기 중, 마우스를 따라다니는 보조선의 스타일 (기본값: ‘solid’) hintStrokeOpacity Number : 그리기 중, 마우스를 따라다니는 보조선의 투명도. (기본값: 0.5) startArrow Boolean : 시작점의 화살표 표시 여부 (기본값: false) DrawingManager 의 생성자 옵션에서 마커의 그리기 옵션인 polygonOptions 에 설정 가능한 항목들을 설명한다. draggable Boolean : 드래그 가능한 다각형 removable Boolean : 삭제 가능한 다각형 (true로 설정하면 마우스 오버 시 삭제할 수 있는 X 버튼이 표시된다) editable Boolean : 수정 가능한 다각형 (true로 설정하면 마우스 오버 시 수정할 수 있는 작은 사각형이 표시된다) strokeWeight Number : 외각선의 두께 (기본값: 3) strokeColor String : #xxxxxx 형태의 외곽선 색 (기본값: ‘#F10000’) strokeOpacity Number : 외곽선의 불투명도 (0-1, 기본값: 1.0) strokeStyle String : 외곽선 스타일 (기본값: ‘solid’) fillColor String : #xxxxxx 형태의 채우기 색 (기본값: ‘#F10000’) fillOpacity Number : 채우기 불토명도 (0-1, 기본값: 0) setStyle(type, prop, value) 특정 그리기 요소의 스타일 속성을 설정한다. // 다각형의 채우기 색을 빨간색으로 바꾼다 manager . setStyle ( kakao . maps . drawing . OverlayType . POLYGON , 'fillColor' , '#f00' ); type OverlayType : 속성을 설정할 그리기 요소 타입 prop String : 설정할 속성 이름 value String | Number : 설정할 속성 값 setStrokeWeight(strokeWeight) 선을 사용하는 모든 그리기 요소들의 선 굵기를 설정한다. strokeWeight Number : 선의 두께 setStrokeColor(strokeColor) 선을 사용하는 모든 그리기 요소들의 선 색을 설정한다. strokeColor String : #xxxxxx 형태의 선 색 select(type [, index]) 그리기 요소를 선택한다. 이미 선택한 상태에서 다시 호출하면 이 전 선택된 요소는 취소된다. 여러개의 마커 이미지를 선언했을 경우, 두 번째 파라메터로 해당 마커 이미지의 인덱스 값을 넣는다. 인덱스 값은 0 부터 시작한다. type OverlayType : 선택할 그리기 요소 타입 index Number : 마커 이미지의 인덱스 현재 그리기 요소로 선택한 것을 취소한다. 그리기 요소를 이전 상태로 되돌린다. 그리기 요소의 생성/수정/이동/삭제 동작을 되돌릴 수 있고 여러번 호출이 가능하다. 그리기 요소의 상태는 최대 20개 까지 저장된다. 이전 상태로 되돌린 상태를 취소한다. 여러번의 undo 호출 이후에 DrawingManager 객체에 그리기 요소에 대한 새로운 상태가 추가되지 않으면 되돌리기 이전 상태까지 실행할 수 있다. 그리기 요소를 이전 상태로 되돌릴 수 있는지 여부를 반환한다. 이전으로 되돌린 상태를 취소할 수 있는지 여부를 반환한다. getData([types]) 지도에 그려진 요소들 중 선택한 요소의 데이터를 반환한다. 요소를 지정하지 않으면 그려진 모든 요소의 데이터를 반환한다. drawing Library에서 데이터 얻기 샘플보기 types Array.< OverlayType > : 데이터를 받을 그리기 요소 배열 getOverlays([types]) 지도에 그려진 요소들 중 선택한 요소의 객체를 반환한다. 요소를 지정하지 않으면 그려진 모든 요소의 객체를 반환한다. types Array.< OverlayType > : 객체를 받을 그리기 요소 배열 put(overlayType, param1[, param2]) 그리기 관리자 객체에 그리기 요소를 넣는다. 각 요소들의 스타일은 그리기 관리자에 이미 설정된 값을 따른다. overlayType OverlayType : 그리기 관리자에 추가할 오버레이 타입 param1 LatLng | LatLngBounds | Array.< LatLng > : 추가할 그리기 요소가 마커/원인 경우 LatLng를, 타원/사각형인 경우는 LatLngBounds를, 선, 화살표선, 다각형인 경우는 좌표의 배열을 받는다 param2 Number : 추가할 그리기 요소가 마커인경우 사용할 마커 이미지의 인덱스를, 원인 경우 원의 반지름을 파라미터로 받는다 remove(overlay) 이미 그린 그리기 요소를 삭제한다. overlay ExtendsOverlay : 그리기 관리자에서 생성한 확장 오버레이 객체 그리기 요소를 선택하면 발생한다. Object overlayType : 선택된 그리기 요소 타입 overlayType : 선택된 그리기 요소 타입 그리기를 시작하면 발생한다. 그리기 시작 후, 마우스를 이동하면 발생한다. 다음 단계 그리기를 하면 발생한다. (Polyline, Polygon, Arrow 한정) 그리기를 취소하면 발생한다. Object overlayType : 취소된 그리기 요소 타입 overlayType : 취소된 그리기 요소 타입 그리기 요소를 삭제하면 발생한다. Object overlayType : 삭제된 그리기 요소 타입 overlayType : 삭제된 그리기 요소 타입 그리기 요소들의 상태가 변경되면 발생한다. 각 요소의 생성/수정/이동/삭제 동작과 undo 또는 redo 함수 호출이 이에 해당한다. drawing.Toolbox Methods kakao.maps.drawing.Toolbox(options) 그리기 툴박스를 생성한다. 툴박스 생성 시 DrawingManager 객체를 설정해야만 DrawingManager 에 설정된 그리기 모드를 버튼형식으로 제공한다. options Object drawingManager DrawingManager : 그리기 모드를 가져올 DrawingManager 객체 drawingManager DrawingManager : 그리기 모드를 가져올 DrawingManager 객체 툴박스 엘리먼트를 반환한다. 지도 위에 툴박스를 표시해야 할 때 사용한다. drawing.DrawingManager에 마우스와 관련된 이벤트(drawstart, draw, drawend, drawnext)에 등록한 이벤트 핸들러로 넘겨받는 인자 직접 생성할 수는 없으며 이벤트 핸들러에서 내부적으로 생성된 객체를 parameter로 받아 사용한다. 그리기 요소의 인스턴스. drawend 이벤트에서만 존재한다. load Static Methods v3 스크립트를 동적으로 로드하기위해 사용한다. 스크립트의 로딩이 끝나기 전에 v3의 객체에 접근하려고 하면 에러가 발생하기 때문에 로딩이 끝나는 시점에 콜백을 통해 객체에 접근할 수 있도록 해 준다. 비동기 통신으로 페이지에 v3를 동적으로 삽입할 경우에 주로 사용된다. v3 로딩 스크립트 주소에 파라메터로 autoload=false 를 지정해 주어야 한다. kakao.maps.load(callback) callback Function disableHD Static Methods 고해상도 기기에서 HD 타일을 기본 타일로 사용하지 않도록 한다. 모바일용 로드뷰도 고화질이 아닌 일반화질로 노출된다. 반드시 Map 혹은 Roadview 객체를 선언하기 전에 호출해야 한다. kakao.maps.disableHD() 지도 위에 올라가는 각종 도형의 선 스타일을 의미한다. 스타일은 패턴에 따라 11종류가 있으며 그 값은 문자열로 지정한다. shortdashdotdot 위 값들은 지도에서 아래처럼 표현된다. 옵션에서 strokeStyle 에 문자열 형태로 지정하여 적용한다. services 라이브러리의 categorySearch 에서 사용하는 코드 목록이다. categorySearch 의 첫 번째 인자에 문자열 형태로 지정하여 적용한다.