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()
استدلال ها: هیچ
این رویداد زمانی فعال می‌شود که نقشه پس از حرکت یا بزرگ‌نمایی غیرفعال شود.
isfractionalzoomenabled_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی isFractionalZoomEnabled تغییر کند.
mapcapabilities_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که قابلیت های نقشه تغییر کند.
maptypeid_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی mapTypeId تغییر کند.
mousemove
function(event)
استدلال ها:
این رویداد هر زمان که ماوس کاربر روی کانتینر نقشه حرکت کند فعال می شود.
mouseout
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که ماوس کاربر از ظرف نقشه خارج می شود.
mouseover
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که ماوس کاربر وارد کانتینر نقشه می شود.
projection_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که طرح ریزی تغییر کند.
renderingtype_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که نوع rendering تغییر کرده باشد.
tilesloaded
function()
استدلال ها: هیچ
این رویداد زمانی اجرا می‌شود که بارگذاری کاشی‌های قابل مشاهده به پایان برسد.
tilt_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی شیب نقشه تغییر کند.
zoom_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی بزرگنمایی نقشه تغییر کند.
rightclick
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که کاربر روی نقشه کلیک راست کند.

رابط MapOptions

google.maps . MapOptions رابط google.maps . MapOptions

شی MapOptions برای تعریف ویژگی هایی که می توانند روی نقشه تنظیم شوند استفاده می شود.

backgroundColor optional
نوع: string optional
رنگ مورد استفاده برای پس زمینه نقشه div. این رنگ زمانی قابل مشاهده خواهد بود که کاشی‌ها هنوز هنگام حرکت کاربر بارگیری نشده باشند. این گزینه فقط زمانی قابل تنظیم است که نقشه اولیه باشد.
cameraControl optional
نوع: boolean optional
وضعیت فعال/غیرفعال کنترل دوربین.
cameraControlOptions optional
نوع: CameraControlOptions optional
گزینه های نمایش برای کنترل دوربین.
center optional
نوع: LatLng | LatLngLiteral optional
مرکز نقشه اولیه
clickableIcons optional
نوع: boolean optional
پیش فرض: true
در صورت false ، نمادهای نقشه قابل کلیک نیستند. یک نماد نقشه نشان دهنده یک نقطه مورد علاقه است که به عنوان POI نیز شناخته می شود.
colorScheme optional
نوع: ColorScheme |string optional
پیش فرض: ColorScheme.LIGHT
طرح رنگ اولیه نقشه. این گزینه فقط زمانی قابل تنظیم است که نقشه اولیه باشد.
controlSize optional
نوع: number optional
اندازه کنترل‌های ظاهر شده روی نقشه بر حسب پیکسل. این مقدار باید به طور مستقیم هنگام ایجاد نقشه ارائه شود، به روز رسانی این مقدار بعداً ممکن است کنترل ها را به حالت undefined برساند. فقط کنترل های ایجاد شده توسط خود Maps API را کنترل می کند. توسعه‌دهنده کنترل‌های سفارشی ایجاد کرده مقیاس نمی‌کند.
disableDefaultUI optional
نوع: boolean optional
همه دکمه های رابط کاربری پیش فرض را فعال/غیرفعال می کند. ممکن است به صورت جداگانه لغو شود. کنترل های صفحه کلید را که به طور جداگانه توسط گزینه MapOptions.keyboardShortcuts کنترل می شوند، غیرفعال نمی کند. کنترل‌های اشاره‌ای را که به طور جداگانه توسط گزینه MapOptions.gestureHandling کنترل می‌شوند، غیرفعال نمی‌کند.
disableDoubleClickZoom optional
نوع: boolean optional
زوم و مرکز را با دوبار کلیک فعال/غیرفعال می کند. به طور پیش فرض فعال است.

توجه : این ویژگی توصیه نمی شود . برای غیرفعال کردن بزرگنمایی روی دوبار کلیک، می توانید از ویژگی gestureHandling استفاده کنید و آن را روی "none" تنظیم کنید.

