Polygons

فئة Polyline

class google.maps.Polyline extends MVCObject
library "maps"

الشكل المتعدّد الخطوط هو تراكب خطي لأجزاء خطوط متصلة على الخريطة.

const {Polyline} = await google.maps.importLibrary("maps");
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

كائن PolylineOptions يُستخدَم لتحديد السمات التي يمكن ضبطها على خطوط متعدّدة.

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

واجهة IconSequence

واجهة google.maps.IconSequence

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

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

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

فئة Polygon

class google.maps.Polygon extends MVCObject
library "maps"

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

const {Polygon} = await google.maps.importLibrary("maps");
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)
المَعلمات:
القيمة المعروضة: لا شيء
لضبط المسار الأول لمزيد من التفاصيل، يُرجى الاطّلاع على PolygonOptions.
setPaths
setPaths(paths)
القيمة المعروضة: لا شيء
يضبط المسار لهذا المضلّع.
setVisible
setVisible(visible)
المَعلمات:
  • visible: boolean
القيمة المعروضة: لا شيء
يتم إخفاء هذا المضلّع في حال ضبطه على false.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
click
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث ناتج عن النقر على DOM في المضلّع.
contextmenu
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على المضلّع.
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)
الوسيطات:
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على المضلّع.

واجهة PolygonOptions

واجهة google.maps.PolygonOptions

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

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

واجهة PolyMouseEvent

interface google.maps.PolyMouseEvent extends MapMouseEvent

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

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

فئة Rectangle

class google.maps.Rectangle extends MVCObject
library "maps"

تراكب مستطيل

const {Rectangle} = await google.maps.importLibrary("maps");
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)
المَعلمات:
  • draggable: boolean
القيمة المعروضة: لا شيء
في حال ضبطها على true، يمكن للمستخدم سحب هذا المستطيل فوق الخريطة.
setEditable
setEditable(editable)
المَعلمات:
  • editable: boolean
القيمة المعروضة: لا شيء
في حال ضبط السياسة على true، يمكن للمستخدم تعديل هذا المستطيل عن طريق سحب نقاط التحكّم التي تظهر في الزوايا وعلى كل حافة.
setMap
setMap(map)
المَعلمات:
  • map: Map optional
القيمة المعروضة: لا شيء
لعرض المستطيل على الخريطة المحدّدة إذا تم ضبط الخريطة على null، ستتم إزالة المستطيل.
setOptions
setOptions(options)
المَعلمات:
القيمة المعروضة: لا شيء
setVisible
setVisible(visible)
المَعلمات:
  • visible: boolean
القيمة المعروضة: لا شيء
يتم إخفاء هذا المستطيل في حال ضبط القيمة على false.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
bounds_changed
function()
الوسيطات: لا تتوفّر أي وسيطات
يتم تنشيط هذا الحدث عند تغيير حدود المستطيل.
click
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث ناتج عن النقر على DOM على المستطيل.
contextmenu
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على المستطيل.
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)
الوسيطات:
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على المستطيل.

RectangleOptions interface

واجهة google.maps.RectangleOptions

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

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

صفّ Circle

class google.maps.Circle extends MVCObject
library "maps"

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

const {Circle} = await google.maps.importLibrary("maps");
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)
المَعلمات:
  • draggable: boolean
القيمة المعروضة: لا شيء
في حال ضبطها على true، يمكن للمستخدم سحب هذه الدائرة فوق الخريطة.
setEditable
setEditable(editable)
المَعلمات:
  • editable: boolean
القيمة المعروضة: لا شيء
إذا تم ضبطها على true، يمكن للمستخدم تعديل هذه الدائرة عن طريق سحب نقاط التحكّم التي تظهر في وسط الدائرة وحول محيطها.
setMap
setMap(map)
المَعلمات:
  • map: Map optional
القيمة المعروضة: لا شيء
لعرض الدائرة على الخريطة المحدّدة إذا تم ضبط الخريطة على null، ستتم إزالة الدائرة.
setOptions
setOptions(options)
المَعلمات:
القيمة المعروضة: لا شيء
setRadius
setRadius(radius)
المَعلمات:
  • radius: number
القيمة المعروضة: لا شيء
لضبط نصف قطر هذه الدائرة (بالأمتار)
setVisible
setVisible(visible)
المَعلمات:
  • visible: boolean
القيمة المعروضة: لا شيء
يتم إخفاء هذه الدائرة في حال ضبطها على 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)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث mousemove في نموذج العناصر في المستند (DOM) على الدائرة.
mouseout
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تحريك مؤشر الماوس خارج الدائرة.
mouseover
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تمرير مؤشر الماوس فوق الدائرة.
mouseup
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث mouseup في نموذج العناصر في المستند (DOM) على الدائرة.
radius_changed
function()
الوسيطات: لا تتوفّر أي وسيطات
يتم تنشيط هذا الحدث عند تغيير نصف قطر الدائرة.
rightclick
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على الدائرة.

CircleOptions interface

interface google.maps.CircleOptions
extended by CircleLiteral

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

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

ثوابت StrokePosition

ثوابت google.maps.StrokePosition
مكتبة "maps"

المواضع المحتملة للحدود على مضلّع

const {StrokePosition} = await google.maps.importLibrary("maps");
CENTER يتم توسيط الخط على مسار المضلّع، بحيث يكون نصف الخط داخل المضلّع ونصفه الآخر خارجه.
INSIDE يقع الخط داخل المضلّع.
OUTSIDE يقع الحد الخارجي خارج المضلّع.