Drawing Library

Classe DrawingManager

google.maps.drawing.DrawingManager classe
estende MVCObject
biblioteca "drawing"

Descontinuado: a funcionalidade da biblioteca de desenho na API Maps JavaScript foi descontinuada. Essa API foi descontinuada em agosto de 2025 e vai ficar indisponível em uma versão posterior da API Maps JavaScript, que será lançada em maio de 2026. Para mais informações, acesse https://developers.google.com/maps/deprecations.

Permite que os usuários desenhem marcadores, polígonos, polilinhas, retângulos e círculos no mapa. O modo de desenho do DrawingManager define o tipo de sobreposição que será criada pelo usuário. Adiciona um controle ao mapa, permitindo que o usuário mude o modo de desenho.

const {DrawingManager} = await google.maps.importLibrary("drawing");

Construtor
DrawingManager	DrawingManager([options]) Parâmetros: options: DrawingManagerOptions optional Cria um DrawingManager que permite aos usuários desenhar sobreposições no mapa e alternar entre o tipo de sobreposição a ser desenhado com um controle de desenho.

Métodos
getDrawingMode	getDrawingMode() Parâmetros: nenhum Valor de retorno: OverlayType|null Retorna o modo de desenho do DrawingManager.
getMap	getMap() Parâmetros: nenhum Valor de retorno: Map|null Retorna o Map ao qual o DrawingManager está anexado, que é o Map em que as sobreposições criadas serão colocadas.
setDrawingMode	setDrawingMode(drawingMode) Parâmetros: drawingMode: OverlayType optional Valor de retorno: nenhum Muda o modo de desenho do DrawingManager, que define o tipo de sobreposição a ser adicionada ao mapa. Os valores aceitos são 'marker', 'polygon', 'polyline', 'rectangle', 'circle' ou null. Um modo de desenho de null significa que o usuário pode interagir com o mapa normalmente, e os cliques não desenham nada.
setMap	setMap(map) Parâmetros: map: Map optional Valor de retorno: nenhum Anexa o objeto DrawingManager ao Map especificado.
setOptions	setOptions(options) Parâmetros: options: DrawingManagerOptions optional Valor de retorno: nenhum Define as opções do DrawingManager.
Herdado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventos
circlecomplete	function(circle) Argumentos: circle: Circle optional o círculo que o usuário acabou de desenhar. Esse evento é disparado quando o usuário termina de desenhar um círculo.
markercomplete	function(marker) Argumentos: marker: Marker o marcador que o usuário acabou de desenhar. Esse evento é disparado quando o usuário termina de desenhar um marcador.
overlaycomplete	function(event) Argumentos: event: OverlayCompleteEvent optional a sobreposição que o usuário acabou de desenhar, junto com o tipo dela. Esse evento é disparado quando o usuário termina de desenhar uma sobreposição de qualquer tipo.
polygoncomplete	function(polygon) Argumentos: polygon: Polygon o polígono que o usuário acabou de desenhar. Esse evento é disparado quando o usuário termina de desenhar um polígono.
polylinecomplete	function(polyline) Argumentos: polyline: Polyline optional a polilinha que o usuário acabou de desenhar. Esse evento é disparado quando o usuário termina de desenhar uma polilinha.
rectanglecomplete	function(rectangle) Argumentos: rectangle: Rectangle optional o retângulo que o usuário acabou de desenhar. Esse evento é disparado quando o usuário termina de desenhar um retângulo.

Interface DrawingManagerOptions

Interface google.maps.drawing.DrawingManagerOptions

Opções para o gerenciador de desenhos.

Propriedades
circleOptions opcional	Tipo: CircleOptions optional Opções para aplicar a todos os novos círculos criados com este DrawingManager. As propriedades center e radius são ignoradas, e a propriedade map de um novo círculo é sempre definida como o mapa do DrawingManager.
drawingControl opcional	Tipo: boolean optional Padrão: true O estado ativado/desativado do controle de desenho.
drawingControlOptions opcional	Tipo: DrawingControlOptions optional As opções de exibição do controle de desenho.
drawingMode opcional	Tipo: OverlayType optional O modo de desenho do DrawingManager, que define o tipo de sobreposição a ser adicionada ao mapa. Os valores aceitos são 'marker', 'polygon', 'polyline', 'rectangle', 'circle' ou null. Um modo de desenho de null significa que o usuário pode interagir com o mapa normalmente, e os cliques não desenham nada.
map opcional	Tipo: Map optional O Map ao qual o DrawingManager está anexado, que é o Map em que as sobreposições criadas serão colocadas.
markerOptions opcional	Tipo: MarkerOptions optional Opções para aplicar a todos os novos marcadores criados com este DrawingManager. A propriedade position é ignorada, e a propriedade map de um novo marcador é sempre definida como o mapa do DrawingManager.
polygonOptions opcional	Tipo: PolygonOptions optional Opções para aplicar a novos polígonos criados com este DrawingManager. A propriedade paths é ignorada, e a propriedade map de um novo polígono é sempre definida como o mapa do DrawingManager.
polylineOptions opcional	Tipo: PolylineOptions optional Opções para aplicar a qualquer nova polilinha criada com este DrawingManager. A propriedade path é ignorada, e a propriedade map de uma nova polilinha é sempre definida como o mapa da DrawingManager.
rectangleOptions opcional	Tipo: RectangleOptions optional Opções para aplicar a todos os novos retângulos criados com este DrawingManager. A propriedade bounds é ignorada, e a propriedade map de um novo retângulo é sempre definida como o mapa do DrawingManager.

Interface DrawingControlOptions

Interface google.maps.drawing.DrawingControlOptions

Opções para a renderização do controle de desenho.

Propriedades
drawingModes opcional	Tipo: Array<OverlayType> optional Padrão: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON] Os modos de desenho que vão aparecer no controle de desenho, na ordem em que serão exibidos. O ícone de mão (que corresponde ao modo de desenho null) está sempre disponível e não deve ser especificado nessa matriz.
position opcional	Tipo: ControlPosition optional Padrão: ControlPosition.TOP_LEFT ID da posição. Usado para especificar a posição do controle no mapa.

Interface OverlayCompleteEvent

Interface google.maps.drawing.OverlayCompleteEvent

As propriedades de um evento overlaycomplete em um DrawingManager.

Propriedades
overlay	Tipo: Marker|Polygon|Polyline|Rectangle|Circle A sobreposição concluída.
type	Tipo: OverlayType O tipo de sobreposição concluída.

Constantes OverlayType

google.maps.drawing.OverlayType biblioteca de constantes
"drawing"

Os tipos de sobreposição que podem ser criados pelo DrawingManager. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'polygon' ou google.maps.drawing.OverlayType.POLYGON.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo OverlayTypeString.

const {OverlayType} = await google.maps.importLibrary("drawing");

Constantes
CIRCLE	Especifica que o DrawingManager cria círculos e que a sobreposição fornecida no evento overlaycomplete é um círculo.
MARKER	Especifica que o DrawingManager cria marcadores e que a sobreposição fornecida no evento overlaycomplete é um marcador.
POLYGON	Especifica que o DrawingManager cria polígonos e que a sobreposição fornecida no evento overlaycomplete é um polígono.
POLYLINE	Especifica que o DrawingManager cria polilinhas e que a sobreposição fornecida no evento overlaycomplete é uma polilinha.
RECTANGLE	Especifica que o DrawingManager cria retângulos e que a sobreposição fornecida no evento overlaycomplete é um retângulo.