DOM elements

کلاس OverlayView

google.maps . 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 توسط API فراخوانی نشود، پنجره ها مقداردهی اولیه نمی شوند.
getProjection
getProjection()
پارامترها: ندارد
مقدار بازگشتی: MapCanvasProjection
شی MapCanvasProjection مرتبط با این OverlayView را برمی‌گرداند. تا زمانی که onAdd توسط API فراخوانی نشود، طرح ریزی اولیه نمی شود.
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 رابط 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 رابط 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 برمی‌گرداند. اگر OverlayView روی StreetViewPanorama باشد، null برمی‌گرداند.
getWorldWidth
getWorldWidth()
پارامترها: ندارد
مقدار برگشتی: number
عرض جهان بر حسب پیکسل در سطح زوم فعلی. برای پیش‌بینی‌هایی با زاویه 90 یا 270 درجه، این با فاصله پیکسلی در محور Y مطابقت دارد.