Drawing Library

המחלקה DrawingManager

google.maps.drawing.DrawingManager סיווג

מאפשרת למשתמשים לשרטט על המפה סמנים, פוליגונים, קווים פוליגוניים, מלבנים ומעגלים. מצב הציור של 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

ממשק 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
מצבי הציור שיש להציג בפקד השרטוט, לפי הסדר שבו הם מוצגים. סמל היד (המתאים למצב הציור של null) זמין תמיד ואין לציין אותו במערך הזה.
position optional
סוג:  ControlPosition optional
ברירת מחדל: ControlPosition.TOP_LEFT
מזהה מיקום. משמש לציון המיקום של הפקד במפה.

ממשק OverlayCompleteEvent

ממשק google.maps.drawing.OverlayCompleteEvent

המאפיינים של אירוע שכבת-על ב-DrawingManager.
overlay
שכבת-העל שהושלמה.
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 היא מלבן.