Polygons

فئة الخطوط المتعددة

google.maps.Polyline class

الخطوط المتعددة هي عنصر متراكب خطي لمقاطع الخطوط المتصلة على الخريطة.

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Polyline} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Polyline
Polyline([opts])
المَعلمات: 
أنشئ خطًا متعدّد الأجزاء باستخدام العنصر PolylineOptions الذي تم تمريره، والذي يحدّد مسار الخط المتعدّد الأجزاء ونمط السكتة المراد استخدامه عند رسمه. يمكنك تمرير صفيف من LatLng أو MVCArray من LatLng عند إنشاء خط متعدّد الأضلاع، على الرغم من أنّه يتم تحويل الصفائف البسيطة إلى MVCArray ضمن الخط المتعدّد الأضلاع عند إنشاء مثيل له.
getDraggable
getDraggable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم سحب هذا الشكل.
getEditable
getEditable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم تعديل هذا الشكل.
getMap
getMap()
المَعلمات:  بدون
القيمة المعروضة:  Map|null
تعرِض هذه السمة الخريطة التي تم إرفاق هذا الشكل بها.
getPath
getPath()
المَعلمات:  بدون
القيمة المعروضة:  MVCArray<LatLng>
يسترجع المسار.
getVisible
getVisible()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان هذا المضلع مرئيًا على الخريطة.
setDraggable
setDraggable(draggable)
المَعلمات: 
  • draggableboolean
القيمة المعروضة:  لا شيء
في حال ضبطه على true، يمكن للمستخدم سحب هذا الشكل فوق الخريطة. تحدّد السمة geodesic وضع السحب.
setEditable
setEditable(editable)
المَعلمات: 
  • editableboolean
القيمة المعروضة:  لا شيء
في حال ضبطها على true، يمكن للمستخدم تعديل هذا الشكل عن طريق سحب نقاط التحكّم المعروضة في الرؤوس وعلى كل جزء.
setMap
setMap(map)
المَعلمات: 
  • mapMap optional
القيمة المعروضة:  لا شيء
لعرض هذا الشكل على الخريطة المحدّدة إذا تم ضبط الخريطة على null، ستتم إزالة الشكل.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setPath
setPath(path)
المَعلمات: 
القيمة المعروضة:  لا شيء
لضبط المسار يُرجى الاطّلاع على PolylineOptions لمزيد من التفاصيل.
setVisible
setVisible(visible)
المَعلمات: 
  • visibleboolean
القيمة المعروضة:  لا شيء
يؤدي ذلك إلى إخفاء هذا المضلع في حال ضبطه على false.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقر على DOM في Polyline.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث قائمة السياق في DOM على Poyline.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في DOM على Polyline.
drag
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث بشكل متكرّر بينما يسحب المستخدم الخطّ المتعدّد.
dragend
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخط المتعدّد.
dragstart
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يبدأ المستخدم سحب الخط المتعدّد.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mousedown في DOM على Polyline.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mousemove على Polyline.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند خروج مؤشر الماوس من شكل "الخط المتعدّد".
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تمرير مؤشر الماوس فوق شكل "الخط المتعدّد".
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mouseup على Polyline.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على شكل الخط المتعدّد.

واجهة PolylineOptions

google.maps.PolylineOptions واجهة

عنصر PolylineOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Polyline

