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