Drawing Library

‫DrawingManager class

google.maps.drawing.DrawingManager class

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

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {DrawingManager} = await google.maps.importLibrary("drawing") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
DrawingManager
DrawingManager([options])
פרמטרים: 
יוצר DrawingManager שמאפשר למשתמשים לצייר שכבות-על במפה ולעבור בין סוגי שכבות-העל שרוצים לצייר באמצעות כלי ציור.
getDrawingMode
getDrawingMode()
פרמטרים:  אין
ערך מוחזר:  OverlayType|null
מחזירה את מצב הציור של DrawingManager.
getMap
getMap()
פרמטרים:  אין
ערך מוחזר:  Map
הפונקציה מחזירה את Map שאליו מצורף DrawingManager, שהוא Map שבו ימוקמו שכבות העל שנוצרו.
setDrawingMode
setDrawingMode(drawingMode)
פרמטרים: 
ערך מוחזר:  אין
משנה את מצב הציור של DrawingManager, שמגדיר את סוג שכבת העל שתוסף למפה. הערכים הקבילים הם 'marker',‏ 'polygon',‏ 'polyline',‏ 'rectangle',‏ 'circle' או null. מצב ציור של null אומר שהמשתמש יכול לבצע אינטראקציה עם המפה כרגיל, וקליקים לא מציירים כלום.
setMap
setMap(map)
פרמטרים: 
ערך מוחזר:  אין
מצרף את אובייקט DrawingManager ל-Map שצוין.
setOptions
setOptions(options)
פרמטרים: 
ערך מוחזר:  אין
מגדיר את האפשרויות של 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
השכבת-העל שהושלמה.
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.
CIRCLE מציין שהפקודה DrawingManager יוצרת עיגולים, ושהשכבת-העל שצוינה באירוע overlaycomplete היא עיגול.
MARKER מציין שהרכיב DrawingManager יוצר סמנים, והשכבת-העל שצוינה באירוע overlaycomplete היא סמן.
POLYGON מציין שהתג DrawingManager יוצר מצולעים, וששכבת-העל שצוינה באירוע overlaycomplete היא מצולע.
POLYLINE מציין שהאירוע DrawingManager יוצר קווים שבורים, וששכבת-העל שצוינה באירוע overlaycomplete היא קו שבור.
RECTANGLE מציין שהתג DrawingManager יוצר מלבנים, וששכבת העל שצוינה באירוע overlaycomplete היא מלבן.