clickable optional
النوع:  boolean optional
القيمة التلقائية: true
يشير إلى ما إذا كان هذا Polyline يعالج أحداث الماوس.
draggable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطه على true، يمكن للمستخدم سحب هذا الشكل فوق الخريطة. تحدّد السمة geodesic وضع السحب.
editable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطها على true، يمكن للمستخدم تعديل هذا الشكل عن طريق سحب نقاط التحكّم المعروضة في الرؤوس وعلى كل جزء.
geodesic optional
النوع:  boolean optional
القيمة التلقائية: false
عندما يكون true، يتم تفسير حواف المضلّع على أنّها جيوديسية وستتّبع انحناء الأرض. عندما يكون false، يتم عرض حواف المضلع كخطوط مستقيمة في مساحة الشاشة. يُرجى العِلم أنّ شكل المضلع الجيوديزيقي قد يبدو أنّه يتغيّر عند سحبه، لأنّه يتم الحفاظ على الأبعاد بالنسبة إلى سطح الأرض.
icons optional
النوع:  Array<IconSequence> optional
الرموز التي سيتم عرضها على طول الخط المتعدّد
map optional
النوع:  Map optional
الخريطة التي سيتم عرض "الخط المتعدّد" عليها.
path optional
النوع:  MVCArray<LatLng>|Array<LatLng|LatLngLiteral> optional
التسلسل المُرتَّب للإحداثيات للخط المتعدّد يمكن تحديد هذا المسار باستخدام صفيف بسيط من LatLng أو MVCArray من LatLng. يُرجى العلم أنّه في حال تم تمرير صفيف بسيط، سيتم تحويله إلى MVCArray. سيؤدي إدراج نقاط LatLng أو إزالتها في MVCArray إلى تعديل الخط المتعدد تلقائيًا على الخريطة.
strokeColor optional
النوع:  string optional
لون الخط تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
strokeOpacity optional
النوع:  number optional
يجب أن تتراوح قيمة شفافية المخطط بين 0.0 و1.0.
strokeWeight optional
النوع:  number optional
عرض الخط بالبكسل
visible optional
النوع:  boolean optional
القيمة التلقائية: true
ما إذا كان هذا الخط المتعدّد الأضلاع مرئيًا على الخريطة
zIndex optional
النوع:  number optional
مقياس zIndex مقارنةً بالأشكال الأخرى.

واجهة IconSequence

google.maps.IconSequence واجهة

تصف هذه السمة كيفية عرض الرموز على سطر.

إذا كان الخط المتعدّد هو خط جغرافي، يتم احتساب المسافات المحدّدة لكل من الفاصل والتكرار بالمتر تلقائيًا. سيؤدي ضبط أيّ من "الموضع النسبي" أو "تكرار" على قيمة بكسل إلى احتساب المسافات بالبكسل على الشاشة.

fixedRotation optional
النوع:  boolean optional
القيمة التلقائية: false
إذا كان true، يكون لكل رمز في التسلسل الدوران الثابت نفسه بغض النظر عن زاوية الحافة التي يقع عليها. إذا كان false، يتم تدوير كل رمز في التسلسل لمحاذاة حوافه.
icon optional
النوع:  Symbol optional
الرمز الذي سيتم عرضه على الخط
offset optional
النوع:  string optional
القيمة التلقائية: '100%'
المسافة من بداية السطر التي سيتم عرض الرمز عليها يمكن التعبير عن هذه المسافة كنسبة مئوية من طول الخط (مثلاً "‎50%") أو بوحدات البكسل (مثلاً "‎50px").
repeat optional
النوع:  string optional
القيمة التلقائية: 0
المسافة بين الرموز المتتالية على الخط ويمكن التعبير عن هذه المسافة كنسبة مئوية من طول الخط (مثلاً "‎50%") أو بوحدات البكسل (مثلاً "‎50px"). لإيقاف تكرار الرمز، حدِّد "0".

فئة المضلّع

google.maps.Polygon class

يحدِّد المضلّع (مثل الخطّ المتعدّد) سلسلة من الإحداثيات المتّصلة في تسلسل منتظم. بالإضافة إلى ذلك، تشكل المضلّعات حلقة مغلقة وتحدّد منطقة مليئة. اطّلِع على العيّنات في دليل المطوّر، بدءًا من الأشكال المضلّعة البسيطة والأشكال المضلّعة التي تحتوي على ثقب وغير ذلك. تجدر الإشارة إلى أنّه يمكنك أيضًا استخدام طبقة البيانات لإنشاء مضلّع. توفّر طبقة "البيانات" طريقة أبسط لإنشاء الفتحات لأنّها تتعامل مع ترتيب المسارات الداخلية والخارجية نيابةً عنك.

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Polygon} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Polygon
Polygon([opts])
المَعلمات: 
أنشئ مضلّعًا باستخدام PolygonOptions التي تم تمريرها، والتي تحدّد مسار المضلّع ونمط السكتة لحوافه ونمط الملء للمناطق الداخلية للمضلّع. قد يحتوي المضلع على مسار واحد أو أكثر، حيث يتألف كل مسار من صفيف من LatLng. يمكنك تمرير صفيف من خطوط الطول والعرض أو MVCArray من LatLng عند إنشاء هذه المسارات. يتم تحويل الصفائف إلى MVCArray ضمن المضلع عند إنشاء العنصر.
getDraggable
getDraggable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم سحب هذا الشكل.
getEditable
getEditable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم تعديل هذا الشكل.
getMap
getMap()
المَعلمات:  بدون
القيمة المعروضة:  Map|null
تعرِض هذه السمة الخريطة التي تم إرفاق هذا الشكل بها.
getPath
getPath()
المَعلمات:  بدون
القيمة المعروضة:  MVCArray<LatLng>
يسترجع المسار الأول.
getPaths
getPaths()
المَعلمات:  بدون
القيمة المعروضة:  MVCArray<MVCArray<LatLng>>
يسترجع المسارات لهذا المضلّع.
getVisible
getVisible()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان هذا المضلع مرئيًا على الخريطة.
setDraggable
setDraggable(draggable)
المَعلمات: 
  • draggableboolean
