공지사항: 새로운 기본 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트, 현대화된 핀, 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Drawing Library

DrawingManager 클래스

google.maps.drawing.DrawingManager 클래스

사용자가 지도에 마커, 다각형, 다중선, 직사각형, 원을 그릴 수 있습니다. DrawingManager의 그리기 모드는 사용자가 만들 오버레이 유형을 정의합니다. 사용자가 그리기 모드를 전환할 수 있는 컨트롤을 지도에 추가합니다.

이 클래스는 MVCObject를 확장합니다.

const {DrawingManager} = await google.maps.importLibrary("drawing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

생성자
`DrawingManager`	`DrawingManager([options])` 매개변수: `options`: `DrawingManagerOptions optional` 사용자가 지도에 오버레이를 그리고 그리기 컨트롤로 그릴 오버레이 유형 간에 전환할 수 있는 `DrawingManager`를 만듭니다.

메서드
`getDrawingMode`	`getDrawingMode()` 매개변수: 없음 반환 값: `OverlayType\|null` `DrawingManager`의 그리기 모드를 반환합니다.
`getMap`	`getMap()` 매개변수: 없음 반환 값: `Map` `DrawingManager`가 연결된 `Map`를 반환합니다. 생성된 오버레이가 배치되는 `Map`입니다.
`setDrawingMode`	`setDrawingMode(drawingMode)` 매개변수: `drawingMode`: `OverlayType optional` 반환 값: 없음 지도에 추가할 오버레이 유형을 정의하는 `DrawingManager`의 그리기 모드를 변경합니다. 허용되는 값은 `'marker'`, `'polygon'`, `'polyline'`, `'rectangle'`, `'circle'`, `null`입니다. 그리기 모드가 `null`이면 사용자가 평소와 같이 지도와 상호작용할 수 있으며 클릭해도 아무것도 그려지지 않습니다.
`setMap`	`setMap(map)` 매개변수: `map`: `Map` 반환 값: 없음 `DrawingManager` 객체를 지정된 `Map`에 연결합니다.
`setOptions`	`setOptions(options)` 매개변수: `options`: `DrawingManagerOptions` 반환 값: 없음 `DrawingManager`의 옵션을 설정합니다.
상속: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

이벤트
`circlecomplete`	`function(circle)` 인수: `circle`: `Circle` 사용자가 방금 그린 원입니다. 이 이벤트는 사용자가 원 그리기를 완료하면 실행됩니다.
`markercomplete`	`function(marker)` 인수: `marker`: `Marker` 사용자가 방금 그린 마커입니다. 이 이벤트는 사용자가 마커 그리기를 완료하면 실행됩니다.
`overlaycomplete`	`function(event)` 인수: `event`: `OverlayCompleteEvent` 사용자가 방금 그린 오버레이와 오버레이 유형입니다. 이 이벤트는 사용자가 모든 유형의 오버레이 그리기를 완료하면 실행됩니다.
`polygoncomplete`	`function(polygon)` 인수: `polygon`: `Polygon` 사용자가 방금 그린 다각형입니다. 이 이벤트는 사용자가 다각형 그리기를 완료하면 실행됩니다.
`polylinecomplete`	`function(polyline)` 인수: `polyline`: `Polyline` 사용자가 방금 그린 다중선입니다. 이 이벤트는 사용자가 다중선 그리기를 완료하면 실행됩니다.
`rectanglecomplete`	`function(rectangle)` 인수: `rectangle`: `Rectangle` 사용자가 방금 그린 직사각형입니다. 이 이벤트는 사용자가 직사각형 그리기를 완료하면 실행됩니다.

DrawingManagerOptions 인터페이스

google.maps.drawing.DrawingManagerOptions 인터페이스

그리기 관리자의 옵션입니다.

속성
`circleOptions optional`	유형: `CircleOptions optional` 이 `DrawingManager`로 만든 새 서클에 적용할 옵션입니다. `center` 및 `radius` 속성은 무시되고 새 원의 `map` 속성은 항상 `DrawingManager`의 맵으로 설정됩니다.
`drawingControl optional`	유형: `boolean optional` 기본값: `true` 그리기 컨트롤의 사용 설정/사용 중지 상태입니다.
`drawingControlOptions optional`	유형: `DrawingControlOptions optional` 그리기 컨트롤의 표시 옵션입니다.
`drawingMode optional`	유형: `OverlayType optional` 지도에 추가할 오버레이 유형을 정의하는 `DrawingManager`의 그리기 모드입니다. 허용되는 값은 `'marker'`, `'polygon'`, `'polyline'`, `'rectangle'`, `'circle'`, `null`입니다. 그리기 모드가 `null`이면 사용자가 평소와 같이 지도와 상호작용할 수 있으며 클릭해도 아무것도 그려지지 않습니다.
`map optional`	유형: `Map optional` `DrawingManager`가 연결된 `Map`입니다. 생성된 오버레이가 배치되는 `Map`입니다.
`markerOptions optional`	유형: `MarkerOptions optional` 이 `DrawingManager`로 만든 새 마커에 적용할 옵션입니다. `position` 속성은 무시되고 새 마커의 `map` 속성은 항상 `DrawingManager`의 지도로 설정됩니다.
`polygonOptions optional`	유형: `PolygonOptions optional` 이 `DrawingManager`로 만든 새 다각형에 적용할 옵션입니다. `paths` 속성은 무시되고 새 다각형의 `map` 속성은 항상 `DrawingManager`의 지도로 설정됩니다.
`polylineOptions optional`	유형: `PolylineOptions optional` 이 `DrawingManager`로 만든 새 다중선에 적용할 옵션입니다. `path` 속성은 무시되고 새 다중선의 `map` 속성은 항상 `DrawingManager`의 맵으로 설정됩니다.
`rectangleOptions optional`	유형: `RectangleOptions optional` 이 `DrawingManager`로 만든 새 직사각형에 적용할 옵션입니다. `bounds` 속성은 무시되고 새 직사각형의 `map` 속성은 항상 `DrawingManager`의 지도로 설정됩니다.

DrawingControlOptions 인터페이스

google.maps.drawing.DrawingControlOptions 인터페이스

그리기 컨트롤 렌더링 옵션입니다.

속성
`drawingModes optional`	유형: `Array<OverlayType> optional` 기본값: `[OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON]` 그리기 컨트롤에 표시할 그리기 모드로, 표시될 순서입니다. 손 모양 아이콘 (`null` 그리기 모드에 해당)은 항상 사용할 수 있으며 이 배열에 지정해서는 안 됩니다.
`position optional`	유형: `ControlPosition optional` 기본값: `ControlPosition.TOP_LEFT` 위치 ID입니다. 지도에서 컨트롤의 위치를 지정하는 데 사용됩니다.

OverlayCompleteEvent 인터페이스

google.maps.drawing.OverlayCompleteEvent 인터페이스

DrawingManager의 overlaycomplete 이벤트 속성입니다.

속성
`overlay`	유형: `Marker\|Polygon\|Polyline\|Rectangle\|Circle` 완성된 오버레이
`type`	유형: `OverlayType` 완료된 오버레이의 유형입니다.

OverlayType 상수

google.maps.drawing.OverlayType 상수

DrawingManager에서 만들 수 있는 오버레이 유형입니다. 값으로 지정하거나 상수의 이름을 사용하여 지정합니다. 예를 들어 'polygon' 또는 google.maps.drawing.OverlayType.POLYGON입니다.

const {OverlayType} = await google.maps.importLibrary("drawing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
`CIRCLE`	`DrawingManager`가 원을 만들고 `overlaycomplete` 이벤트에 제공된 오버레이가 원이라고 지정합니다.
`MARKER`	`DrawingManager`가 마커를 만들고 `overlaycomplete` 이벤트에 제공된 오버레이가 마커임을 지정합니다.
`POLYGON`	`DrawingManager`가 다각형을 만들고 `overlaycomplete` 이벤트에 제공된 오버레이가 다각형임을 지정합니다.
`POLYLINE`	`DrawingManager`가 다중선을 만들고 `overlaycomplete` 이벤트에 제공된 오버레이가 다중선임을 지정합니다.
`RECTANGLE`	`DrawingManager`가 직사각형을 만들고 `overlaycomplete` 이벤트에 제공된 오버레이가 직사각형이라고 지정합니다.