Drawing Library

DrawingManager

Classe google.maps.drawing.DrawingManager

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

Cette classe étend MVCObject.

Accédez à en appelant const {DrawingManager} = await google.maps.importLibrary("drawing"). Consultez Bibliothèques dans l'API Maps JavaScript.
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 différents types de superpositions à l'aide d'une commande de dessin.
getDrawingMode
getDrawingMode()
Paramètres:aucun
Valeur renvoyée:OverlayType|null
Renvoie le mode dessin de DrawingManager.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
Renvoie le Map auquel le DrawingManager est associé, à savoir le Map sur lequel les superpositions seront créées.
setDrawingMode
setDrawingMode(drawingMode)
Paramètres:
Valeur de retour:aucune
Modifie le mode de dessin de DrawingManager, qui définit le type de superposition à ajouter sur la carte. Les valeurs acceptées sont 'marker', 'polygon', 'polyline', 'rectangle', 'circle' ou null. Le mode de dessin null signifie que l'utilisateur peut interagir normalement avec la carte, et les clics ne génèrent rien.
setMap
setMap(map)
Paramètres:
Valeur de retour:aucune
Attache l'objet DrawingManager au Map spécifié.
setOptions
setOptions(options)
Paramètres:
Valeur de retour:aucune
Définit les options de DrawingManager.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
circlecomplete
function(circle)
Arguments: 
  • circle:  Circle cercle que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a terminé de tracer un cercle.
markercomplete
function(marker)
Arguments: 
  • marker:  Marker repère que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a terminé de dessiner un repère.
overlaycomplete
function(event)
Arguments: 
  • event:  OverlayCompleteEvent superposition que l'utilisateur vient de dessiner, avec le type de superposition.
Cet événement est déclenché lorsque l'utilisateur a fini 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 polyligne que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a terminé de dessiner une polyligne.
rectanglecomplete
function(rectangle)
Arguments: 
  • rectangle:  Rectangle rectangle que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a terminé de tracer un rectangle.

Interface DrawingManagerOptions

google.maps.drawing.DrawingManagerOptions interface

Options pour le gestionnaire de dessins
circleOptions optional
Type:CircleOptions optional
Options à appliquer à tous les 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 optional
Type:boolean optional
Par défaut:true
État activé/désactivé de la commande de dessin
drawingControlOptions optional
Type:DrawingControlOptions optional
Options d'affichage de la commande de dessin
drawingMode optional
Type:OverlayType optional
Le mode de dessin de DrawingManager, qui définit le type de superposition à ajouter sur la carte. Les valeurs acceptées sont 'marker', 'polygon', 'polyline', 'rectangle', 'circle' ou null. Le mode de dessin null signifie que l'utilisateur peut interagir normalement avec la carte, et les clics ne génèrent rien.
map optional
Type:Map optional
Le Map auquel le DrawingManager est associé, à savoir le Map sur lequel les superpositions seront créées.
markerOptions optional
Type:MarkerOptions optional
Options à appliquer à tous les 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 optional
Type:PolygonOptions optional
Options à appliquer à tous les polygones créés avec cet élément 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 optional
Type:PolylineOptions optional
Options à appliquer aux 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 optional
Type:RectangleOptions optional
Options à appliquer à tout rectangle créé 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 d'affichage de la commande de dessin
drawingModes optional
Type:Array<OverlayType> optional
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 dessin null) est toujours disponible et ne doit pas être spécifiée dans ce tableau.
position optional
Type:ControlPosition optional
ID de 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 en superposition sur une DrawingManager.
overlay
Superposition terminée.
type
Type de superposition terminée.

Constantes OverlayType

constantes google.maps.drawing.OverlayType

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

Accédez à en appelant const {OverlayType} = await google.maps.importLibrary("drawing"). Consultez Bibliothèques dans l'API Maps JavaScript.
CIRCLE Spécifie que DrawingManager crée des cercles et que la superposition fournie dans l'événement overlaycomplete est un cercle.
MARKER Spécifie que DrawingManager crée des repères et que la superposition fournie dans l'événement overlaycomplete est un repère.
POLYGON Spécifie que DrawingManager crée des polygones et que la superposition fournie dans l'événement overlaycomplete est un polygone.
POLYLINE Spécifie que DrawingManager crée des polylignes et que la superposition fournie dans l'événement overlaycomplete est une polyligne.
RECTANGLE Spécifie que DrawingManager crée des rectangles et que la superposition fournie dans l'événement overlaycomplete est un rectangle.