Drawing Library

המחלקה DrawingManager

google.maps.drawing.DrawingManager class
extends MVCObject
library "drawing"

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

const {DrawingManager} = await google.maps.importLibrary("drawing");
DrawingManager
DrawingManager([options])
פרמטרים:
יוצר DrawingManager שמאפשר למשתמשים לצייר שכבות-על במפה, ולעבור בין סוגי שכבות-העל שרוצים לצייר באמצעות פקד ציור.
getDrawingMode
getDrawingMode()
פרמטרים: אין
ערך מוחזר: OverlayType|null
מחזירה את מצב השרטוט של DrawingManager.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
מחזירה את ה-Map שאליו מצורף ה-DrawingManager, שהוא ה-Map שעליו ימוקמו שכבות-העל שנוצרו.
setDrawingMode
setDrawingMode(drawingMode)
פרמטרים:
הערך המוחזר: אין
משנה את מצב השרטוט של DrawingManager, שמגדיר את סוג שכבת-העל שצריך להוסיף למפה. הערכים הקבילים הם 'marker',‏ 'polygon',‏ 'polyline',‏ 'rectangle',‏ 'circle' או null. מצב שרטוט של null אומר שהמשתמש יכול לבצע אינטראקציה עם המפה כרגיל, וקליקים לא משרטטים שום דבר.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
הערך המוחזר: אין
מצרפת את האובייקט DrawingManager אל Map שצוין.
setOptions
setOptions(options)
פרמטרים:
הערך המוחזר: אין
הגדרת האפשרויות של DrawingManager.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
circlecomplete
function(circle)
ארגומנטים:
  • ‫circle: Circle optional העיגול שהמשתמש צייר.
האירוע הזה מופעל כשהמשתמש מסיים לשרטט עיגול.
markercomplete
function(marker)
ארגומנטים:
  • ‫marker: Marker הסמן שהמשתמש צייר.
האירוע הזה מופעל כשהמשתמש מסיים לשרטט סמן.
overlaycomplete
function(event)
ארגומנטים:
  • ‫event: OverlayCompleteEvent optional שכבת העל שהמשתמש צייר, יחד עם סוג שכבת העל.
האירוע הזה מופעל כשהמשתמש מסיים לשרטט שכבת-על מכל סוג.
polygoncomplete
function(polygon)
ארגומנטים:
  • ‫polygon: Polygon המצולע שהמשתמש צייר.
האירוע הזה מופעל כשהמשתמש מסיים לשרטט מצולע.
polylinecomplete
function(polyline)
ארגומנטים:
  • ‫polyline: Polyline optional הקו הפוליגוני שהמשתמש צייר.
האירוע הזה מופעל כשהמשתמש מסיים לשרטט קו פוליגוני.
rectanglecomplete
function(rectangle)
ארגומנטים:
  • ‫rectangle: Rectangle optional המלבן שהמשתמש צייר.
האירוע הזה מופעל כשהמשתמש מסיים לשרטט מלבן.

ממשק DrawingManagerOptions

ממשק google.maps.drawing.DrawingManagerOptions

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

ממשק DrawingControlOptions

ממשק google.maps.drawing.DrawingControlOptions

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

ממשק OverlayCompleteEvent

ממשק google.maps.drawing.OverlayCompleteEvent

המאפיינים של אירוע overlaycomplete ב-DrawingManager.
overlay
השכבה שהושלמה.
type
סוג: OverlayType
סוג שכבת-העל שהושלמה.

קבועים של OverlayType

google.maps.drawing.OverlayType קבועים
ספרייה "drawing"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג OverlayTypeString.

const {OverlayType} = await google.maps.importLibrary("drawing");
CIRCLE מציין שה-DrawingManager יוצר עיגולים, ושהשכבה שניתנה באירוע overlaycomplete היא עיגול.
MARKER מציין שה-DrawingManager יוצר סמנים, ושהשכבה שניתנה באירוע overlaycomplete היא סמן.
POLYGON מציין שה-DrawingManager יוצר פוליגונים, ושהשכבה שניתנה באירוע overlaycomplete היא פוליגון.
POLYLINE מציין שה-DrawingManager יוצר קווים פוליגוניים, ושהשכבה שניתנה באירוע overlaycomplete היא קו פוליגוני.
RECTANGLE מציין שה-DrawingManager יוצר מלבנים, ושהשכבה שניתנה באירוע overlaycomplete היא מלבן.