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.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {OverlayView} = await google.map.importLibrary("maps") أو const {OverlayView} = await google.map.importLibrary("streetView"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الشركة المصنِّعة
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 لعرض الأجزاء التي يمكن عرض تراكب المشاهدة فيها. لم تتم تهيئة الأجزاء حتى يتم استدعاء onAdd بواسطة واجهة برمجة التطبيقات.
getProjection	getProjection() المعلّمات: بدون قيمة الإرجاع: MapCanvasProjection لعرض الكائن MapCanvasProjection المرتبط بـ OverlayView. لم يتم إعداد الإسقاط حتى يتم استدعاء onAdd بواسطة واجهة برمجة التطبيقات.
onAdd	onAdd() المعلّمات: بدون قيمة الإرجاع: بدون يمكنك تطبيق هذه الطريقة لتهيئة عناصر DOM التي تظهر على سطح الفيديو. ويتم استدعاء هذه الطريقة مرة واحدة بعد استدعاء setMap() باستخدام خريطة صالحة. في هذه المرحلة، سيتم إعداد الأجزاء والإسقاط.
onRemove	onRemove() المعلّمات: بدون قيمة الإرجاع: بدون يمكنك تطبيق هذه الطريقة لإزالة عناصرك من نموذج العناصر في المستند. ويتم استدعاء هذه الطريقة مرة واحدة بعد استدعاء الدالة 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 من داخل طريقة الرسم. ولا يمكن ضمان تهيئة الموقع إلا بعد طلب السحب.

الطُرق
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 في صورة بانورامية للتجوّل الافتراضي.
getWorldWidth	getWorldWidth() المعلّمات: بدون قيمة الإرجاع: number عرض العالم بالبكسل بمستوى التكبير/التصغير الحالي. بالنسبة إلى الإسقاطات التي تبلغ زاوية رأسها 90 أو 270 درجة، يتوافق هذا مع امتداد البكسل في المحور الصادي.