القيمة المعروضة:  لا شيء
في حال ضبطه على true، يمكن للمستخدم سحب هذا الشكل فوق الخريطة. تحدّد السمة geodesic وضع السحب.
setEditable
setEditable(editable)
المَعلمات: 
  • editableboolean
القيمة المعروضة:  لا شيء
في حال ضبطها على true، يمكن للمستخدم تعديل هذا الشكل عن طريق سحب نقاط التحكّم المعروضة في الرؤوس وعلى كل جزء.
setMap
setMap(map)
المَعلمات: 
  • mapMap optional
القيمة المعروضة:  لا شيء
لعرض هذا الشكل على الخريطة المحدّدة إذا تم ضبط الخريطة على null، ستتم إزالة الشكل.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setPath
setPath(path)
المَعلمات: 
القيمة المعروضة:  لا شيء
تُستخدَم لضبط المسار الأول. يُرجى الاطّلاع على PolygonOptions لمزيد من التفاصيل.
setPaths
setPaths(paths)
القيمة المعروضة:  لا شيء
لضبط مسار هذا المضلّع.
setVisible
setVisible(visible)
المَعلمات: 
  • visibleboolean
القيمة المعروضة:  لا شيء
يؤدي ذلك إلى إخفاء هذا المضلع في حال ضبطه على false.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقر على DOM في المضلع.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث قائمة السياق DOM في المضلع.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في DOM على المضلع.
drag
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث بشكل متكرّر بينما يسحب المستخدم المضلع.
dragend
function(event)
الوسيطات: 
يتمّ تشغيل هذا الحدث عندما يتوقّف المستخدِم عن سحب المضلّع.
dragstart
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يبدأ المستخدم سحب المضلع.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mousedown في DOM على المضلع.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mousemove على المضلع.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند خروج مؤشر الماوس من المضلع.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تمرير مؤشر الماوس فوق المضلّع.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mouseup على المضلع.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على المضلع.

واجهة PolygonOptions

google.maps.PolygonOptions واجهة

عنصر PolygonOptions المستخدَم لتحديد السمات التي يمكن ضبطها على مضلّع

