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 interface

google.maps.drawing.DrawingManagerOptions interface

خيارات مدير الرسومات

الخصائص
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 interface

google.maps.drawing.DrawingControlOptions interface

خيارات عرض عنصر التحكّم في الرسم

الخصائص
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 interface

خصائص حدث overlaycomplete على 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 هو مستطيل.