Polygons

صف خطوط متعددة

صف واحد (google.maps.Polyline)

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

تمتد هذه الفئة إلى MVCObject.

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

Polyline
Polyline([opts])
المَعلمات: 
يمكنك إنشاء خطوط متعدّدة باستخدام دالة PolylineOptions التي تم تمريرها، والتي تحدّد كلاً من مسار الخطوط المتعددة ونمط الحد الخارجي المطلوب استخدامهما عند رسم الخط المتعدد. يمكنك تمرير مصفوفة من LatLng أو MVCArray للمصفوفة LatLng عند إنشاء خط متعدد، على الرغم من تحويل الصفائف البسيطة إلى MVCArrays داخل الخطوط المتعددة عند إنشاء مثيل.
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) على الخط المتعدد.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث "قائمة المحتوى المستند إلى نموذج العناصر" (DOM) على Poyline.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في نموذج العناصر في المستند (DOM) على الخط المتعدد.
drag
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث بشكلٍ متكرر أثناء سحب المستخدم للخطوط المتعددة.
dragend
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخطوط المتعددة.
dragstart
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخطوط المتعددة.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث الماوس DOM على الخط المتعدد.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدثMousemove في النموذج المتعدد.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث باستخدام ماوس Polyline.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تمرير الماوس على Polyline.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث تمرير الماوس في نموذج العناصر في المستند (DOM) على الخط المتعدد.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على الخط المتعدد.

واجهة PolylineOptions

واجهة google.maps.PolylineOptions

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

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.

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

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)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث الماوس الخاص بـ DOM على المضلّع.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث حركة الماوس DOM على المضلّع.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث على ماوس المضلع.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تمرير الماوس على شكل "مضلع".
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث تمرير الماوس في نموذج العناصر في المستند (DOM) على المضلّع.
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)

طبقة على شكل مستطيل.

تمتد هذه الفئة إلى MVCObject.

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

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)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في نموذج العناصر في المستند على المستطيل.
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

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

فئة دائرة

صف واحد (google.maps.Circle)

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

تمتد هذه الفئة إلى MVCObject.

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

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)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث الماوس DOM على الدائرة.
mousemove
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدثMousemove في الدائرة.
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 ثابت

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

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

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