clickable optional
النوع:  boolean optional
القيمة التلقائية: true
يشير إلى ما إذا كان هذا Polygon يعالج أحداث الماوس.
draggable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطه على true، يمكن للمستخدم سحب هذا الشكل فوق الخريطة. تحدّد السمة geodesic وضع السحب.
editable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطها على true، يمكن للمستخدم تعديل هذا الشكل عن طريق سحب نقاط التحكّم المعروضة في الرؤوس وعلى كل جزء.
fillColor optional
النوع:  string optional
لون التعبئة تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
fillOpacity optional
النوع:  number optional
تعتيم التعبئة بين 0.0 و1.0
geodesic optional
النوع:  boolean optional
القيمة التلقائية: false
عندما يكون true، يتم تفسير حواف المضلّع على أنّها جيوديسية وستتّبع انحناء الأرض. عندما يكون false، يتم عرض حواف المضلع كخطوط مستقيمة في مساحة الشاشة. يُرجى العِلم أنّ شكل المضلع الجيوديزيقي قد يبدو أنّه يتغيّر عند سحبه، لأنّه يتم الحفاظ على الأبعاد بالنسبة إلى سطح الأرض.
map optional
النوع:  Map optional
الخريطة التي سيتم عرض المضلّع عليها
paths optional
التسلسل المُرتَّب للتنسيقات الجغرافية التي تحدِّد حلقة مغلقة على عكس الخطوط المتعددة، قد يتألّف المضلّع من مسار واحد أو أكثر. ونتيجةً لذلك، قد يحدِّد سمة المسارات مصفوفة واحدة أو أكثر من إحداثيات LatLng. يتم إغلاق المسارات تلقائيًا، لذا لا تكرِّر النقطة الأولى من المسار كنقطة أخيرة. يمكن تعريف المضلّعات البسيطة باستخدام مصفوفة واحدة من LatLng. قد تحدِّد المضلّعات الأكثر تعقيدًا صفيفًا من الصفائف. يتم تحويل أي صفائف بسيطة إلى MVCArray. سيؤدي إدراج LatLng أو إزالتها من MVCArray إلى تعديل المضلع تلقائيًا على الخريطة.
strokeColor optional
النوع:  string optional
لون الخط تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
strokeOpacity optional
النوع:  number optional
يجب أن تتراوح قيمة التعتيم للخط بين 0.0 و1.0.
strokePosition optional
النوع:  StrokePosition optional
القيمة التلقائية: StrokePosition.CENTER
موضع الخطوط
strokeWeight optional
النوع:  number optional
عرض الخط بالبكسل
visible optional
النوع:  boolean optional
القيمة التلقائية: true
ما إذا كان هذا المضلّع مرئيًا على الخريطة
zIndex optional
النوع:  number optional
مقياس zIndex مقارنةً بالأشكال الأخرى.

واجهة PolyMouseEvent

google.maps.PolyMouseEvent واجهة

يتمّ عرض هذا العنصر من أحداث الماوس على الخطوط المتعددة والأشكال المتعددة.

تمتد هذه الواجهة MapMouseEvent.

edge optional
النوع:  number optional
فهرس الحافة ضمن المسار أسفل المؤشر عند وقوع الحدث، إذا وقع الحدث في منتصف نقطة على مضلع قابل للتعديل
path optional
النوع:  number optional
فهرس المسار أسفل المؤشر عند وقوع الحدث، إذا وقع الحدث على رأس وكان المضلع قابلاً للتعديل بخلاف ذلك، undefined.
vertex optional
النوع:  number optional
فهرس رأس القطعة أسفل المؤشر عند وقوع الحدث، إذا وقع الحدث على رأس قطعة وكان الخط المتعدّد أو المضلع قابلاً للتعديل إذا لم يحدث الحدث على رأس، تكون القيمة undefined.
مكتسَبة: domEvent، latLng
مكتسَبة: stop

فئة مستطيل

google.maps.Rectangle class

تراكب مستطيل

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Rectangle} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Rectangle
Rectangle([opts])
المَعلمات: 
أنشئ مستطيلاً باستخدام RectangleOptions الذي تم تمريره، والذي يحدّد الحدود والأسلوب.
getBounds
getBounds()
المَعلمات:  بدون
القيمة المعروضة:  LatLngBounds|null
لعرض حدود هذا المستطيل.
getDraggable
getDraggable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم سحب هذا المستطيل.
getEditable
getEditable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم تعديل هذا المستطيل.
getMap
getMap()
المَعلمات:  بدون
القيمة المعروضة:  Map|null
تعرِض الخريطة التي يتم عرض هذا المستطيل عليها.
getVisible
getVisible()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان هذا المستطيل مرئيًا على الخريطة.
setBounds
setBounds(bounds)
المَعلمات: 
القيمة المعروضة:  لا شيء
لضبط حدود هذا المستطيل
setDraggable
setDraggable(draggable)
المَعلمات: 
  • draggableboolean
القيمة المعروضة:  لا شيء
في حال ضبطه على true، يمكن للمستخدم سحب هذا المستطيل فوق الخريطة.
setEditable
setEditable(editable)
المَعلمات: 
  • editableboolean
القيمة المعروضة:  لا شيء
في حال ضبطها على true، يمكن للمستخدم تعديل هذا المستطيل عن طريق سحب نقاط التحكّم المعروضة في الزوايا وعلى كل جانب.
setMap
setMap(map)
المَعلمات: 
  • mapMap optional
