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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

OverlayView
OverlayView()
المعلّمات: بدون
لإنشاء OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
المعلّمات: 
قيمة الإرجاع: بدون
لإيقاف أحداث النقر والنقر والسحب والعجلة على العنصر من الظهور فقاعات على الخريطة. استخدم هذا لمنع سحب الخريطة وتكبيرها/تصغيرها، بالإضافة إلى أحداث "النقر" على الخريطة.
preventMapHitsFrom
preventMapHitsFrom(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)
المعلّمات: 
  • mapMap|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])
المعلّمات: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
قيمة الإرجاع:  LatLng|null
لحساب الإحداثيات الجغرافية من إحداثيات البكسل في حاوية الخريطة.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
المعلّمات: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
قيمة الإرجاع:  LatLng|null
لحساب الإحداثيات الجغرافية من إحداثيات البكسل في div الذي يحمل الخريطة القابلة للسحب.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
المعلّمات: 
قيمة الإرجاع:  Point|null
لحساب إحداثيات البكسل لموقع جغرافي معين في عنصر حاوية الخريطة.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
المعلّمات: 
قيمة الإرجاع:  Point|null
لحساب إحداثيات البكسل لموقع جغرافي معين في عنصر DOM الذي يحتفظ بالخريطة القابلة للسحب.
getVisibleRegion
getVisibleRegion()
المعلّمات: بدون
قيمة الإرجاع:  VisibleRegion|null
المنطقة المرئية من الخريطة. لعرض null إذا لم يكن للخريطة حجم محدد. لعرض null إذا كان OverlayView في صورة بانورامية للتجوّل الافتراضي.
getWorldWidth
getWorldWidth()
المعلّمات: بدون
قيمة الإرجاع:  number
عرض العالم بالبكسل بمستوى التكبير/التصغير الحالي. بالنسبة إلى الإسقاطات التي تبلغ زاوية رأسها 90 أو 270 درجة، يتوافق هذا مع امتداد البكسل في المحور الصادي.