Drawing Library

הכיתה DrawingManager

google.maps.drawing.DrawingManager class

מאפשרת למשתמשים לצייר במפה סמנים, פוליגונים, קווים פוליגונליים, מלבנים ועיגולים. מצב הציור של DrawingManager מגדיר את סוג שכבת-העל שתיצור המשתמש. הוספת אמצעי בקרה למפה שמאפשר למשתמש לעבור בין מצבי ציור.

הכיתה הזו היא תת-מחלקה של MVCObject.

אפשר לגשת אליו באמצעות חיוג למספר const {DrawingManager} = await google.maps.importLibrary("drawing"). ספריות ב-Maps JavaScript API

יצרן
DrawingManager	DrawingManager([options]) פרמטרים:  options:  DrawingManagerOptions optional יצירת DrawingManager שמאפשר למשתמשים לצייר שכבות-על במפה, ולעבור בין סוגי השכבות-העל שרוצים לצייר באמצעות פקדי ציור.

Methods
getDrawingMode	getDrawingMode() פרמטרים:  ללא ערך המוחזר:  OverlayType|null הפונקציה מחזירה את מצב הציור של DrawingManager.
getMap	getMap() פרמטרים:  ללא ערך המוחזר:  Map הפונקציה מחזירה את ה-Map שאליו מצורף ה-DrawingManager, כלומר ה-Map שבו יוצגו שכבות-העל שנוצרו.
setDrawingMode	setDrawingMode(drawingMode) פרמטרים:  drawingMode:  OverlayType optional ערך המוחזר:  None שינוי של מצב הציור של DrawingManager, שמגדיר את סוג שכבת-העל שתתווסף למפה. הערכים הקבילים הם 'marker',‏ 'polygon',‏ 'polyline',‏ 'rectangle',‏ 'circle' או null. מצב ציור של null מציין שהמשתמש יכול לקיים אינטראקציה עם המפה כרגיל, ולחיצות לא יוצרות שום דבר.
setMap	setMap(map) פרמטרים:  map:  Map ערך המוחזר:  None הצמדת האובייקט DrawingManager ל-Map שצוין.
setOptions	setOptions(options) פרמטרים:  options:  DrawingManagerOptions ערך המוחזר:  None הגדרת האפשרויות של DrawingManager.
עובר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

אירועים
circlecomplete	function(circle) ארגומנטים:  circle:  Circle העיגול שהמשתמש צייר זה עתה. האירוע הזה מופעל כשהמשתמש מסיים לצייר עיגול.
markercomplete	function(marker) ארגומנטים:  marker:  Marker הסמן שהמשתמש צייר זה עתה. האירוע הזה מופעל כשהמשתמש מסיים לצייר סמן.
overlaycomplete	function(event) ארגומנטים:  event:  OverlayCompleteEvent שכבת-העל שהמשתמש צייר זה עתה, יחד עם סוג שכבת-העל. האירוע הזה מופעל כשהמשתמש מסיים לצייר שכבת-על מכל סוג שהוא.
polygoncomplete	function(polygon) ארגומנטים:  polygon:  Polygon הפוליגון שהמשתמש צייר זה עתה. האירוע הזה מופעל כשהמשתמש מסיים לצייר פוליגון.
polylinecomplete	function(polyline) ארגומנטים:  polyline:  Polyline הקו הפוליגוני שהמשתמש צייר זה עתה. האירוע הזה מופעל כשהמשתמש מסיים לצייר קו פוליגון.
rectanglecomplete	function(rectangle) ארגומנטים:  rectangle:  Rectangle המלבן שהמשתמש צייר זה עתה. האירוע הזה מופעל כשהמשתמש מסיים לצייר מלבן.

הממשק DrawingManagerOptions

ממשק google.maps.drawing.DrawingManagerOptions

אפשרויות לניהול הציורים.

