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 مستطیل است.