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éée par l'utilisateur. Ajoute une commande à la carte, ce qui permet à l'utilisateur de changer de mode de dessin.

Cette classe étend MVCObject.

Pour y accéder, appelez 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 passer d'un type de superposition à un autre à 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 DrawingManager est associé, qui correspond au Map sur lequel les superpositions créées seront placées.
setDrawingMode
setDrawingMode(drawingMode)
Paramètres: 
Return Value (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 comme d'habitude, et que les clics ne dessinent rien.
setMap
setMap(map)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
Associe l'objet DrawingManager au Map spécifié.
setOptions
setOptions(options)
Paramètres: 
Return Value (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 est déclenché lorsque l'utilisateur a fini de dessiner un cercle.
markercomplete
function(marker)
Arguments: 
  • markerMarker Le repère que l'utilisateur vient de dessiner.
Cet événement est déclenché lorsque l'utilisateur a fini de dessiner un repère.
overlaycomplete
function(event)
Arguments: 
  • eventOverlayCompleteEvent 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 fini 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 fini de dessiner une polyligne.
rectanglecomplete
function(rectangle)
Arguments: 
  • rectangleRectangle (rectangle que l'utilisateur vient de dessiner).
Cet événement est déclenché lorsque l'utilisateur a fini de dessiner un rectangle.

DrawingManagerOptions.

Interface google.maps.drawing.DrawingManagerOptions

Options du gestionnaire de dessins

circleOptions optional
Type:CircleOptions optional
Options à appliquer aux 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 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
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 comme d'habitude, et que les clics ne dessinent rien.
map optional
Type:Map optional
Le Map auquel le DrawingManager est associé, qui est le Map sur lequel les superpositions créées seront placées.
markerOptions optional
Type:MarkerOptions optional
Options à appliquer aux 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 optional
Type:PolygonOptions optional
Options à appliquer aux 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 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 à tous les 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.

DrawingControlOptions.

Interface google.maps.drawing.DrawingControlOptions

Options pour le 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 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 position. Permet de spécifier la position de la commande sur la carte.

OverlayCompleteEvent

Interface google.maps.drawing.OverlayCompleteEvent

Propriétés d'un événement de superpositioncomplete 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éées par le DrawingManager. Spécifiez-les à l'aide d'une valeur ou du nom de la constante. (par exemple, 'polygon' ou google.maps.drawing.OverlayType.POLYGON).

Pour y accéder, appelez const {OverlayType} = await google.maps.importLibrary("drawing"). Consultez Bibliothèques dans l'API Maps JavaScript.

CIRCLE Indique que DrawingManager crée des cercles et que la superposition fournie dans l'événement overlaycomplete est un cercle.
MARKER Indique que DrawingManager crée des repères et que la superposition fournie dans l'événement overlaycomplete est un repère.
POLYGON Indique que DrawingManager crée des polygones et que la superposition fournie dans l'événement overlaycomplete est un polygone.
POLYLINE Indique que DrawingManager crée des polylignes et que la superposition fournie dans l'événement overlaycomplete est une polyligne.
RECTANGLE Indique que DrawingManager crée des rectangles et que la superposition fournie dans l'événement overlaycomplete est un rectangle.