Drawing Library

فئة DrawingManager

google.maps.drawing.DrawingManager الصف الدراسي

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

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

الوصول من خلال الاتصال بـ const {DrawingManager} = await google.maps.importLibrary("drawing"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
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
الرقم التعريفي للموضع. يُستخدم لتحديد موضع عنصر التحكم على الخريطة.

واجهة overlayCompleteEvent

واجهة google.maps.drawing.OverlayCompleteEvent

خصائص حدث التراكب على حدث DrawingManager.
overlay
التراكب المكتمل.
type
النوع:  OverlayType
نوع التراكب المكتمل.

ثابتات الطبقات

google.maps.drawing.OverlayType ثوابت

أنواع التراكبات التي يمكن إنشاؤها بواسطة DrawingManager. حدد هذه القيم بحسب القيمة أو باستخدام اسم الثوابت. على سبيل المثال، 'polygon' أو google.maps.drawing.OverlayType.POLYGON.

الوصول من خلال الاتصال بـ const {OverlayType} = await google.maps.importLibrary("drawing"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
CIRCLE تحدِّد هذه السمة أن DrawingManager ينشئ دوائر، وأن التراكب المحدد في حدث overlaycomplete هو عبارة عن دائرة.
MARKER تحدِّد هذه العلامة أن DrawingManager ينشئ علامات، وأن التراكب المحدد في حدث overlaycomplete هو محدّد موقع.
POLYGON لتحديد أن DrawingManager ينشئ مضلعات، وأن التراكب المحدد في حدث overlaycomplete هو مضلع.
POLYLINE تحدّد هذه السمة أن DrawingManager ينشئ خطوطًا متعددة الأضلاع، وأن التراكب المحدد في حدث overlaycomplete عبارة عن خطوط متعددة الأضلاع.
RECTANGLE تحدِّد هذه السمة أن DrawingManager ينشئ مستطيلات، وأن التراكب الظاهر في حدث overlaycomplete هو مستطيل.