Polygons

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

Polyline الفئة

google.maps.Polyline الصف الدراسي

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

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Polyline} = await google.map.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)
المعلّمات:
  • draggableboolean
قيمة الإرجاع: بدون
في حال الضبط على true، يمكن للمستخدم سحب هذا الشكل على الخريطة. تحدّد السمة geodesic وضع السحب.
setEditable
setEditable(editable)
المعلّمات:
  • editableboolean
قيمة الإرجاع: بدون
في حال الضبط على true، يمكن للمستخدم تعديل هذا الشكل من خلال سحب نقاط التحكم المعروضة في الرؤوس وعلى كل جزء.
setMap
setMap(map)
المعلّمات:
  • map: Map 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)
الوسيطات:
يتم تنشيط هذا الحدث عندما يتم تنشيط حدث تمرير الماوس في DOM على Polyline.
mousemove
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث تحريك الماوس في DOM على Polyline.
mouseout
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس خارج Polyline.
mouseover
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس فوق Polyline.
mouseup
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما يتم تنشيط حدث الماوس DOM على 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. سيؤدي إدخال خطوط الطول والعرض أو إزالتها في 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%") أو بالبكسل (مثل "50 بكسل").
repeat optional
النوع: string optional
تلقائي: 0
المسافة بين الرموز المتتالية على الخط. يمكن التعبير عن هذه المسافة كنسبة مئوية من طول السطر (على سبيل المثال، "50%") أو بالبكسل (مثل "50 بكسل"). لتعطيل تكرار الرمز، حدد "0".

فئة المضلع

google.maps.Polygon الصف الدراسي

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

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Polygon} = await google.map.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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)
المعلّمات:
  • draggable: boolean
قيمة الإرجاع: بدون
في حال الضبط على true، يمكن للمستخدم سحب هذا الشكل على الخريطة. تحدّد السمة geodesic وضع السحب.
setEditable
setEditable(editable)
المعلّمات:
  • editableboolean
قيمة الإرجاع: بدون
في حال الضبط على true، يمكن للمستخدم تعديل هذا الشكل من خلال سحب نقاط التحكم المعروضة في الرؤوس وعلى كل جزء.
setMap
setMap(map)
المعلّمات:
  • map: Map 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)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث تمرير الماوس في DOM على المضلّع.
mousemove
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث تحريك الماوس في DOM على المضلّع.
mouseout
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تحريك المضلع بالماوس.
mouseover
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس فوق المضلع.
mouseup
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث تمرير الماوس في DOM على المضلّع.
rightclick
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند النقر على المضلع بزر الماوس الأيمن.

PolygonOptions

واجهة google.maps.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. يتم إغلاق المسارات تلقائيًا؛ لا تكرر الرأس الأول للمسار كرأس آخر. يمكن تعريف المضلعات البسيطة باستخدام مصفوفة واحدة من LatLngs. قد تحدد المضلعات الأكثر تعقيدًا مصفوفة من المصفوفات. يتم تحويل أي مصفوفات بسيطة إلى 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 الصف الدراسي

تراكب مستطيل.

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Rectangle} = await google.map.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)
المعلّمات:
  • draggableboolean
قيمة الإرجاع: بدون
في حال الضبط على true، يمكن للمستخدم سحب هذا المستطيل فوق الخريطة.
setEditable
setEditable(editable)
المعلّمات:
  • editable: boolean
قيمة الإرجاع: بدون
في حال الضبط على true، يمكن للمستخدم تعديل هذا المستطيل من خلال سحب نقاط التحكم المعروضة في الزوايا وعلى كل حافة.
setMap
setMap(map)
المعلّمات:
  • mapMap 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 على المستطيل.
dblclick
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث dblclick في DOM على المستطيل.
drag
function(event)
الوسيطات:
يتم تنشيط هذا الحدث بشكل متكرر أثناء سحب المستخدم للمستطيل.
dragend
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب المستطيل.
dragstart
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عندما يبدأ المستخدم في سحب المستطيل.
mousedown
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث تمرير الماوس في DOM على المستطيل.
mousemove
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث DOM.
mouseout
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس خارج المستطيل.
mouseover
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس فوق المستطيل.
mouseup
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث تمرير الماوس في DOM على المستطيل.
rightclick
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند النقر بزر الماوس الأيمن على المستطيل.

RectangleOptions واجهة

واجهة google.maps.RectangleOptions

كائن مستطيل الخيارات يستخدم لتحديد الخصائص التي يمكن تعيينها على مستطيل.

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 بالمقارنة مع الأشكال المضلعة الأخرى.

circle class

google.maps.Circle الصف الدراسي

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

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Circle} = await google.map.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

Circle
Circle([circleOrCircleOptions])
المعلّمات:
أنشئ دائرة باستخدام CircleOptions التي تم تمريرها، والتي تحدد المركز والنطاق والنمط.
getBounds
getBounds()
المعلّمات: بدون
قيمة الإرجاع: LatLngBounds|null
للحصول على LatLngBounds من هذه الدائرة.
getCenter
getCenter()
المعلّمات: بدون
قيمة الإرجاع: LatLng
لعرض مركز هذه الدائرة.
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)
المعلّمات:
  • mapMap 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)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث تمرير الماوس في DOM على الدائرة.
mousemove
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تنشيط حدث تحريك الماوس في DOM على الدائرة.
mouseout
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس خارج الدائرة.
mouseover
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند تمرير الماوس فوقها.
mouseup
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما يتم تنشيط حدث الماوس DOM على الدائرة.
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 ثوابت

المواضع المحتملة للشطب على المضلع.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {StrokePosition} = await google.map.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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