Drawing Library

Класс DrawingManager

google.maps.drawing.DrawingManager class
extends MVCObject
library "drawing"

Позволяет пользователям рисовать на карте маркеры, многоугольники, ломаные линии, прямоугольники и окружности. Режим рисования DrawingManager определяет тип оверлея, который будет создан пользователем. Добавляет на карту элемент управления, позволяющий пользователю переключать режим рисования.

const {DrawingManager} = await google.maps.importLibrary("drawing");
DrawingManager
DrawingManager([options])
Параметры:
Создает объект DrawingManager, который позволяет пользователям рисовать наложения на карте и переключаться между типами наложений, которые будут нарисованы с помощью элемента управления рисунком.
getDrawingMode
getDrawingMode()
Параметры: нет.
Возвращаемое значение: OverlayType|null
Возвращает режим рисования DrawingManager.
getMap
getMap()
Параметры: нет.
Возвращаемое значение: Map|null
Возвращает объект Map, к которому прикреплен объект DrawingManager. На этом объекте Map будут размещаться созданные оверлеи.
setDrawingMode
setDrawingMode(drawingMode)
Параметры:
Возвращаемое значение: нет.
Изменяет режим рисования DrawingManager, который определяет тип наложения, добавляемого на карту. Допустимые значения: 'marker', 'polygon', 'polyline', 'rectangle', 'circle' или null. Режим рисования null означает, что пользователь может взаимодействовать с картой как обычно, а клики не приводят к рисованию.
setMap
setMap(map)
Параметры:
  • map: Map optional.
Возвращаемое значение: нет.
Прикрепляет объект DrawingManager к указанному Map.
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: нет.
Задает параметры DrawingManager.
Унаследованные: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll.
circlecomplete
function(circle)
Аргументы:
  • circle: Circle optional Круг, который только что нарисовал пользователь.
Это событие активируется, когда пользователь заканчивает рисовать круг.
markercomplete
function(marker)
Аргументы:
  • marker: Marker – маркер, который только что нарисовал пользователь.
Это событие активируется, когда пользователь заканчивает рисовать маркер.
overlaycomplete
function(event)
Аргументы:
  • event: OverlayCompleteEvent optional – наложение, которое только что нарисовал пользователь, и его тип.
Это событие активируется, когда пользователь завершает рисование оверлея любого типа.
polygoncomplete
function(polygon)
Аргументы:
  • polygon: Polygon Многоугольник, который только что нарисовал пользователь.
Это событие активируется, когда пользователь заканчивает рисовать многоугольник.
polylinecomplete
function(polyline)
Аргументы:
  • polyline: Polyline optional – ломаная линия, которую только что нарисовал пользователь.
Это событие активируется, когда пользователь закончил рисовать ломаную линию.
rectanglecomplete
function(rectangle)
Аргументы:
  • rectangle: Rectangle optional Прямоугольник, который только что нарисовал пользователь.
Это событие активируется, когда пользователь заканчивает рисовать прямоугольник.

Интерфейс DrawingManagerOptions

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

Параметры менеджера рисования.
circleOptions
необязательно
Тип: CircleOptions optional
Настройки, которые будут применяться ко всем новым кругам, созданным с помощью этого DrawingManager. Свойства center и radius игнорируются, а свойство map нового круга всегда устанавливается на карту DrawingManager.
drawingControl
необязательно
Тип: boolean optional
По умолчанию: true.
Включено или отключено управление рисованием.
drawingControlOptions
необязательно
Тип: DrawingControlOptions optional
Параметры отображения для элемента управления рисованием.
drawingMode
необязательно
Тип: OverlayType optional
Режим рисования DrawingManager, который определяет тип наложения, добавляемого на карту. Допустимые значения: 'marker', 'polygon', 'polyline', 'rectangle', 'circle' или null. Режим рисования null означает, что пользователь может взаимодействовать с картой как обычно, а клики не приводят к рисованию.
map
необязательно
Тип: Map optional
Map, к которому прикреплен DrawingManager. На этом Map будут размещены созданные наложения.
markerOptions
необязательно
Тип: MarkerOptions optional
Параметры, которые будут применяться ко всем новым маркерам, созданным с помощью этого объекта DrawingManager. Свойство position игнорируется, а свойство map нового маркера всегда задается для карты DrawingManager.
polygonOptions
необязательно
Тип: PolygonOptions optional
Параметры, которые будут применяться к новым многоугольникам, созданным с помощью этого DrawingManager. Свойство paths игнорируется, а свойство map нового многоугольника всегда задается для карты DrawingManager.
polylineOptions
необязательно
Тип: PolylineOptions optional
Параметры, которые будут применяться к новым ломаным линиям, созданным с помощью этого объекта DrawingManager. Свойство path игнорируется, а свойство map новой ломаной линии всегда задается для карты DrawingManager.
rectangleOptions
необязательно
Тип: RectangleOptions optional
Настройки, которые будут применяться ко всем новым прямоугольникам, созданным с помощью этого инструмента (DrawingManager). Свойство bounds игнорируется, а свойство map нового прямоугольника всегда задается для карты DrawingManager.

Интерфейс DrawingControlOptions

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

Параметры отрисовки элементов управления рисованием.
drawingModes
необязательно
Тип: Array<OverlayType> optional
По умолчанию: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON].
Режимы рисования, которые будут доступны в элементе управления, в порядке их отображения. Значок в виде руки (соответствует режиму рисования null) доступен всегда, и его не нужно указывать в этом массиве.
position
необязательно
Тип: ControlPosition optional
По умолчанию: ControlPosition.TOP_LEFT.
Идентификатор положения. Используется, чтобы указать положение элемента управления на карте.

Интерфейс OverlayCompleteEvent

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

Свойства события overlaycomplete для DrawingManager.
overlay
Готовый оверлей.
type
Тип: OverlayType
Тип завершенного оверлея.

Константы OverlayType

google.maps.drawing.OverlayType Библиотека констант
"drawing"

Типы наложений, которые могут быть созданы DrawingManager. Укажите их по значению или по названию константы. Примеры: 'polygon' или google.maps.drawing.OverlayType.POLYGON.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом OverlayTypeString.

const {OverlayType} = await google.maps.importLibrary("drawing");
CIRCLE Указывает, что DrawingManager создает круги и что оверлей, заданный в событии overlaycomplete, является кругом.
MARKER Указывает, что DrawingManager создает маркеры и что оверлей, заданный в событии overlaycomplete, является маркером.
POLYGON Указывает, что DrawingManager создает многоугольники и что оверлей, заданный в событии overlaycomplete, является многоугольником.
POLYLINE Указывает, что DrawingManager создает ломаные линии и что оверлей, указанный в событии overlaycomplete, является ломаной линией.
RECTANGLE Указывает, что DrawingManager создает прямоугольники и что оверлей, заданный в событии overlaycomplete, является прямоугольником.