DOM elements

کلاس OverlayView

google.maps.OverlayView class
extends MVCObject
library "maps", "streetView"

اگر می‌خواهید انواع سفارشی اشیای هم‌پوشان را در نقشه نمایش دهید، می‌توانید این کلاس را پیاده‌سازی کنید.

با تنظیم نمونه اولیه هم‌پوشانی‌تان، از این کلاس ارث‌بری کنید: MyOverlay.prototype = new google.maps.OverlayView();. سازنده OverlayView تضمین می‌شود که تابع خالی باشد.

باید سه روش را پیاده‌سازی کنید: onAdd()، draw()، و onRemove().

• در روش onAdd()، باید اشیای DOM را ایجاد کنید و آن‌ها را به‌عنوان فرزندان قاب‌ها اضافه کنید.
• در روش draw()، باید این عناصر را جای‌گذاری کنید.
• در روش onRemove()، باید اشیاء را از DOM بردارید.

باید setMap() را با شیء Map معتبر فراخوانی کنید تا فراخوانی به روش onAdd() راه‌اندازی شود و setMap(null) را برای راه‌اندازی روش onRemove() فراخوانی کنید. روش setMap() را می‌توان در زمان ساخت یا در هر نقطه‌ای پس‌از آن که هم‌پوشانی باید پس‌از برداشتن دوباره نشان داده شود، فراخوانی کرد. سپس هرگاه ویژگی نقشه‌ای که می‌تواند موقعیت عنصر را تغییر دهد (مثل بزرگ‌نمایی، مرکز، یا نوع نقشه) تغییر کند، روش draw() فراخوانده می‌شود.

const {OverlayView} = await google.maps.importLibrary("maps");

یا

const {OverlayView} = await google.maps.importLibrary("streetView");

سازنده
OverlayView	OverlayView() پارامترها: هیچ OverlayView ایجاد می‌کند.

روش‌های ایستا
preventMapHitsAndGesturesFrom	preventMapHitsAndGesturesFrom(element) پارامترها: ‫element:‏ Element مقدار برگشتی: هیچ رویدادهای کلیک، ضربه، کشیدن، و چرخاندن روی عنصر را از حباب‌سازی روی نقشه متوقف می‌کند. از این گزینه برای جلوگیری از کشیدن و بزرگ‌نمایی نقشه و همچنین رویدادهای «کلیک» نقشه استفاده کنید.
preventMapHitsFrom	preventMapHitsFrom(element) پارامترها: ‫element:‏ Element مقدار برگشتی: هیچ از حباب‌سازی کلیک یا تک‌ضرب روی عنصر در نقشه جلوگیری می‌کند. از این برای جلوگیری از راه‌اندازی رویدادهای «کلیک» توسط نقشه استفاده کنید.

روش‌ها
draw	draw() پارامترها: هیچ مقدار برگشتی: void این روش را برای ترسیم یا به‌روزرسانی هم‌پوشانی پیاده‌سازی کنید. از موقعیت projection.fromLatLngToDivPixel() برای قرار دادن صحیح هم‌پوشانی نسبت به MapPanes استفاده کنید. این روش پس‌از()onAdd فراخوانی می‌شود و هنگام تغییر بزرگ‌نمایی یا مرکز فراخوانی می‌شود. انجام کارهای محاسباتی سنگین در این روش توصیه نمی‌شود.
getMap	getMap() پارامترها: هیچ مقدار برگشتی: Map|StreetViewPanorama
getPanes	getPanes() پارامترها: هیچ مقدار برگشتی: MapPanes|null قاب‌هایی را که این OverlayView می‌تواند در آن‌ها ارائه شود برمی‌گرداند. تا زمانی که onAdd توسط میانای برنامه‌سازی کاربردی فراخوانی نشود، قاب‌ها مقداردهی اولیه نمی‌شوند.
getProjection	getProjection() پارامترها: هیچ مقدار برگشتی: MapCanvasProjection شیء MapCanvasProjection مرتبط با این OverlayView را برمی‌گرداند. تا زمانی که onAdd توسط API فراخوانی نشود، طرح‌ریزی مقداردهی اولیه نمی‌شود.
onAdd	onAdd() پارامترها: هیچ مقدار برگشتی: void این روش را برای مقداردهی اولیه عناصر DOM هم‌پوشانی پیاده‌سازی کنید. این روش یک‌بار پس‌از فراخوانی setMap() با نقشه معتبر فراخوانی می‌شود. در این مرحله، قاب‌ها و طرح‌ریزی مقداردهی اولیه شده‌اند.
onRemove	onRemove() پارامترها: هیچ مقدار برگشتی: void این روش را برای برداشتن عناصرتان از 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 این قاب حاوی پنجره اطلاعات است. این نشانگر بالاتر از همه لایه‌های نقشه است. (قاب ۴).
mapPane	نوع: Element این قاب پایین‌ترین قاب است و بالای کاشی‌ها قرار دارد. رویدادهای DOM را دریافت نمی‌کند. (قاب ۰).
markerLayer	نوع: Element این قاب حاوی نشانگر است. رویدادهای DOM را دریافت نمی‌کند. (قاب ۲).
overlayLayer	نوع: Element این قاب حاوی چندخطی‌ها، چندضلعی‌ها، هم‌پوشانی‌های زمین، و هم‌پوشانی‌های لایه کاشی است. رویدادهای DOM را دریافت نمی‌کند. (قاب ۱).
overlayMouseTarget	نوع: Element این قاب حاوی عناصری است که رویدادهای DOM را دریافت می‌کنند. (قاب ۳).

میانای MapCanvasProjection

میانا google.maps.MapCanvasProjection

این شیء ازطریق روش ترسیم برای OverlayView دردسترس قرار می‌گیرد. تا زمانی که draw فراخوانی نشود، مقداردهی اولیه آن تضمین نمی‌شود.

روش‌ها
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 عرض جهان به پیکسل در سطح بزرگ‌نمایی کنونی. برای طرح‌افکنی‌هایی با زاویه عنوان ۹۰ یا ۲۷۰ درجه، این مقدار با گستره پیکسل در محور Y مطابقت دارد.