Drawing Library

Classe 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 de dessin de DrawingManager définit le type de superposition qui sera créé par l'utilisateur. Ajoute une commande à la carte, ce qui permet à l'utilisateur de changer de mode de dessin.

Cette classe étend MVCObject.

Accédez-y en appelant const {DrawingManager} = await google.maps.importLibrary("drawing"). Consultez la section Bibliothèques de 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 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
Renvoie le Map auquel le DrawingManager est associé, c'est-à-dire le 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 avec la carte normalement, et que les clics ne dessinent rien.
setMap
setMap(map)
Paramètres:
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é: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
circlecomplete
function(circle)
Arguments: 
  • circleCircle Cercle que l'utilisateur vient de dessiner.
Cet événement se déclenche lorsque l'utilisateur a terminé de dessiner un cercle.
markercomplete
function(marker)
Arguments: 
  • markerMarker Point que l'utilisateur vient de dessiner.
Cet événement se déclenche lorsque l'utilisateur a terminé de dessiner un repère.
overlaycomplete
function(event)
Arguments: 
  • eventOverlayCompleteEvent 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: 
  • polygonPolygon Polygone que l'utilisateur vient de dessiner.
Cet événement se déclenche lorsque l'utilisateur a terminé de dessiner un polygone.
polylinecomplete
function(polyline)
Arguments: 
  • polylinePolyline Polyligne que l'utilisateur vient de dessiner.
Cet événement se déclenche lorsque l'utilisateur a terminé de dessiner une polyligne.
rectanglecomplete
function(rectangle)
Arguments: 
  • rectangleRectangle Rectangle que l'utilisateur vient de dessiner.
Cet événement se déclenche lorsque l'utilisateur a terminé de dessiner un rectangle.

Interface DrawingManagerOptions

Interface google.maps.drawing.DrawingManagerOptions

Options du gestionnaire de dessins.

circleOptions optional
Type:CircleOptions optional
Options à appliquer à tous les nouveaux cercles créés avec cette 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 pour le contrôle de dessin.
drawingMode optional
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 avec la carte normalement, et que les clics ne dessinent rien.
map optional
Type:Map optional
Map auquel le DrawingManager est associé, c'est-à-dire le Map sur lequel les superpositions créées seront placées.
markerOptions optional
Type:MarkerOptions optional
Options à appliquer à tous les nouveaux repères créés avec cette 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 nouveaux polygones créés avec cette 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 à toutes les nouvelles polylignes créées avec cette 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 à tous les rectangles créés avec cette 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

Interface google.maps.drawing.DrawingControlOptions

Options de rendu 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 s'afficher. L'icône de la main (qui correspond au mode de dessin null) est toujours disponible et ne doit pas être spécifiée dans ce tableau.
position optional
Type:ControlPosition optional
ID de la position. Permet de spécifier la position de la commande sur la carte.

Interface OverlayCompleteEvent

Interface google.maps.drawing.OverlayCompleteEvent

Propriétés d'un événement overlaycomplete sur un DrawingManager.

overlay
Superposition terminée.
type
Type de la superposition terminée.

Constantes OverlayType

Constantes google.maps.drawing.OverlayType

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).

Accédez-y en appelant const {OverlayType} = await google.maps.importLibrary("drawing"). Consultez la section Bibliothèques de l'API Maps JavaScript.

CIRCLE Spécifie que DrawingManager crée des cercles et que la superposition indiqué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 DrawingManager crée des polygones et que la superposition indiquée dans l'événement overlaycomplete est un polygone.
POLYLINE Indique que DrawingManager crée des polylignes et que la superposition indiquée dans l'événement overlaycomplete est une polyligne.
RECTANGLE Indique que DrawingManager crée des rectangles et que la superposition indiquée dans l'événement overlaycomplete est un rectangle.