القيمة المعروضة:  لا شيء
لعرض المستطيل على الخريطة المحدّدة إذا تم ضبط الخريطة على null، ستتم إزالة المستطيل.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setVisible
setVisible(visible)
المَعلمات: 
  • visibleboolean
القيمة المعروضة:  لا شيء
يؤدي ضبط هذا الخيار على false إلى إخفاء هذا المستطيل.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
bounds_changed
function()
الوسيطات:  بدون
يتم تشغيل هذا الحدث عند تغيير حدود المستطيل.
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقر على DOM في المستطيل.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث قائمة السياق DOM في المستطيل.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM dblclick على المستطيل.
drag
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث بشكل متكرّر بينما يسحب المستخدم المستطيل.
dragend
function(event)
الوسيطات: 
يتمّ تشغيل هذا الحدث عندما يتوقّف المستخدِم عن سحب المستطيل.
dragstart
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يبدأ المستخدم سحب المستطيل.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mousedown في DOM على المستطيل.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mousemove على المستطيل.
mouseout
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عند خروج مؤشر الماوس من المستطيل.
mouseover
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عند تمرير مؤشر الماوس فوق المستطيل.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mouseup على المستطيل.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على المستطيل.

واجهة RectangleOptions

google.maps.RectangleOptions واجهة

عنصر RectangleOptions المستخدَم لتحديد السمات التي يمكن ضبطها في عنصر Rectangle

bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
الحدود
clickable optional
النوع:  boolean optional
القيمة التلقائية: true
يشير إلى ما إذا كان هذا Rectangle يعالج أحداث الماوس.
draggable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطه على true، يمكن للمستخدم سحب هذا المستطيل فوق الخريطة.
editable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطها على true، يمكن للمستخدم تعديل هذا المستطيل عن طريق سحب نقاط التحكّم المعروضة في الزوايا وعلى كل جانب.
fillColor optional
النوع:  string optional
لون التعبئة تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
fillOpacity optional
النوع:  number optional
تعتيم التعبئة بين 0.0 و1.0
map optional
النوع:  Map optional
الخريطة التي سيتم عرض المستطيل عليها
strokeColor optional
النوع:  string optional
لون الخط تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
strokeOpacity optional
النوع:  number optional
يجب أن تتراوح قيمة التعتيم للخط بين 0.0 و1.0.
strokePosition optional
النوع:  StrokePosition optional
القيمة التلقائية: StrokePosition.CENTER
موضع الخطوط
strokeWeight optional
النوع:  number optional
عرض الخط بالبكسل
visible optional
النوع:  boolean optional
القيمة التلقائية: true
ما إذا كان هذا المستطيل مرئيًا على الخريطة
zIndex optional
النوع:  number optional
مقياس zIndex مقارنةً بالأشكال الأخرى.

صف الدائرة

google.maps.Circle class

دائرة على سطح الأرض، تُعرف أيضًا باسم "غطاء كروي".

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Circle} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Circle
Circle([circleOrCircleOptions])
المَعلمات: 
أنشئ دائرة باستخدام CircleOptions التي تم تمريرها، والتي تحدّد المركز والقطر والأسلوب.
getBounds
getBounds()
المَعلمات:  بدون
القيمة المعروضة:  LatLngBounds|null
تحصل على LatLngBounds لهذه الدائرة.
getCenter
getCenter()
المَعلمات:  بدون
القيمة المعروضة:  LatLng|null
لعرض مركز هذه الدائرة.
getDraggable
getDraggable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم سحب هذه الدائرة.
getEditable
getEditable()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كان بإمكان المستخدم تعديل هذه الدائرة.
getMap
getMap()
المَعلمات:  بدون
القيمة المعروضة:  Map|null
تعرِض الخريطة التي يتم عرض هذه الدائرة عليها.
getRadius
getRadius()
المَعلمات:  بدون
القيمة المعروضة:  number
لعرض نصف قطر هذه الدائرة (بالأمتار).
getVisible
getVisible()
المَعلمات:  بدون
القيمة المعروضة:  boolean
تعرِض ما إذا كانت هذه الدائرة ظاهرة على الخريطة.
setCenter
setCenter(center)
المَعلمات: 
القيمة المعروضة:  لا شيء
لضبط مركز هذه الدائرة.
setDraggable
setDraggable(draggable)
المَعلمات: 
  • draggableboolean
