DOM elements

فئة OverlayView

google.maps.OverlayView class
extends MVCObject
library "maps", "streetView"

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

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

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

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

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

const {OverlayView} = await google.maps.importLibrary("maps");

أو

const {OverlayView} = await google.maps.importLibrary("streetView");

الشركة المصنِّعة
OverlayView	OverlayView() المَعلمات: لا تتوفّر أي مَعلمات تنشئ OverlayView.

الطرق الثابتة
preventMapHitsAndGesturesFrom	preventMapHitsAndGesturesFrom(element) المَعلمات: element: Element القيمة المعروضة: لا شيء يوقف أحداث النقر والنقر على الشاشة والسحب والعجلة على العنصر من الظهور على الخريطة. استخدِم هذا الخيار لمنع سحب الخريطة وتكبيرها أو تصغيرها، بالإضافة إلى أحداث "النقر" على الخريطة.
preventMapHitsFrom	preventMapHitsFrom(element) المَعلمات: element: Element القيمة المعروضة: لا شيء يمنع النقر على العنصر من الانتقال إلى الخريطة. استخدِم هذه السمة لمنع الخريطة من تشغيل أحداث "النقر".

الطُرق
draw	draw() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: void يجب تنفيذ هذه الطريقة لرسم التراكب أو تعديله. استخدِم الموضع من projection.fromLatLngToDivPixel() لتحديد موضع العنصر المركّب بشكل صحيح بالنسبة إلى MapPanes. يتم استدعاء هذه الطريقة بعد onAdd()‎، ويتم استدعاؤها عند تغيير مستوى التكبير أو التصغير أو المركز. لا يُنصح بإجراء عمليات معالجة مكلفة في هذه الطريقة.
getMap	getMap() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: Map|StreetViewPanorama
getPanes	getPanes() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: MapPanes|null تعرض هذه الدالة الأجزاء التي يمكن عرض OverlayView فيها. لا تتم تهيئة الأجزاء حتى يتم استدعاء onAdd بواسطة واجهة برمجة التطبيقات.
getProjection	getProjection() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: MapCanvasProjection تعرض هذه السمة عنصر MapCanvasProjection المرتبط بـ OverlayView. لا تتم تهيئة العرض حتى يتم استدعاء onAdd من خلال واجهة برمجة التطبيقات.
onAdd	onAdd() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: void يجب تنفيذ هذه الطريقة لإعداد عناصر DOM الخاصة بالتراكب. يتم استدعاء هذه الطريقة مرة واحدة بعد استدعاء setMap()‎ باستخدام خريطة صالحة. في هذه المرحلة، ستكون اللوحات والعرض قد تم إعدادهما.
onRemove	onRemove() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: void يجب تنفيذ هذه الطريقة لإزالة العناصر من 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 interface

واجهة 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.