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)
پارامترها: 
  • ‫map:  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
پیش‌فرض: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON]
حالت‌های ترسیم برای نمایش در کنترل ترسیم، به‌ترتیبی که باید نمایش داده شوند. نماد دست (که با حالت طراحی null مطابقت دارد) همیشه دردسترس است و نباید در این آرایه مشخص شود.
position optional
نوع:  ControlPosition optional
پیش‌فرض: ControlPosition.TOP_LEFT
شناسه موقعیت. برای مشخص کردن موقعیت کنترل روی نقشه استفاده می‌شود.

میانای OverlayCompleteEvent

میانا google.maps.drawing.OverlayCompleteEvent

ویژگی‌های رویداد overlaycomplete در 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 مستطیل است.