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) المَعلمات:  element:  Element القيمة المعروضة:  لا شيء يوقف هذا الخيار أحداث النقر والنقرة والسحب والعجلة على العنصر من الظهور في الخريطة. استخدِم هذا الخيار لمنع سحب الخريطة وتكبيرها أو تصغيرها، بالإضافة إلى أحداث "النقر" على الخريطة.
preventMapHitsFrom	preventMapHitsFrom(element) المَعلمات:  element:  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) المَعلمات:  latLng:  LatLng|LatLngLiteral القيمة المعروضة:  Point|null تُحسِّب إحداثيات البكسل للموقع الجغرافي المحدَّد في عنصر حاوية الخريطة.
fromLatLngToDivPixel	fromLatLngToDivPixel(latLng) المَعلمات:  latLng:  LatLng|LatLngLiteral optional القيمة المعروضة:  Point|null تُحسِّب هذه الوظيفة إحداثيات البكسل للموقع الجغرافي المحدَّد في عنصر DOM الذي يحتوي على الخريطة القابلة للسحب.
getVisibleRegion	getVisibleRegion() المَعلمات:  بدون القيمة المعروضة:  VisibleRegion|null المنطقة المرئية من الخريطة تعرِض القيمة null إذا لم يكن للخريطة حجم. تعرِض هذه السمة القيمة null إذا كان OverlayView على StreetViewPanorama.
getWorldWidth	getWorldWidth() المَعلمات:  بدون القيمة المعروضة:  number عرض العالم بالبكسل في مستوى التكبير الحالي بالنسبة إلى الإسقاطات التي تكون زاوية العنوان فيها 90 أو 270 درجة، يتوافق ذلك مع نطاق وحدات البكسل في محور Y.