מאפיינים
circleOptions optional	סוג:  CircleOptions optional אפשרויות שיחולו על כל עיגולים חדשים שייווצרו באמצעות DrawingManager הזה. המערכת מתעלמת מהמאפיינים center ו-radius, והמאפיין map של עיגול חדש מוגדר תמיד למפה של DrawingManager.
drawingControl optional	סוג:  boolean optional ברירת מחדל: true המצב המופעל/מושבת של אמצעי הבקרה על השרטוט.
drawingControlOptions optional	סוג:  DrawingControlOptions optional אפשרויות התצוגה של פקדי השרטוט.
drawingMode optional	סוג:  OverlayType optional מצב הציור של DrawingManager, שמגדיר את סוג שכבת-העל שתתווסף למפה. הערכים הקבילים הם 'marker',‏ 'polygon',‏ 'polyline',‏ 'rectangle',‏ 'circle' או null. מצב ציור של null מציין שהמשתמש יכול לקיים אינטראקציה עם המפה כרגיל, ולחיצות לא יוצרות שום דבר.
map optional	סוג:  Map optional ה-Map שאליו מצורף ה-DrawingManager, כלומר ה-Map שבו יוצגו שכבות-העלון שנוצרו.
markerOptions optional	סוג:  MarkerOptions optional אפשרויות שחלות על כל סמנים חדשים שייווצרו באמצעות DrawingManager הזה. המערכת מתעלמת מהנכס position, והנכס map של סמן חדש מוגדר תמיד למפה של DrawingManager.
polygonOptions optional	סוג:  PolygonOptions optional אפשרויות שחלות על כל הפוליגונים החדשים שנוצרים באמצעות DrawingManager הזה. המערכת מתעלמת מהנכס paths, והנכס map של פוליגון חדש מוגדר תמיד למפה של DrawingManager.
polylineOptions optional	סוג:  PolylineOptions optional אפשרויות שחלות על כל קווים פוליגונים חדשים שייווצרו באמצעות DrawingManager הזה. המערכת מתעלמת מהנכס path, והנכס map של קו פוליגון חדש מוגדר תמיד למפה של DrawingManager.
rectangleOptions optional	סוג:  RectangleOptions optional אפשרויות שיחולו על כל המלבנים החדשים שייווצרו באמצעות DrawingManager הזה. המערכת מתעלמת מהנכס bounds, והנכס map של מלבן חדש מוגדר תמיד למפה של DrawingManager.

הממשק DrawingControlOptions

ממשק google.maps.drawing.DrawingControlOptions

אפשרויות לעיבוד של רכיב הבקרה של כלי השרטוט.

מאפיינים
drawingModes optional	סוג:  Array<OverlayType> optional ברירת מחדל: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON] מצבי הציור שיוצגו בחלונית הבקרה של הציור, לפי הסדר שבו הם יוצגו. סמל היד (שתואם למצב הציור null) תמיד זמין ואין לציין אותו במערך הזה.
position optional	סוג:  ControlPosition optional ברירת מחדל: ControlPosition.TOP_LEFT מזהה המיקום. משמש לציון המיקום של הרכיב במפה.

הממשק OverlayCompleteEvent

ממשק google.maps.drawing.OverlayCompleteEvent

המאפיינים של אירוע overlaycomplete ב-DrawingManager.

מאפיינים
overlay	סוג:  Marker|Polygon|Polyline|Rectangle|Circle שכבת-העל השלמה.
type	סוג:  OverlayType הסוג של שכבת-העל שהושלמו.

קבועים של OverlayType

google.maps.drawing.OverlayType קבועים

סוגי שכבות-העל שיכולות להיווצר על ידי DrawingManager. אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'polygon' או google.maps.drawing.OverlayType.POLYGON.

אפשר לגשת אליו באמצעות חיוג למספר const {OverlayType} = await google.maps.importLibrary("drawing"). ספריות ב-Maps JavaScript API

קבועים
CIRCLE	מציין שה-DrawingManager יוצר עיגולים, וששכבת-העל שצוינה באירוע overlaycomplete היא עיגול.
MARKER	מציין שה-DrawingManager יוצר סמנים, וששכבת-העל שצוינה באירוע overlaycomplete היא סמן.
POLYGON	מציין שהפונקציה DrawingManager יוצרת פוליגונים, וששכבת-העל שצוינה באירוע overlaycomplete היא פוליגון.
POLYLINE	מציין שהפונקציה DrawingManager יוצרת קווים פוליגונים, וששכבת-העל שצוינה באירוע overlaycomplete היא קו פוליגון.
RECTANGLE	מציין שהפונקציה DrawingManager יוצרת מלבנים, וששכבת-העל שצוינה באירוע overlaycomplete היא מלבן.