Drawing Library

המחלקה DrawingManager

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

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

הכיתה הזו משתרעת על פני MVCObject.

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

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

שיטות
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

ממשק 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

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