Drawing Library

فئة DrawingManager

google.maps.drawing.DrawingManager class

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {DrawingManager} = await google.maps.importLibrary("drawing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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)
المَعلمات: 
القيمة المعروضة:  لا شيء
يُرفق عنصر 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
أوضاع الرسم المطلوب عرضها في عنصر التحكّم بالرسم، بالترتيب الذي سيتم عرضه به يكون رمز اليد (الذي يتوافق مع وضع الرسم 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
CIRCLE تُحدِّد هذه السمة أنّ DrawingManager ينشئ دوائر وأنّ الصورة التي تظهر على سطح الشاشة في الحدث overlaycomplete هي دائرة.
MARKER تُحدِّد هذه السمة أنّ DrawingManager ينشئ علامات، وأنّ التراكب المقدَّم في حدث overlaycomplete هو علامة.
POLYGON تُحدِّد هذه السمة أنّ DrawingManager ينشئ مضلّعات، وأنّ التراكب المقدَّم في الحدث overlaycomplete هو مضلّع.
POLYLINE تُحدِّد هذه السمة أنّ DrawingManager ينشئ خطوطًا متعددة، وأنّ التراكب المقدَّم في الحدث overlaycomplete هو خط متعدد.
RECTANGLE تُحدِّد أنّ DrawingManager ينشئ مستطيلات، وأنّ الصورة التي تظهر على سطح الشاشة في الحدث overlaycomplete هي مستطيل.