فئة DrawingManager
google.maps.drawing.DrawingManager
الصف الدراسي
يسمح للمستخدمين برسم العلامات والمضلعات والخطوط المتعددة والمستطيلات والدوائر على الخريطة. يحدد وضع الرسم في DrawingManager
نوع التراكب الذي سينشئه المستخدم. لإضافة عنصر تحكم إلى الخريطة، مما يسمح للمستخدم بتبديل وضع الرسم.
يمتد هذا الصف
MVCObject
.
تحميل باستخدام معلمة عنوان URL &libraries=drawing
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {DrawingManager} = await google.map.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) الوسيطات:
يتم تنشيط هذا الحدث عند انتهاء المستخدم من رسم دائرة. |
markercomplete |
function(marker) الوسيطات:
يتم تنشيط هذا الحدث عند انتهاء المستخدم من رسم علامة. |
overlaycomplete |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عندما ينتهي المستخدم من رسم تراكب من أي نوع. |
polygoncomplete |
function(polygon) الوسيطات:
يتم تنشيط هذا الحدث عند انتهاء المستخدم من رسم مضلع. |
polylinecomplete |
function(polyline) الوسيطات:
يتم تشغيل هذا الحدث عندما ينتهي المستخدم من رسم خط متعدد. |
rectanglecomplete |
function(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 نوع التراكب المكتمل. |
ثابتات الطبقات
google.maps.drawing.OverlayType
ثوابت
أنواع التراكبات التي يمكن إنشاؤها بواسطة DrawingManager
. حدد هذه القيم بحسب القيمة أو باستخدام اسم الثوابت. على سبيل المثال، 'polygon'
أو google.maps.drawing.OverlayType.POLYGON
.
تحميل باستخدام معلمة عنوان URL &libraries=drawing
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {OverlayType} = await google.map.importLibrary("drawing")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الثوابت | |
---|---|
CIRCLE |
تحدِّد هذه السمة أن DrawingManager ينشئ دوائر، وأن التراكب المحدد في حدث overlaycomplete هو عبارة عن دائرة. |
MARKER |
تحدِّد هذه العلامة أن DrawingManager ينشئ علامات، وأن التراكب المحدد في حدث overlaycomplete هو محدّد موقع. |
POLYGON |
لتحديد أن DrawingManager ينشئ مضلعات، وأن التراكب المحدد في حدث overlaycomplete هو مضلع. |
POLYLINE |
تحدّد هذه السمة أن DrawingManager ينشئ خطوطًا متعددة الأضلاع، وأن التراكب المحدد في حدث overlaycomplete عبارة عن خطوط متعددة الأضلاع. |
RECTANGLE |
تحدِّد هذه السمة أن DrawingManager ينشئ مستطيلات، وأن التراكب الظاهر في حدث overlaycomplete هو مستطيل. |