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) مولفه های: element : Element ارزش بازگشتی: ندارد رویدادهای کلیک، ضربه زدن، کشیدن و چرخش روی عنصر را از حباب زدن به نقشه متوقف می کند. از این برای جلوگیری از کشیدن و بزرگنمایی نقشه و همچنین رویدادهای «کلیک» روی نقشه استفاده کنید.
preventMapHitsFrom	preventMapHitsFrom(element) مولفه های: element : 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) مولفه های: latLng : LatLng | LatLngLiteral مقدار بازگشتی: Point |null مختصات پیکسل مکان جغرافیایی داده شده را در عنصر ظرف نقشه محاسبه می کند.
fromLatLngToDivPixel	fromLatLngToDivPixel(latLng) مولفه های: latLng : LatLng | LatLngLiteral optional مقدار بازگشتی: Point |null مختصات پیکسل مکان جغرافیایی داده شده را در عنصر DOM که نقشه قابل کشیدن را نگه می دارد محاسبه می کند.
getVisibleRegion	getVisibleRegion() پارامترها: ندارد مقدار بازگشتی: VisibleRegion |null منطقه قابل مشاهده نقشه اگر نقشه فاقد اندازه باشد، null برمی‌گرداند. اگر OverlayView روی StreetViewPanorama باشد، null برمی‌گرداند.
getWorldWidth	getWorldWidth() پارامترها: ندارد مقدار برگشتی: number عرض جهان بر حسب پیکسل در سطح زوم فعلی. برای پیش‌بینی‌هایی با زاویه 90 یا 270 درجه، این با فاصله پیکسلی در محور Y مطابقت دارد.