draggable optional
نوع: boolean optional
اگر false ، از کشیدن نقشه جلوگیری می کند. کشیدن به طور پیش فرض فعال است.
draggableCursor optional
نوع: string optional
نام یا نشانی اینترنتی مکان نما که هنگام حرکت ماوس روی نقشه قابل کشیدن نمایش داده می شود. این ویژگی از ویژگی css cursor برای تغییر آیکون استفاده می کند. همانند ویژگی css، باید حداقل یک مکان نما را مشخص کنید که URL نباشد. به عنوان مثال: draggableCursor: 'url( http://www.example.com/icon.png ), auto;' .
draggingCursor optional
نوع: string optional
نام یا نشانی اینترنتی مکان نما که هنگام کشیدن نقشه نمایش داده می شود. این ویژگی از ویژگی css cursor برای تغییر آیکون استفاده می کند. همانند ویژگی css، باید حداقل یک مکان نما را مشخص کنید که URL نباشد. برای مثال: draggingCursor: 'url( http://www.example.com/icon.png ), auto;' .
fullscreenControl optional
نوع: boolean optional
حالت فعال/غیرفعال کنترل تمام صفحه.
fullscreenControlOptions optional
نوع: FullscreenControlOptions optional
گزینه های نمایش برای کنترل تمام صفحه.
gestureHandling optional
نوع: string optional
این تنظیم نحوه مدیریت ژست‌ها را روی نقشه توسط API کنترل می‌کند. مقادیر مجاز:
  • "cooperative" : رویدادها و حرکات لمسی با یک انگشت را پیمایش کنید، صفحه را اسکرول کنید و نقشه را بزرگنمایی یا حرکت ندهید. حرکات لمسی دو انگشتی نقشه را حرکت داده و بزرگنمایی می کند. رویدادها را با کلید ctrl یا فشار دادن کلید ⌘ روی نقشه بزرگنمایی کنید.
    در این حالت نقشه با صفحه همکاری می کند .
  • "greedy" : تمام حرکات لمسی و پیمایش رویدادها روی نقشه حرکت می کنند یا بزرگنمایی می کنند.
  • "none" : نقشه را نمی توان با حرکات کاربر حرکت داد یا بزرگنمایی کرد.
  • "auto" : (پیش‌فرض) بسته به اینکه صفحه قابل پیمایش باشد یا در iframe، مدیریت اشاره یا مشارکتی یا حریصانه است.
heading optional
نوع: number optional
سمت برای تصاویر هوایی بر حسب درجه در جهت عقربه های ساعت از جهت اصلی شمال اندازه گیری شد. سرفصل‌ها به نزدیک‌ترین زاویه موجود که تصاویر در دسترس است، می‌چسبند.
headingInteractionEnabled optional
نوع: boolean optional
پیش فرض: false
آیا نقشه باید به کاربر اجازه کنترل عنوان دوربین (چرخش) را بدهد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
internalUsageAttributionIds optional
نوع: Iterable <string> optional
پیش فرض: null
شناسه انتساب استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه انتساب استفاده، می‌توانید این ویژگی را حذف کنید یا مقدار را با یک رشته خالی جایگزین کنید. فقط مقادیر منحصر به فرد ارسال خواهد شد. ممکن است تغییرات این مقدار پس از نمونه سازی نادیده گرفته شود.
isFractionalZoomEnabled optional
نوع: boolean optional
پیش فرض: true برای نقشه های برداری و false برای نقشه های شطرنجی
آیا نقشه باید به سطوح زوم کسری اجازه دهد یا خیر. به isfractionalzoomenabled_changed گوش دهید تا بدانید چه زمانی پیش‌فرض تنظیم شده است.
keyboardShortcuts optional
نوع: boolean optional
اگر false ، از کنترل نقشه توسط صفحه کلید جلوگیری می کند. میانبرهای صفحه کلید به طور پیش فرض فعال هستند.
mapId optional
نوع: string optional
شناسه نقشه نقشه این پارامتر را نمی توان پس از نمونه سازی نقشه تنظیم یا تغییر داد. Map.DEMO_MAP_ID می تواند برای آزمایش ویژگی هایی استفاده شود که به شناسه نقشه نیاز دارند اما نیازی به فعال کردن ابر ندارند.
mapTypeControl optional
نوع: boolean optional
حالت اولیه فعال/غیرفعال کنترل نوع Map.
mapTypeControlOptions optional
نوع: MapTypeControlOptions optional
گزینه های نمایش اولیه برای کنترل نوع Map.
mapTypeId optional
نوع: MapTypeId |string optional
نقشه اولیه MapTypeId. پیش‌فرض ROADMAP .
maxZoom optional
نوع: number optional
حداکثر سطح بزرگنمایی که روی نقشه نمایش داده می شود. اگر حذف شود یا روی null تنظیم شود، به جای آن از حداکثر بزرگنمایی از نوع نقشه فعلی استفاده می شود. مقادیر بزرگنمایی معتبر اعدادی از صفر تا حداکثر سطح بزرگنمایی پشتیبانی شده هستند.
minZoom optional
نوع: number optional
حداقل سطح بزرگنمایی که روی نقشه نمایش داده می شود. اگر حذف شود یا روی null تنظیم شود، به جای آن از حداقل بزرگنمایی از نوع نقشه فعلی استفاده می شود. مقادیر بزرگنمایی معتبر اعدادی از صفر تا حداکثر سطح بزرگنمایی پشتیبانی شده هستند.
noClear optional
نوع: boolean optional
اگر true ، محتویات قسمت Map را پاک نکنید.
panControl optional
نوع: boolean optional
حالت فعال/غیرفعال کنترل Pan.

