Drawing Library

Classe DrawingManager

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

Permet aux utilisateurs de dessiner des repères, des polygones, des polylignes, des rectangles et des cercles sur la carte. Le mode de dessin de DrawingManager définit le type de superposition qui sera créé par l'utilisateur. Ajoute une commande à la carte, permettant à l'utilisateur de changer de mode de dessin.

const {DrawingManager} = await google.maps.importLibrary("drawing");
DrawingManager
DrawingManager([options])
Paramètres :
Crée un DrawingManager qui permet aux utilisateurs de dessiner des superpositions sur la carte et de basculer entre les types de superpositions à dessiner à l'aide d'une commande de dessin.
getDrawingMode
getDrawingMode()
Paramètres : aucun
Valeur renvoyée : OverlayType|null
Renvoie le mode de dessin de DrawingManager.
getMap
getMap()
Paramètres : aucun
Valeur renvoyée : Map|null
Renvoie l'objet Map auquel l'objet DrawingManager est associé, c'est-à-dire l'objet Map sur lequel les superpositions créées seront placées.
setDrawingMode
setDrawingMode(drawingMode)
Paramètres :
Valeur renvoyée : aucune
Modifie le mode de dessin de DrawingManager, qui définit le type de superposition à ajouter à la carte. Les valeurs acceptées sont 'marker', 'polygon', 'polyline', 'rectangle', 'circle' ou null. Un mode de dessin null signifie que l'utilisateur peut interagir normalement avec la carte et que les clics ne dessinent rien.
setMap
setMap(map)
Paramètres :
  • map : Map optional
Valeur renvoyée : aucune
Associe l'objet DrawingManager à l'Map spécifié.
setOptions
setOptions(options)
Paramètres :
Valeur renvoyée : aucune
Définit les options de DrawingManager.
Héritées : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
circlecomplete
function(circle)
Arguments :
  • circle : Circle optional Cercle que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a fini de dessiner un cercle.
markercomplete
function(marker)
Arguments :
  • marker : Marker Repère que l'utilisateur vient de tracer.
Cet événement est déclenché lorsque l'utilisateur a fini de dessiner un repère.
overlaycomplete
function(event)
Arguments :
  • event : OverlayCompleteEvent optional Superposition que l'utilisateur vient de dessiner, ainsi que son type.
Cet événement est déclenché lorsque l'utilisateur a terminé de dessiner une superposition de n'importe quel type.
polygoncomplete
function(polygon)
Arguments :
  • polygon : Polygon Polygone que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a terminé de dessiner un polygone.
polylinecomplete
function(polyline)
Arguments :
  • polyline : Polyline optional Polyligne que l'utilisateur vient de tracer.
Cet événement est déclenché lorsque l'utilisateur a terminé de dessiner une polyligne.
rectanglecomplete
function(rectangle)
Arguments :
  • rectangle : Rectangle optional Rectangle que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a fini de dessiner un rectangle.

Interface DrawingManagerOptions

google.maps.drawing.DrawingManagerOptions interface

Options du gestionnaire de dessins.
circleOptions
facultatif
Type : CircleOptions optional
Options à appliquer à tous les nouveaux cercles créés avec ce DrawingManager. Les propriétés center et radius sont ignorées, et la propriété map d'un nouveau cercle est toujours définie sur la carte de DrawingManager.
drawingControl
facultatif
Type : boolean optional
Par défaut : true
État d'activation/de désactivation de la commande de dessin.
drawingControlOptions
facultatif
Type : DrawingControlOptions optional
Options d'affichage de la commande de dessin.
drawingMode
facultatif
Type : OverlayType optional
Mode de dessin de DrawingManager, qui définit le type de superposition à ajouter à la carte. Les valeurs acceptées sont 'marker', 'polygon', 'polyline', 'rectangle', 'circle' ou null. Un mode de dessin null signifie que l'utilisateur peut interagir normalement avec la carte et que les clics ne dessinent rien.
map
facultatif
Type : Map optional
Le Map auquel le DrawingManager est associé, qui est le Map sur lequel les superpositions créées seront placées.
markerOptions
facultatif
Type : MarkerOptions optional
Options à appliquer à tous les nouveaux repères créés avec ce DrawingManager. La propriété position est ignorée, et la propriété map d'un nouveau repère est toujours définie sur la carte de DrawingManager.
polygonOptions
facultatif
Type : PolygonOptions optional
Options à appliquer à tous les nouveaux polygones créés avec ce DrawingManager. La propriété paths est ignorée, et la propriété map d'un nouveau polygone est toujours définie sur la carte de DrawingManager.
polylineOptions
facultatif
Type : PolylineOptions optional
Options à appliquer à toutes les nouvelles polylignes créées avec ce DrawingManager. La propriété path est ignorée, et la propriété map d'une nouvelle polyligne est toujours définie sur la carte de DrawingManager.
rectangleOptions
facultatif
Type : RectangleOptions optional
Options à appliquer à tous les nouveaux rectangles créés avec ce DrawingManager. La propriété bounds est ignorée, et la propriété map d'un nouveau rectangle est toujours définie sur la carte de DrawingManager.

Interface DrawingControlOptions

google.maps.drawing.DrawingControlOptions interface

Options de rendu de la commande de dessin.
drawingModes
facultatif
Type : Array<OverlayType> optional
Par défaut : [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON]
Modes de dessin à afficher dans la commande de dessin, dans l'ordre dans lequel ils doivent être affichés. L'icône de main (qui correspond au mode de dessin null) est toujours disponible et ne doit pas être spécifiée dans ce tableau.
position
facultatif
Type : ControlPosition optional
Par défaut : ControlPosition.TOP_LEFT
ID de la position. Permet de spécifier la position de la commande sur la carte.

Interface OverlayCompleteEvent

google.maps.drawing.OverlayCompleteEvent interface

Propriétés d'un événement overlaycomplete sur un DrawingManager.
overlay
L'overlay terminé.
type
Type : OverlayType
Type de la superposition terminée.

OverlayType

google.maps.drawing.OverlayType Bibliothèque de constantes
"drawing"

Types de superpositions pouvant être créés par DrawingManager. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'polygon' ou google.maps.drawing.OverlayType.POLYGON.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type OverlayTypeString.

const {OverlayType} = await google.maps.importLibrary("drawing");
CIRCLE Spécifie que DrawingManager crée des cercles et que la superposition donnée dans l'événement overlaycomplete est un cercle.
MARKER Indique que DrawingManager crée des repères et que la superposition indiquée dans l'événement overlaycomplete est un repère.
POLYGON Indique que l'DrawingManager crée des polygones et que la superposition indiquée dans l'événement overlaycomplete est un polygone.
POLYLINE Indique que l'DrawingManager crée des polylignes et que la superposition donnée dans l'événement overlaycomplete est une polyligne.
RECTANGLE Indique que l'objet DrawingManager crée des rectangles et que la superposition indiquée dans l'événement overlaycomplete est un rectangle.