DOM elements

فئة OverlayView

google.maps.OverlayView صف

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

يمكنك استخدام هذه الفئة من خلال ضبط نموذج أوّلي للطبقة المتراكبة: 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").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
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 interface

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

MapCanvasProjection interface

google.maps.MapCanvasProjection interface

يتم توفير هذا العنصر للدالة 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.