panControlOptions optional
نوع: PanControlOptions optional
گزینه های نمایش برای کنترل Pan.

renderingType optional
نوع: RenderingType optional
پیش فرض: RenderingType.RASTER
این که آیا نقشه باید یک نقشه شطرنجی یا برداری باشد. این پارامتر را نمی توان پس از نمونه سازی نقشه تنظیم یا تغییر داد. اگر تنظیم نشود، پیکربندی ابری برای شناسه نقشه، نوع رندر را تعیین می‌کند (در صورت وجود). لطفاً توجه داشته باشید که نقشه‌های برداری ممکن است برای همه دستگاه‌ها و مرورگرها در دسترس نباشند و نقشه در صورت لزوم به یک نقشه شطرنجی برمی‌گردد.
restriction optional
نوع: MapRestriction optional
مرزی را تعیین می کند که محدوده نقشه را در دسترس کاربران محدود می کند. وقتی تنظیم شود، کاربر فقط می‌تواند در حالی که نمای دوربین در محدوده‌های مرزی باقی می‌ماند، حرکت کند و بزرگ‌نمایی کند.
rotateControl optional
نوع: boolean optional
حالت فعال/غیرفعال کنترل چرخش.
rotateControlOptions optional
نوع: RotateControlOptions optional
گزینه های نمایش برای کنترل چرخش.
scaleControl optional
نوع: boolean optional
حالت اولیه فعال/غیرفعال کنترل مقیاس.
scaleControlOptions optional
نوع: ScaleControlOptions optional
گزینه های نمایش اولیه برای کنترل مقیاس.
scrollwheel optional
نوع: boolean optional
اگر false ، زوم روی نقشه را با استفاده از چرخ پیمایش ماوس غیرفعال می کند. چرخ اسکرول به طور پیش فرض فعال است.

توجه : این ویژگی توصیه نمی شود . برای غیرفعال کردن بزرگنمایی با استفاده از چرخ اسکرول، می‌توانید از ویژگی gestureHandling استفاده کنید و آن را روی "cooperative" یا "none" تنظیم کنید.

