Drawing Library

‫DrawingManager class

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 ערך מוחזר:  אין משנה את מצב הציור של DrawingManager, שמגדיר את סוג שכבת העל שתוסף למפה. הערכים הקבילים הם 'marker',‏ 'polygon',‏ 'polyline',‏ 'rectangle',‏ 'circle' או null. מצב ציור של null אומר שהמשתמש יכול לבצע אינטראקציה עם המפה כרגיל, וקליקים לא מציירים כלום.
setMap	setMap(map) פרמטרים:  map:  Map ערך מוחזר:  אין מצרף את אובייקט DrawingManager ל-Map שצוין.
setOptions	setOptions(options) פרמטרים:  options:  DrawingManagerOptions ערך מוחזר:  אין מגדיר את האפשרויות של 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 interface

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 interface

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 interface

google.maps.drawing.OverlayCompleteEvent ממשק

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

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

קבועי OverlayType

google.maps.drawing.OverlayType constants

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

אפשר להתקשר אל const {OverlayType} = await google.maps.importLibrary("drawing") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

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