Drawing Library

فئة DrawingManager

google.maps.drawing.DrawingManager class

تسمح للمستخدمين برسم العلامات والمضلّعات والخطوط المتعددة والمستطيلات والدوائر على الخريطة. يحدِّد وضع الرسم في DrawingManager نوع الصورة التي سينشئها المستخدم. تضيف عنصر تحكّم إلى الخريطة، ما يسمح للمستخدم بالتبديل بين أوضاع الرسم.

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {DrawingManager} = await google.maps.importLibrary("drawing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
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 واجهة

خصائص حدث 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
CIRCLE	تُحدِّد هذه السمة أنّ DrawingManager ينشئ دوائر وأنّ الصورة التي تظهر على سطح الشاشة في الحدث overlaycomplete هي دائرة.
MARKER	تُحدِّد هذه السمة أنّ DrawingManager ينشئ علامات، وأنّ التراكب المقدَّم في حدث overlaycomplete هو علامة.
POLYGON	تُحدِّد هذه السمة أنّ DrawingManager ينشئ مضلّعات، وأنّ التراكب المقدَّم في الحدث overlaycomplete هو مضلّع.
POLYLINE	تُحدِّد هذه السمة أنّ DrawingManager ينشئ خطوطًا متعددة، وأنّ التراكب المقدَّم في الحدث overlaycomplete هو خط متعدد.
RECTANGLE	تُحدِّد أنّ DrawingManager ينشئ مستطيلات، وأنّ الصورة التي تظهر على سطح الشاشة في الحدث overlaycomplete هي مستطيل.