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)
پارامترها:
ارزش بازگشتی: ندارد
setClickableIcons
setClickableIcons(value)
پارامترها:
  • value : boolean
ارزش بازگشتی: ندارد
کنترل می کند که آیا نمادهای نقشه قابل کلیک هستند یا خیر. یک نماد نقشه نشان دهنده یک نقطه مورد علاقه است که به عنوان POI نیز شناخته می شود. برای غیرفعال کردن قابلیت کلیک کردن آیکون های نقشه، مقدار false را به این روش ارسال کنید.
setHeading
setHeading(heading)
پارامترها:
  • heading : number
ارزش بازگشتی: ندارد
سمت قطب نما را برای نقشه بر حسب درجه از جهت اصلی شمال اندازه گیری می کند. برای نقشه های شطرنجی، این روش فقط برای تصاویر هوایی کاربرد دارد.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
پارامترها:
  • headingInteractionEnabled : boolean
ارزش بازگشتی: ندارد
تنظیم می کند که آیا تعاملات عنوان فعال باشد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
setMapTypeId
setMapTypeId(mapTypeId)
پارامترها:
ارزش بازگشتی: ندارد
setOptions
setOptions(options)
پارامترها:
ارزش بازگشتی: ندارد
setRenderingType
setRenderingType(renderingType)
پارامترها:
ارزش بازگشتی: ندارد
RenderingType فعلی نقشه را تنظیم می کند.
setStreetView
setStreetView(panorama)
پارامترها:
  • panorama : StreetViewPanorama optional پانوراما برای اتصال به نقشه.
ارزش بازگشتی: ندارد
یک StreetViewPanorama را به نقشه متصل می کند. این پانوراما روی StreetViewPanorama پیش‌فرض لغو می‌شود و به نقشه اجازه می‌دهد به یک پانورامای خارجی خارج از نقشه متصل شود. تنظیم پانوراما بر روی null ، پانورامای تعبیه شده پیش فرض را به نقشه متصل می کند.
setTilt
setTilt(tilt)
پارامترها:
  • tilt : number
ارزش بازگشتی: ندارد
برای نقشه های برداری، زاویه تابش نقشه را تنظیم می کند. مقادیر مجاز بسته به سطح بزرگنمایی نقشه محدود می شوند.

برای نقشه های شطرنجی، رفتار سوئیچینگ خودکار را برای زاویه برخورد نقشه کنترل می کند. تنها مقادیر مجاز 0 و 45 هستند. setTilt(0) باعث می شود که نقشه همیشه از نمای بالای 0 درجه صرف نظر از سطح زوم و درگاه دید استفاده کند. setTilt(45) باعث می شود هر زمان که تصویر 45 درجه برای سطح زوم فعلی و درگاه دید در دسترس باشد، زاویه شیب به طور خودکار به 45 تغییر کند، و هر زمان که تصویر 45 درجه در دسترس نباشد، به 0 برگردد (این رفتار پیش فرض است). تصاویر 45 درجه فقط برای انواع نقشه های satellite و hybrid ، در برخی مکان ها و در برخی از سطوح زوم در دسترس است. توجه: getTilt زاویه شیب فعلی را برمی گرداند، نه مقدار تنظیم شده توسط setTilt . از آنجایی که getTilt و setTilt به چیزهای مختلفی اشاره دارند، ویژگی tilt bind() نکنید. انجام این کار ممکن است اثرات غیر قابل پیش بینی داشته باشد.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
پارامترها:
  • tiltInteractionEnabled : boolean
ارزش بازگشتی: ندارد
تنظیم می کند که آیا تعاملات شیب فعال هستند یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
setZoom
setZoom(zoom)
پارامترها:
  • zoom : number مقادیر بزرگنمایی بزرگتر با وضوح بالاتر مطابقت دارد.
ارزش بازگشتی: ندارد
بزرگنمایی نقشه را تنظیم می کند.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll
bounds_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که کران های درگاه دید تغییر کرده باشند.
center_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی مرکز نقشه تغییر کند.
click
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که کاربر روی نقشه کلیک کند. یک MapMouseEvent با ویژگی‌های مکان کلیک‌شده برگردانده می‌شود مگر اینکه روی نماد مکانی کلیک شده باشد، در این صورت یک IconMouseEvent با شناسه مکان برگردانده می‌شود. IconMouseEvent و MapMouseEvent یکسان هستند، با این تفاوت که IconMouseEvent دارای قسمت شناسه مکان است. هنگامی که شناسه مکان مهم نیست، همیشه می‌توان با رویداد به عنوان یک MapMouseEvent تلقی کرد. اگر روی یک نشانگر یا پنجره اطلاعات کلیک شود، رویداد کلیک فعال نمی شود.
contextmenu
function(event)
استدلال ها:
این رویداد زمانی فعال می‌شود که رویداد منوی متنی DOM روی کانتینر نقشه فعال شود.
dblclick
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که کاربر روی نقشه دوبار کلیک کند. توجه داشته باشید که رویداد کلیک گاهی یک بار و گاهی دو بار درست قبل از این مورد فعال می شود.
drag
function()
استدلال ها: هیچ
این رویداد به طور مکرر اجرا می شود در حالی که کاربر نقشه را می کشد.
dragend
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که کاربر کشیدن نقشه را متوقف کند. توجه: زمانی که کاربر از حرکت در نقشه با استفاده از صفحه کلید متوقف شود، دراژند اجرا نمی شود. لطفاً به جای آن از رویداد Map.idle استفاده کنید تا مشخص شود کاربر چه زمانی از حرکت کردن یا کشیدن نقشه متوقف شده است.
dragstart
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که کاربر شروع به کشیدن نقشه می کند.
heading_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی عنوان نقشه تغییر کند.
idle
function()
استدلال ها: هیچ
این رویداد زمانی فعال می‌شود که نقشه پس از حرکت یا بزرگ‌نمایی غیرفعال شود.