Drawing Library

Класс DrawingManager

google.maps.drawing.DrawingManager класс

Поддержка прекращена. Поддержка функций библиотеки Drawing в Maps JavaScript API прекращена. Поддержка этого API прекращена в августе 2025 года. Он станет недоступен в версии Maps JavaScript API, которая выйдет в мае 2026 года. Подробную информацию можно найти на странице https://developers.google.com/maps/deprecations.

Позволяет пользователям рисовать на карте маркеры, многоугольники, ломаные линии, прямоугольники и окружности. Режим рисования 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 Возвращает объект Map, к которому прикреплен объект DrawingManager. На этом объекте 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 Map, к которому прикреплен DrawingManager. На этом 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. Идентификатор положения. Используется, чтобы указать положение элемента управления на карте.

Интерфейс OverlayCompleteEvent

google.maps.drawing.OverlayCompleteEvent интерфейс

Свойства события overlaycomplete для DrawingManager.

Свойства
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, является прямоугольником.