القيمة المعروضة:  لا شيء
في حال ضبط القيمة على true، يمكن للمستخدم سحب هذه الدائرة فوق الخريطة.
setEditable
setEditable(editable)
المَعلمات: 
  • editableboolean
القيمة المعروضة:  لا شيء
في حال ضبطها على true، يمكن للمستخدم تعديل هذه الدائرة من خلال سحب نقاط التحكّم المعروضة في المركز وحول محيط الدائرة.
setMap
setMap(map)
المَعلمات: 
  • mapMap optional
القيمة المعروضة:  لا شيء
لعرض الدائرة على الخريطة المحدّدة. إذا تم ضبط الخريطة على null، ستتم إزالة الدائرة.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setRadius
setRadius(radius)
المَعلمات: 
  • radiusnumber
القيمة المعروضة:  لا شيء
لضبط نصف قطر هذه الدائرة (بالمتر).
setVisible
setVisible(visible)
المَعلمات: 
  • visibleboolean
القيمة المعروضة:  لا شيء
يؤدي هذا الإعداد إلى إخفاء هذه الدائرة إذا تم ضبطه على false.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
center_changed
function()
الوسيطات:  بدون
يتم تنشيط هذا الحدث عند تغيير مركز الدائرة.
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقر على DOM في الدائرة.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في DOM على الدائرة.
drag
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث بشكل متكرّر بينما يسحب المستخدم الدائرة.
dragend
function(event)
الوسيطات: 
يتمّ تشغيل هذا الحدث عندما يتوقف المستخدِم عن سحب الدائرة.
dragstart
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يبدأ المستخدم سحب الدائرة.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mousedown في DOM على الدائرة.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mousemove على الدائرة.
mouseout
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عند خروج مؤشر الماوس من الدائرة.
mouseover
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عند تمرير مؤشر الماوس فوق الدائرة.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM mouseup على الدائرة.
radius_changed
function()
الوسيطات:  بدون
يتم تشغيل هذا الحدث عند تغيير نصف قطر الدائرة.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على الدائرة.

واجهة CircleOptions

google.maps.CircleOptions واجهة

عنصر CircleOptions المستخدَم لتحديد السمات التي يمكن ضبطها على "دائرة"

center optional
النوع:  LatLng|LatLngLiteral optional
مركز الدائرة
clickable optional
النوع:  boolean optional
القيمة التلقائية: true
يشير إلى ما إذا كان هذا Circle يعالج أحداث الماوس.
draggable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبط القيمة على true، يمكن للمستخدم سحب هذه الدائرة فوق الخريطة.
editable optional
النوع:  boolean optional
القيمة التلقائية: false
في حال ضبطها على true، يمكن للمستخدم تعديل هذه الدائرة من خلال سحب نقاط التحكّم المعروضة في المركز وحول محيط الدائرة.
fillColor optional
النوع:  string optional
لون التعبئة تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
fillOpacity optional
النوع:  number optional
تعتيم التعبئة بين 0.0 و1.0
map optional
النوع:  Map optional
الخريطة التي سيتم عرض الدائرة عليها
radius optional
النوع:  number optional
نصف القطر بالمتر على سطح الأرض
strokeColor optional
النوع:  string optional
لون الخط تتوفّر جميع ألوان CSS3 باستثناء الألوان المُسمّاة الموسّعة.
strokeOpacity optional
النوع:  number optional
يجب أن تتراوح قيمة شفافية المخطط بين 0.0 و1.0.
strokePosition optional
النوع:  StrokePosition optional
القيمة التلقائية: StrokePosition.CENTER
موضع الخطوط
strokeWeight optional
النوع:  number optional
عرض الخط بالبكسل
visible optional
النوع:  boolean optional
القيمة التلقائية: true
ما إذا كانت هذه الدائرة مرئية على الخريطة
zIndex optional
النوع:  number optional
مقياس zIndex مقارنةً بالأشكال الأخرى.

StrokePosition الثوابت

google.maps.StrokePosition الثوابت

مواضع الخطوط المحتملة على مضلّع

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StrokePosition} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

CENTER يتم وضع الخطوط على مسار المضلّع، مع وضع نصفها داخل المضلّع ونصفها خارجه.
INSIDE يقع الخط داخل المضلّع.
OUTSIDE يقع الخط خارج المضلّع.