DOM elements

فئة OverlayView

google.maps.OverlayView class

يمكنك تنفيذ هذه الفئة إذا كنت تريد عرض أنواع مخصّصة من عناصر التراكب على الخريطة.

يمكنك اكتساب السمات من هذه الفئة من خلال ضبط النموذج الأولي للعنصر الذي يظهر على سطح الشاشة: MyOverlay.prototype = new google.maps.OverlayView();. من المؤكد أنّ الدالة الانشائية OverlayView هي دالة فارغة.

يجب تنفيذ ثلاث طرق: onAdd() وdraw() وonRemove().

  • في الطريقة onAdd()، عليك إنشاء عناصر DOM وإضافتها كعناصر فرعية للشرائح.
  • في طريقة draw()، يجب تحديد موضع هذه العناصر.
  • في طريقة onRemove()، يجب إزالة العناصر من DOM.
يجب استدعاء setMap() باستخدام عنصر Map صالح لبدء طلب الطريقة onAdd() وsetMap(null) لبدء الطريقة onRemove(). يمكن استدعاء الطريقة setMap() في وقت الإنشاء أو في أي وقت لاحق عندما يجب إعادة عرض التراكب بعد إزالته. سيتم بعد ذلك استدعاء الطريقة draw() عند تغيير خاصية الخريطة التي يمكن أن تغيّر موضع العنصر، مثل التكبير أو التصغير أو المركز أو نوع الخريطة.

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

يمكنك الوصول إلى الخدمة من خلال الاتصال بالرقم const {OverlayView} = await google.maps.importLibrary("maps") أو const {OverlayView} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
OverlayView
OverlayView()
المَعلمات:  بدون
تُنشئ OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
المَعلمات: 
القيمة المعروضة:  لا شيء
يوقف هذا الخيار أحداث النقر والنقرة والسحب والعجلة على العنصر من الظهور في الخريطة. استخدِم هذا الخيار لمنع سحب الخريطة وتكبيرها أو تصغيرها، بالإضافة إلى أحداث "النقر" على الخريطة.
preventMapHitsFrom
preventMapHitsFrom(element)
المَعلمات: 
القيمة المعروضة:  لا شيء
يوقف هذا الخيار النقر على العنصر أو ضغطه لعرضه على الخريطة. استخدِم هذا الخيار لمنع الخريطة من بدء أحداث "النقر".
draw
draw()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
نفِّذ هذه الطريقة لرسم الصورة المتراكبة أو تعديلها. استخدِم موضع projection.fromLatLngToDivPixel() لتحديد موضع التراكب بشكل صحيح بالنسبة إلى MapPanes. يتمّ استدعاء هذه الطريقة بعد onAdd()‎، ويتمّ استدعاؤها عند تغيير مستوى التكبير أو التصغير أو المركز. لا يُنصح بتنفيذ عمل كثيف حسابيًا باستخدام هذه الطريقة.
getMap
getMap()
المَعلمات:  بدون
القيمة المعروضة:  Map|StreetViewPanorama
getPanes
getPanes()
المَعلمات:  بدون
القيمة المعروضة:  MapPanes|null
عرض الأقسام التي يمكن فيها عرض OverlayView لا يتمّ إعداد الأقسام إلى أن تطلب واجهة برمجة التطبيقات onAdd.
getProjection
getProjection()
المَعلمات:  بدون
القيمة المعروضة:  MapCanvasProjection
تعرِض هذه السمة عنصر MapCanvasProjection المرتبط بهذا العنصر OverlayView. لا يتمّ إعداد الإسقاط إلى أن تطلب واجهة برمجة التطبيقات onAdd.
onAdd
onAdd()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
نفِّذ هذه الطريقة لإعداد عناصر DOM للصورة التي تظهر على سطح الشاشة. يتمّ استدعاء هذه الطريقة مرّة واحدة بعد استدعاء setMap() باستخدام خريطة صالحة. في هذه المرحلة، سيتمّ إعداد الأقسام والعرض.
onRemove
onRemove()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
نفِّذ هذه الطريقة لإزالة عناصرك من نموذج DOM. يتمّ استدعاء هذه الطريقة مرّة واحدة بعد طلب setMap(null).
setMap
setMap(map)
المَعلمات: 
  • map:  Map|StreetViewPanorama optional الخريطة أو الصورة البانورامية إذا تم اختيار null، ستتم إزالة الطبقة.
القيمة المعروضة:  لا شيء
تُضيف هذه الوظيفة الصورة المتراكبة إلى الخريطة أو الصورة البانورامية.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

واجهة MapPanes

google.maps.MapPanes واجهة

floatPane
النوع:  Element
تحتوي هذه اللوحة على نافذة المعلومات. ويظهر فوق جميع العناصر التي تظهر على سطح الخريطة. (اللوحة 4).
mapPane
النوع:  Element
هذه اللوحة هي اللوحة السفلية وتظهر فوق المربّعات. ولا يتلقّى أحداث DOM. (اللوحة 0).
markerLayer
النوع:  Element
تحتوي هذه اللوحة على علامات. ولا يتلقّى أحداث DOM. (اللوحة 2).
overlayLayer
النوع:  Element
تحتوي هذه اللوحة على خطوط متعددة الأضلاع وأشكال متعددة الأضلاع وتراكبات الأرض وتراكبات طبقات المربّعات. ولا يتلقّى أحداث DOM. (اللوحة 1).
overlayMouseTarget
النوع:  Element
تحتوي هذه اللوحة على العناصر التي تتلقّى أحداث DOM. (اللوحة 3).

واجهة MapCanvasProjection

google.maps.MapCanvasProjection واجهة

يتم إتاحة هذا الكائن للعنصر OverlayView من داخل طريقة الرسم. لا يمكن ضمان بدء عملية الإعداد إلى أن يتم استدعاء draw.
fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
المَعلمات: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
القيمة المعروضة:  LatLng|null
تُحتسب الإحداثيات الجغرافية من إحداثيات البكسل في حاوية الخريطة.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
المَعلمات: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
القيمة المعروضة:  LatLng|null
تُحسِّب الإحداثيات الجغرافية من إحداثيات البكسل في div الذي يحتوي على الخريطة القابلة للسحب.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
المَعلمات: 
القيمة المعروضة:  Point|null
تُحسِّب إحداثيات البكسل للموقع الجغرافي المحدَّد في عنصر حاوية الخريطة.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
المَعلمات: 
القيمة المعروضة:  Point|null
تُحسِّب هذه الوظيفة إحداثيات البكسل للموقع الجغرافي المحدَّد في عنصر DOM الذي يحتوي على الخريطة القابلة للسحب.
getVisibleRegion
getVisibleRegion()
المَعلمات:  بدون
القيمة المعروضة:  VisibleRegion|null
المنطقة المرئية من الخريطة تعرِض القيمة null إذا لم يكن للخريطة حجم. تعرِض هذه السمة القيمة null إذا كان OverlayView على StreetViewPanorama.
getWorldWidth
getWorldWidth()
المَعلمات:  بدون
القيمة المعروضة:  number
عرض العالم بالبكسل في مستوى التكبير الحالي بالنسبة إلى الإسقاطات التي تكون زاوية العنوان فيها 90 أو 270 درجة، يتوافق ذلك مع نطاق وحدات البكسل في محور Y.