Polygons

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

google.maps.Polyline صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Polyline} = await google.maps.importLibrary("maps").
اطّلِع على المكتبات في Maps JavaScript API.
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)
المَعلمات: 
  • draggable:  boolean
القيمة المعروضة:  لا شيء
إذا تم ضبطها على true، يمكن للمستخدم سحب هذا الشكل فوق الخريطة. تحدّد السمة geodesic وضع السحب.
setEditable
setEditable(editable)
المَعلمات: 
  • editable:  boolean
القيمة المعروضة:  لا شيء
إذا تم ضبطها على true، يمكن للمستخدم تعديل هذا الشكل عن طريق سحب نقاط التحكّم المعروضة عند الرؤوس وعلى كل جزء.
setMap
setMap(map)
المَعلمات: 
  • map:  Map optional
القيمة المعروضة:  لا شيء
تعرض هذه الدالة الشكل على الخريطة المحدّدة. إذا تم ضبط الخريطة على null، ستتم إزالة الشكل.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setPath
setPath(path)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة المسار. لمزيد من التفاصيل، يمكنك الاطّلاع على PolylineOptions.
setVisible
setVisible(visible)
المَعلمات: 
  • visible:  boolean
القيمة المعروضة:  لا شيء
يتم إخفاء هذا المضلّع إذا تم ضبطه على false.
موروثة: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقر في نموذج المستند (DOM) على الخط المتعدد الأضلاع.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على Poyline.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في نموذج المستند (DOM) على الخط المتعدد الأضلاع.
drag
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث بشكل متكرّر أثناء سحب المستخدم للخط المتعدد الأضلاع.
dragend
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخط المتعدد الأضلاع.
dragstart
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخط المتعدد الأضلاع.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mousedown في نموذج المستند (DOM) على الخط المتعدد الأضلاع.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mousemove الخاص بنموذج المستند (DOM) على الخط المتعدد.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند خروج مؤشر الماوس من خط متعدد الأضلاع.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تمرير مؤشر الماوس فوق خط متعدد الأضلاع.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث mouseup في نموذج المستند (DOM) على الخط المتعدد.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على الخط المتعدد الأضلاع.

واجهة PolylineOptions

google.maps.PolylineOptions interface

عنصر 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. سيؤدي إدراج أو إزالة LatLngs في 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 interface

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

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

فئة المضلّع

google.maps.Polygon صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Polygon} = await google.maps.importLibrary("maps").
اطّلِع على المكتبات في Maps JavaScript API.
Polygon
Polygon([opts])
المَعلمات: 
أنشئ مضلّعًا باستخدام PolygonOptions الذي تم تمريره، والذي يحدّد مسار المضلّع ونمط الخطوط لحواف المضلّع ونمط التعبئة للمناطق الداخلية للمضلّع. يمكن أن يحتوي المضلّع على مسار واحد أو أكثر، ويتكوّن كل مسار من مصفوفة من LatLng. يمكنك تمرير إما مجموعة من LatLngs أو MVCArray من LatLngs عند إنشاء هذه المسارات. يتم تحويل المصفوفات إلى MVCArrays داخل المضلّع عند إنشاء مثيل.
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)
المَعلمات: 
  • draggable:  boolean
القيمة المعروضة:  لا شيء
إذا تم ضبطها على true، يمكن للمستخدم سحب هذا الشكل فوق الخريطة. تحدّد السمة geodesic وضع السحب.
setEditable
setEditable(editable)
المَعلمات: 
  • editable:  boolean
القيمة المعروضة:  لا شيء
إذا تم ضبطها على true، يمكن للمستخدم تعديل هذا الشكل عن طريق سحب نقاط التحكّم المعروضة عند الرؤوس وعلى كل جزء.
setMap
setMap(map)
المَعلمات: 
  • map:  Map optional
القيمة المعروضة:  لا شيء
تعرض هذه الدالة الشكل على الخريطة المحدّدة. إذا تم ضبط الخريطة على null، ستتم إزالة الشكل.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setPath
setPath(path)
المَعلمات: