Maps

کلاس نقشه

google.maps . Map کلاس google.maps . Map

این کلاس MVCObject را گسترش می دهد.

با فراخوانی const {Map} = await google.maps.importLibrary("maps") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Map
Map(mapDiv[, opts])
پارامترها:
  • mapDiv : HTMLElement نقشه برای پر کردن این عنصر رندر می شود.
  • opts : MapOptions optional
یک نقشه جدید در داخل ظرف HTML داده شده ایجاد می کند که معمولاً یک عنصر DIV است.
DEMO_MAP_ID شناسه نقشه که می تواند برای نمونه کدهایی که نیاز به شناسه نقشه دارند استفاده شود. این شناسه نقشه برای استفاده در برنامه‌های تولیدی در نظر گرفته نشده است و نمی‌تواند برای ویژگی‌هایی که نیاز به پیکربندی ابری دارند (مانند Cloud Styling) استفاده شود.
controls
نوع: Array < MVCArray < HTMLElement >>
کنترل های اضافی برای پیوست کردن به نقشه. برای افزودن یک کنترل به نقشه، <div> کنترل را به MVCArray مربوط به ControlPosition که باید در آن رندر شود، اضافه کنید.
data
نوع: Data
نمونه ای از Data که به نقشه متصل شده است. ویژگی هایی را به این شی Data اضافه کنید تا به راحتی آنها را در این نقشه نشان دهید.
mapTypes
رجیستری از نمونه های MapType با شناسه رشته.
overlayMapTypes
نوع: MVCArray < MapType optional >
انواع نقشه های اضافی برای همپوشانی. انواع نقشه های همپوشانی به ترتیبی که در آرایه overlayMapTypes ظاهر می شوند، در بالای نقشه پایه ای که به آن متصل شده اند، نمایش داده می شوند (همپوشانی هایی با مقادیر شاخص بالاتر در مقابل همپوشانی هایی با مقادیر شاخص کمتر نمایش داده می شوند).
fitBounds
fitBounds(bounds[, padding])
پارامترها:
  • bounds : LatLngBounds | LatLngBoundsLiteral Bounds برای نشان دادن.
  • padding : number| Padding optional Padding در پیکسل. محدوده ها در قسمتی از نقشه که پس از حذف padding باقی می ماند، متناسب خواهند بود. یک مقدار عددی در هر 4 طرف یک لایه را ایجاد می کند. برای ایجاد یک fitBounds در نتیجه getBounds، عدد 0 را در اینجا عرضه کنید.
ارزش بازگشتی: ندارد
ویوپورت را به گونه ای تنظیم می کند که محدوده های داده شده را داشته باشد.
توجه: هنگامی که نقشه روی display: none ، تنظیم شده است، تابع fitBounds اندازه نقشه را 0x0 می‌خواند و بنابراین کاری انجام نمی‌دهد. برای تغییر درگاه دید در حالی که نقشه پنهان است، نقشه را روی visibility: hidden قرار دهید، بنابراین مطمئن شوید که div نقشه اندازه واقعی دارد. برای نقشه های برداری، این روش شیب و سرفصل نقشه را روی مقادیر صفر پیش فرض تنظیم می کند. فراخوانی این روش ممکن است باعث ایجاد یک انیمیشن روان شود زیرا نقشه حرکت می کند و بزرگنمایی می کند تا با محدوده ها مطابقت داشته باشد. اینکه آیا این روش متحرک می شود یا نه به یک اکتشافی داخلی بستگی دارد.
getBounds
getBounds()
پارامترها: ندارد
مقدار بازگشتی: LatLngBounds |undefined مرزهای lat/lng نمای فعلی.
مرزهای lat/lng درگاه نمای فعلی را برمی‌گرداند. اگر بیش از یک نسخه از جهان قابل مشاهده باشد، محدوده در طول جغرافیایی از 180- تا 180 درجه متغیر است. اگر نقشه هنوز مقداردهی اولیه نشده باشد یا مرکز و بزرگنمایی تنظیم نشده باشد، نتیجه undefined است. برای نقشه‌های برداری با شیب یا عنوان غیر صفر، کرانهای lat/lng برگشتی نشان‌دهنده کوچک‌ترین کادر مرزی است که شامل ناحیه قابل مشاهده درگاه دید نقشه است. برای بدست آوردن ناحیه قابل مشاهده دقیق از نمای نقشه به MapCanvasProjection.getVisibleRegion مراجعه کنید.
getCenter
getCenter()
پارامترها: ندارد
مقدار بازگشتی: LatLng |undefined
موقعیت نمایش داده شده در مرکز نقشه را برمی گرداند. توجه داشته باشید که این شی LatLng پیچیده نشده است. برای اطلاعات بیشتر به LatLng مراجعه کنید. اگر مرکز یا مرزها تنظیم نشده باشد، نتیجه undefined است.
getClickableIcons
getClickableIcons()
پارامترها: ندارد
مقدار بازگشتی: boolean|undefined
قابلیت کلیک آیکون های نقشه را برمی گرداند. یک نماد نقشه نشان دهنده یک نقطه مورد علاقه است که به عنوان POI نیز شناخته می شود. اگر مقدار برگشتی true باشد، نمادها روی نقشه قابل کلیک هستند.
Beta getDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
پارامترها:
  • datasetId : string
مقدار بازگشتی: FeatureLayer
FeatureLayer برای datasetId مشخص شده برمی گرداند. شناسه‌های مجموعه داده باید در Google Cloud Console پیکربندی شوند. اگر شناسه مجموعه داده با سبک نقشه نقشه مرتبط نباشد، یا اگر استایل مبتنی بر داده در دسترس نباشد (بدون شناسه نقشه، بدون کاشی های برداری، لایه های ویژگی استایل مبتنی بر داده یا مجموعه داده پیکربندی شده در سبک نقشه)، این یک خطا را ثبت می کند و FeatureLayer.isAvailable حاصل نادرست خواهد بود.
getDiv
getDiv()
پارامترها: ندارد
مقدار بازگشتی: HTMLElement mapDiv نقشه.
getFeatureLayer
getFeatureLayer(featureType)
پارامترها:
مقدار بازگشتی: FeatureLayer
FeatureLayer از FeatureType خاص را برمی‌گرداند. یک FeatureLayer باید در Google Cloud Console فعال باشد. اگر یک FeatureLayer از FeatureType مشخص شده در این نقشه وجود نداشته باشد، یا اگر استایل مبتنی بر داده در دسترس نباشد (بدون شناسه نقشه، بدون کاشی های برداری، و هیچ FeatureLayer در سبک نقشه فعال نشده باشد)، این یک خطا را ثبت می کند و FeatureLayer.isAvailable حاصل نادرست خواهد بود.
getHeading
getHeading()
پارامترها: ندارد
مقدار بازگشتی: number|undefined
عنوان قطب نما نقشه را برمی گرداند. مقدار عنوان بر حسب درجه (در جهت عقربه های ساعت) از جهت اصلی شمال اندازه گیری می شود. اگر نقشه هنوز مقداردهی اولیه نشده باشد، نتیجه undefined است.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
پارامترها: ندارد
مقدار بازگشتی: boolean|null
نشان می دهد که آیا تعاملات عنوان فعال هستند یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
پارامترها: ندارد
مقدار بازگشتی: Iterable <string>|null
فهرستی از شناسه‌های انتساب استفاده را برمی‌گرداند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر.
getMapCapabilities
getMapCapabilities()
پارامترها: ندارد
مقدار بازگشتی: MapCapabilities
بر اساس شناسه نقشه ارائه شده، تماس گیرنده را از قابلیت های موجود در نقشه مطلع می کند.
getMapTypeId
getMapTypeId()
پارامترها: ندارد
مقدار بازگشتی: MapTypeId |string|undefined
getProjection
getProjection()
پارامترها: ندارد
مقدار بازگشتی: Projection |undefined
Projection فعلی را برمی‌گرداند. اگر نقشه هنوز مقداردهی اولیه نشده باشد، نتیجه undefined است. به رویداد projection_changed گوش دهید و مقدار آن را بررسی کنید تا مطمئن شوید که undefined نیست.
getRenderingType
getRenderingType()
پارامترها: ندارد
مقدار بازگشتی: RenderingType
RenderingType فعلی نقشه را برمی‌گرداند.
getStreetView
getStreetView()
پارامترها: ندارد
مقدار بازگشتی: StreetViewPanorama پانورامای محدود به نقشه.
StreetViewPanorama پیش‌فرض متصل به نقشه را برمی‌گرداند، که ممکن است یک پانورامای پیش‌فرض تعبیه‌شده در نقشه باشد، یا مجموعه پانوراما با استفاده از setStreetView() . تغییرات در streetViewControl نقشه در نمایش چنین پانورامای محدودی منعکس خواهد شد.
getTilt
getTilt()
پارامترها: ندارد
مقدار بازگشتی: number|undefined
زاویه تابش فعلی نقشه را بر حسب درجه از صفحه دید به صفحه نقشه برمی‌گرداند. برای نقشه های شطرنجی، نتیجه برای تصاویری که مستقیماً از بالای سر گرفته شده اند 0 یا برای تصاویر 45 درجه 45 خواهد بود. این روش مقدار تنظیم شده توسط setTilt را بر نمی گرداند. برای جزئیات به setTilt مراجعه کنید.
getTiltInteractionEnabled
getTiltInteractionEnabled()
پارامترها: ندارد
مقدار بازگشتی: boolean|null
فعال بودن تعاملات شیب را برمی‌گرداند. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
getZoom
getZoom()
پارامترها: ندارد
مقدار بازگشتی: number|undefined
بزرگنمایی نقشه را برمی گرداند. اگر بزرگنمایی تنظیم نشده باشد، نتیجه undefined است.
moveCamera
moveCamera(cameraOptions)
پارامترها:
ارزش بازگشتی: ندارد
بلافاصله دوربین نقشه را روی گزینه های دوربین هدف قرار می دهد، بدون انیمیشن.
panBy
panBy(x, y)
پارامترها:
  • x : number پیکسل ها برای حرکت نقشه در جهت x.
  • y : number پیکسل ها برای حرکت نقشه در جهت y.