streetView optional
نوع: StreetViewPanorama optional
یک StreetViewPanorama برای نمایش زمانی که آدمک نمای خیابان روی نقشه رها می شود. اگر پانوراما مشخص نشده باشد، هنگامی که آدمک رها شود، یک StreetViewPanorama پیش‌فرض در div نقشه نمایش داده می‌شود.
streetViewControl optional
نوع: boolean optional
حالت اولیه فعال/غیرفعال شده کنترل آدمک نمای خیابان. این کنترل بخشی از رابط کاربری پیش‌فرض است و هنگام نمایش یک نوع نقشه که پوشش خیابان نمای خیابان نباید روی آن ظاهر شود، باید روی false تنظیم شود (مثلاً یک نوع نقشه غیر زمینی).
streetViewControlOptions optional
نوع: StreetViewControlOptions optional
گزینه های نمایش اولیه برای کنترل آدمک نمای خیابان.
styles optional
نوع: Array < MapTypeStyle > optional
سبک هایی برای اعمال به هر یک از انواع نقشه های پیش فرض. توجه داشته باشید که برای حالت های satellite / hybrid و terrain ، این سبک ها فقط برای برچسب ها و هندسه اعمال می شوند. این ویژگی هنگام استفاده از شناسه نقشه یا هنگام استفاده از نقشه های برداری (به جای آن از سبک نقشه های مبتنی بر ابر استفاده کنید) در دسترس نیست.
tilt optional
نوع: number optional
برای نقشه های برداری، زاویه تابش نقشه را تنظیم می کند. مقادیر مجاز بسته به سطح بزرگنمایی نقشه محدود می شوند. برای نقشه های شطرنجی، رفتار سوئیچینگ خودکار را برای زاویه برخورد نقشه کنترل می کند. تنها مقادیر مجاز 0 و 45 هستند. مقدار 0 باعث می شود که نقشه همیشه از نمای بالای 0 درجه صرف نظر از سطح زوم و درگاه دید استفاده کند. مقدار 45 باعث می شود هر زمان که تصاویر 45 درجه برای سطح زوم فعلی و درگاه دید در دسترس باشد، زاویه شیب به طور خودکار به 45 تغییر کند و هر زمان که تصویر 45 درجه در دسترس نباشد به 0 برگردد (این رفتار پیش فرض است). تصاویر 45 درجه فقط برای انواع نقشه های satellite و hybrid ، در برخی مکان ها و در برخی از سطوح زوم در دسترس است. توجه: getTilt زاویه شیب فعلی را برمی گرداند، نه مقدار مشخص شده توسط این گزینه. از آنجایی که getTilt و این گزینه به چیزهای مختلفی اشاره دارد، ویژگی tilt bind() نکنید. انجام این کار ممکن است اثرات غیر قابل پیش بینی داشته باشد.
tiltInteractionEnabled optional
نوع: boolean optional
پیش فرض: false
آیا نقشه باید به کاربر اجازه کنترل شیب دوربین را بدهد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
zoom optional
نوع: number optional
سطح بزرگنمایی نقشه اولیه. مقادیر بزرگنمایی معتبر اعدادی از صفر تا حداکثر سطح بزرگنمایی پشتیبانی شده هستند. مقادیر بزرگنمایی بزرگتر با وضوح بالاتر مطابقت دارد.
zoomControl optional
نوع: boolean optional
حالت فعال/غیرفعال کنترل زوم.
zoomControlOptions optional
نوع: ZoomControlOptions optional
گزینه های نمایش برای کنترل زوم.

کلاس MapElement

google.maps . MapElement کلاس google.maps . MapElement

MapElement یک زیر کلاس HTMLElement برای رندر کردن نقشه ها است. پس از بارگذاری کتابخانه maps ، می توان یک نقشه در HTML ایجاد کرد. به عنوان مثال:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

در داخل از Map استفاده می کند که با ویژگی innerMap قابل دسترسی است.

عنصر سفارشی:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

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

این کلاس MapElementOptions را پیاده سازی می کند.

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

MapElement
MapElement([options])
پارامترها:
center
نوع: LatLng | LatLngLiteral optional
طول و عرض جغرافیایی مرکز نقشه.
ویژگی HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
نوع: boolean optional
پیش فرض: false
آیا نقشه باید به کاربر اجازه کنترل عنوان دوربین (چرخش) را بدهد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
ویژگی HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
نوع: Map
اشاره ای به Map که MapElement به صورت داخلی از آن استفاده می کند.
internalUsageAttributionIds
نوع: Iterable <string> optional
پیش فرض: null
شناسه انتساب استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه انتساب استفاده، می‌توانید این ویژگی را حذف کنید یا مقدار را با یک رشته خالی جایگزین کنید. فقط مقادیر منحصر به فرد ارسال خواهد شد. ممکن است تغییرات این مقدار پس از نمونه سازی نادیده گرفته شود.
ویژگی HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
نوع: string optional
شناسه نقشه نقشه این پارامتر را نمی توان پس از نمونه سازی نقشه تنظیم یا تغییر داد. Map.DEMO_MAP_ID می تواند برای آزمایش ویژگی هایی استفاده شود که به شناسه نقشه نیاز دارند اما نیازی به فعال کردن ابر ندارند.
ویژگی HTML:
  • <gmp-map map-id="string"></gmp-map>