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)
المَعلمات: 
قيمة الإرجاع: لا شيء
لإرفاق الكائن 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

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