ارزش بازگشتی: ندارد
مرکز نقشه را با فاصله داده شده بر حسب پیکسل تغییر می دهد. اگر فاصله کمتر از عرض و ارتفاع نقشه باشد، انتقال به آرامی متحرک خواهد شد. توجه داشته باشید که سیستم مختصات نقشه از غرب به شرق (برای مقادیر x) و از شمال به جنوب (برای مقادیر y) افزایش می یابد.
panTo
panTo(latLng)
پارامترها:
  • latLng : LatLng | LatLngLiteral طول و عرض جغرافیایی مرکز جدید نقشه.
ارزش بازگشتی: ندارد
مرکز نقشه را به LatLng داده شده تغییر می دهد. اگر تغییر کمتر از عرض و ارتفاع نقشه باشد، انتقال به آرامی متحرک خواهد شد.
panToBounds
panToBounds(latLngBounds[, padding])
پارامترها:
  • latLngBounds : LatLngBounds | LatLngBoundsLiteral مرزهایی که باید نقشه را به آن حرکت دهید.
  • padding : number| Padding optional Padding در پیکسل. یک مقدار عددی در هر 4 طرف یک لایه را ایجاد می کند. مقدار پیش فرض 0 است.
ارزش بازگشتی: ندارد
نقشه را با حداقل مقدار لازم برای حاوی LatLngBounds داده شده حرکت می دهد. هیچ تضمینی نمی‌کند که کرانه‌ها در کجای نقشه قرار بگیرند، به جز اینکه نقشه تا حد امکان در داخل {currentMapSizeInPx} - {padding} نمایش داده می‌شود. برای هر دو نقشه شطرنجی و برداری، زوم، شیب و عنوان نقشه تغییر نخواهد کرد.
setCenter
setCenter(latlng)
پارامترها: