Drawing Library

فئة DrawingManager

google.maps.drawing.DrawingManager class
extends MVCObject
library "drawing"

ميزة متوقّفة نهائيًا: تم إيقاف وظيفة مكتبة الرسم في Maps JavaScript API نهائيًا. تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا في أغسطس 2025، ولن تكون متاحة في إصدار لاحق من Maps JavaScript API سيتم طرحه في مايو 2026. لمزيد من المعلومات، يُرجى الاطّلاع على https://developers.google.com/maps/deprecations

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

const {DrawingManager} = await google.maps.importLibrary("drawing");

الشركة المصنِّعة
DrawingManager	DrawingManager([options]) المَعلمات: options: DrawingManagerOptions optional تنشئ هذه الدالة DrawingManager يتيح للمستخدمين رسم تراكبات على الخريطة والتبديل بين نوع التراكب الذي سيتم رسمه باستخدام عنصر تحكّم في الرسم.

الطُرق
getDrawingMode	getDrawingMode() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: OverlayType|null تعرض وضع الرسم في DrawingManager.
getMap	getMap() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: Map|null تعرض هذه السمة Map الذي تم إرفاق DrawingManager به، وهو Map الذي سيتم وضع العناصر المضافة عليه.
setDrawingMode	setDrawingMode(drawingMode) المَعلمات: drawingMode: OverlayType optional القيمة المعروضة: لا شيء يغيّر وضع الرسم في DrawingManager، والذي يحدّد نوع التراكب الذي ستتم إضافته على الخريطة. القيم المقبولة هي 'marker' أو 'polygon' أو 'polyline' أو 'rectangle' أو 'circle' أو null. يعني وضع الرسم null أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا تؤدي النقرات إلى رسم أي شيء.
setMap	setMap(map) المَعلمات: map: Map optional القيمة المعروضة: لا شيء يتم إرفاق عنصر DrawingManager بـ Map المحدّد.
setOptions	setOptions(options) المَعلمات: options: DrawingManagerOptions optional القيمة المعروضة: لا شيء لضبط خيارات DrawingManager.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الفعاليات
circlecomplete	function(circle) الوسيطات: ‫circle: Circle optional الدائرة التي رسمها المستخدم للتو. يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم دائرة.
markercomplete	function(marker) الوسيطات: ‫marker: Marker العلامة التي رسمها المستخدم للتو. يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم علامة.
overlaycomplete	function(event) الوسيطات: ‫event: OverlayCompleteEvent optional يمثّل هذا الحدث العنصر الذي رسمه المستخدم للتو، بالإضافة إلى نوعه. يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم تراكب من أي نوع.
polygoncomplete	function(polygon) الوسيطات: ‫polygon: Polygon المضلّع الذي رسمه المستخدم للتوّ يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم مضلّع.
polylinecomplete	function(polyline) الوسيطات: ‫polyline: Polyline optional الشكل المتعدّد الخطوط الذي رسمه المستخدم للتو. يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم خطوط متعدّدة.
rectanglecomplete	function(rectangle) الوسيطات: ‫rectangle: Rectangle optional المستطيل الذي رسمه المستخدم للتو. يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم مستطيل.

DrawingManagerOptions interface

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

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

الخصائص
circleOptions اختياري	النوع: CircleOptions optional الخيارات التي سيتم تطبيقها على أي دوائر جديدة يتم إنشاؤها باستخدام DrawingManager. يتم تجاهل السمتَين center وradius، ويتم دائمًا ضبط السمة map لدائرة جديدة على خريطة DrawingManager.
drawingControl اختياري	النوع: boolean optional القيمة التلقائية: true حالة تفعيل/إيقاف عنصر التحكّم في الرسم
drawingControlOptions اختياري	النوع: DrawingControlOptions optional خيارات العرض لعنصر التحكّم في الرسم
drawingMode اختياري	النوع: OverlayType optional وضع الرسم في DrawingManager، والذي يحدّد نوع التراكب الذي ستتم إضافته على الخريطة. القيم المقبولة هي 'marker' أو 'polygon' أو 'polyline' أو 'rectangle' أو 'circle' أو null. يعني وضع الرسم null أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا تؤدي النقرات إلى رسم أي شيء.
map اختياري	النوع: Map optional ‫Map الذي تم إرفاق DrawingManager به، وهو Map الذي سيتم وضع العناصر المضافة عليه.
markerOptions اختياري	النوع: MarkerOptions optional الخيارات التي سيتم تطبيقها على أي علامات جديدة يتم إنشاؤها باستخدام DrawingManager. يتم تجاهل السمة position، ويتم دائمًا ضبط السمة map لعلامة جديدة على خريطة DrawingManager.
polygonOptions اختياري	النوع: PolygonOptions optional خيارات لتطبيقها على أي مضلّعات جديدة يتم إنشاؤها باستخدام DrawingManager. يتم تجاهل السمة paths، ويتم دائمًا ضبط السمة map لمضلّع جديد على خريطة DrawingManager.
polylineOptions اختياري	النوع: PolylineOptions optional الخيارات التي سيتم تطبيقها على أي خطوط متعدّدة جديدة يتم إنشاؤها باستخدام DrawingManager. يتم تجاهل السمة path، ويتم دائمًا ضبط السمة map لشكل متعدّد الخطوط جديد على خريطة DrawingManager.
rectangleOptions اختياري	النوع: RectangleOptions optional الخيارات التي سيتم تطبيقها على أي مستطيلات جديدة يتم إنشاؤها باستخدام DrawingManager. يتم تجاهل السمة bounds، ويتم دائمًا ضبط السمة map لمستطيل جديد على خريطة DrawingManager.

DrawingControlOptions interface

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

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

الخصائص
drawingModes اختياري	النوع: Array<OverlayType> optional القيمة التلقائية: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON] أوضاع الرسم التي سيتم عرضها في عنصر التحكّم في الرسم، بالترتيب الذي سيتم عرضها به. يتوفّر رمز اليد (الذي يتوافق مع وضع الرسم null) دائمًا ولا يتم تحديده في هذه المصفوفة.
position اختياري	النوع: 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 ثوابت
مكتبة "drawing"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع OverlayTypeString.

const {OverlayType} = await google.maps.importLibrary("drawing");

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