اعلامیه: سبک نقشه پایه جدید به زودی به پلتفرم نقشه های گوگل می آید. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگی پیش‌فرض جدید، پین‌های مدرن شده و بهبودهایی در تجربه‌ها و قابلیت استفاده از نقشه است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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`	شناسه نقشه که می تواند برای نمونه کدهایی که نیاز به شناسه نقشه دارند استفاده شود. این Map ID برای استفاده در برنامه‌های تولیدی در نظر گرفته نشده است و نمی‌تواند برای ویژگی‌هایی که نیاز به پیکربندی ابری دارند (مانند Cloud Styling) استفاده شود.

ثابت ها

DEMO_MAP_ID شناسه نقشه که می تواند برای نمونه کدهایی که نیاز به شناسه نقشه دارند استفاده شود. این Map ID برای استفاده در برنامه‌های تولیدی در نظر گرفته نشده است و نمی‌تواند برای ویژگی‌هایی که نیاز به پیکربندی ابری دارند (مانند Cloud Styling) استفاده شود.

خواص
`controls`	نوع: `Array < MVCArray < HTMLElement >>` کنترل های اضافی برای پیوست کردن به نقشه. برای افزودن یک کنترل به نقشه، `<div>` کنترل را به `MVCArray` مربوط به `ControlPosition` که باید در آن رندر شود، اضافه کنید.
`data`	نوع: `Data` نمونه ای از `Data` که به نقشه متصل شده است. ویژگی هایی را به این شی `Data` اضافه کنید تا به راحتی آنها را در این نقشه نشان دهید.
`mapTypes`	نوع: `MapTypeRegistry` رجیستری از نمونه های `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` باشد، نمادها روی نقشه قابل کلیک هستند.
`getDatasetFeatureLayer`	توجه: فقط در کانال v=beta موجود است. `getDatasetFeatureLayer(datasetId)` پارامترها: `datasetId` : `string` مقدار بازگشتی: `FeatureLayer` `FeatureLayer` را برای `datasetId` مشخص شده برمی گرداند. شناسه‌های مجموعه داده باید در Google Cloud Console پیکربندی شوند. اگر شناسه مجموعه داده با سبک نقشه نقشه مرتبط نباشد، یا اگر استایل مبتنی بر داده در دسترس نباشد (بدون شناسه نقشه، بدون کاشی‌های برداری، بدون لایه‌های ویژگی استایل مبتنی بر داده یا مجموعه داده‌هایی که در سبک نقشه پیکربندی شده‌اند)، این یک خطا، و `FeatureLayer.isAvailable` حاصل نادرست خواهد بود.
`getDiv`	`getDiv()` پارامترها: ندارد مقدار بازگشتی: `HTMLElement` mapDiv نقشه.
`getFeatureLayer`	`getFeatureLayer(featureType)` پارامترها: `featureType` : `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)` پارامترها: `cameraOptions` : `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)` پارامترها: `latlng` : `LatLng \| LatLngLiteral` ارزش بازگشتی: ندارد
`setClickableIcons`	`setClickableIcons(value)` پارامترها: `value` : `boolean` ارزش بازگشتی: ندارد کنترل می کند که آیا نمادهای نقشه قابل کلیک هستند یا خیر. یک نماد نقشه نشان دهنده یک نقطه مورد علاقه است که به عنوان POI نیز شناخته می شود. برای غیرفعال کردن قابلیت کلیک کردن آیکون های نقشه، مقدار `false` را به این روش ارسال کنید.
`setHeading`	`setHeading(heading)` پارامترها: `heading` : `number` ارزش بازگشتی: ندارد سمت قطب نما را برای نقشه بر حسب درجه از جهت اصلی شمال اندازه گیری می کند. برای نقشه های شطرنجی، این روش فقط برای تصاویر هوایی کاربرد دارد.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` پارامترها: `headingInteractionEnabled` : `boolean` ارزش بازگشتی: ندارد تنظیم می کند که آیا تعاملات عنوان فعال باشد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
`setMapTypeId`	`setMapTypeId(mapTypeId)` پارامترها: `mapTypeId` : `MapTypeId \|string` ارزش بازگشتی: ندارد
`setOptions`	`setOptions(options)` پارامترها: `options` : `MapOptions optional` ارزش بازگشتی: ندارد
`setRenderingType`	`setRenderingType(renderingType)` پارامترها: `renderingType` : `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)` استدلال ها: `event` : `MapMouseEvent \| IconMouseEvent` این رویداد زمانی فعال می شود که کاربر روی نقشه کلیک کند. یک MapMouseEvent با ویژگی‌های مکان کلیک‌شده برگردانده می‌شود مگر اینکه روی نماد مکانی کلیک شده باشد، در این صورت یک IconMouseEvent با شناسه مکان برگردانده می‌شود. IconMouseEvent و MapMouseEvent یکسان هستند، با این تفاوت که IconMouseEvent دارای قسمت شناسه مکان است. هنگامی که شناسه مکان مهم نیست، همیشه می‌توان با رویداد به عنوان یک MapMouseEvent تلقی کرد. اگر روی یک نشانگر یا پنجره اطلاعات کلیک شود، رویداد کلیک فعال نمی شود.
`contextmenu`	`function(event)` استدلال ها: `event` : `MapMouseEvent` این رویداد زمانی فعال می‌شود که رویداد منوی متنی DOM روی کانتینر نقشه فعال شود.
`dblclick`	`function(event)` استدلال ها: `event` : `MapMouseEvent` این رویداد زمانی فعال می شود که کاربر روی نقشه دوبار کلیک کند. توجه داشته باشید که رویداد کلیک گاهی یک بار و گاهی دو بار درست قبل از این مورد فعال می شود.
`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)` استدلال ها: `event` : `MapMouseEvent` این رویداد هر زمان که ماوس کاربر روی کانتینر نقشه حرکت کند فعال می شود.
`mouseout`	`function(event)` استدلال ها: `event` : `MapMouseEvent` این رویداد زمانی فعال می شود که ماوس کاربر از ظرف نقشه خارج می شود.
`mouseover`	`function(event)` استدلال ها: `event` : `MapMouseEvent` این رویداد زمانی فعال می شود که ماوس کاربر وارد کانتینر نقشه می شود.
`projection_changed`	`function()` استدلال ها: هیچ این رویداد زمانی فعال می شود که طرح ریزی تغییر کند.
`renderingtype_changed`	`function()` استدلال ها: هیچ این رویداد زمانی فعال می شود که نوع rendering تغییر کرده باشد.
`tilesloaded`	`function()` استدلال ها: هیچ این رویداد زمانی اجرا می‌شود که بارگذاری کاشی‌های قابل مشاهده به پایان برسد.
`tilt_changed`	`function()` استدلال ها: هیچ این رویداد زمانی فعال می شود که ویژگی شیب نقشه تغییر کند.
`zoom_changed`	`function()` استدلال ها: هیچ این رویداد زمانی فعال می شود که ویژگی بزرگنمایی نقشه تغییر کند.
`rightclick`	منسوخ شده: به جای آن از رویداد `Map.contextmenu` برای پشتیبانی از الگوهای استفاده مانند کنترل کلیک روی macOS استفاده کنید. `function(event)` استدلال ها: `event` : `MapMouseEvent` این رویداد زمانی فعال می شود که کاربر روی نقشه کلیک راست کند.

رابط 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`	منسوخ شده: در سال 2017 منسوخ شد. برای غیرفعال کردن کشیدن روی نقشه، می توانید از ویژگی `gestureHandling` استفاده کنید و آن را روی `"none"` تنظیم کنید. نوع: `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`	منسوخ شده: کنترل Pan از سپتامبر 2015 منسوخ شده است. نوع: `boolean optional` حالت فعال/غیرفعال کنترل Pan.
`panControlOptions optional`	منسوخ شده: کنترل Pan از سپتامبر 2015 منسوخ شده است. نوع: `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])` پارامترها: `options` : `MapElementOptions optional`

خواص
`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>`
`renderingType`	نوع: `RenderingType optional` پیش فرض: `RenderingType.VECTOR` این که آیا نقشه باید یک نقشه شطرنجی یا برداری باشد. این پارامتر را نمی توان پس از نمونه سازی نقشه تنظیم یا تغییر داد. اگر تنظیم نشود، پیکربندی ابری برای شناسه نقشه، نوع رندر را تعیین می‌کند (در صورت وجود). لطفاً توجه داشته باشید که نقشه‌های برداری ممکن است برای همه دستگاه‌ها و مرورگرها در دسترس نباشند و نقشه در صورت لزوم به یک نقشه شطرنجی برمی‌گردد. ویژگی HTML: `<gmp-map rendering-type="vector"></gmp-map>` `<gmp-map rendering-type="raster"></gmp-map>`
`tiltInteractionDisabled`	نوع: `boolean optional` پیش فرض: `false` آیا نقشه باید به کاربر اجازه کنترل شیب دوربین را بدهد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن). ویژگی HTML: `<gmp-map tilt-interaction-disabled></gmp-map>`
`zoom`	نوع: `number optional` سطح زوم نقشه مقادیر بزرگنمایی معتبر اعدادی از صفر تا حداکثر سطح بزرگنمایی پشتیبانی شده هستند. مقادیر بزرگنمایی بزرگتر با وضوح بالاتر مطابقت دارد. ویژگی HTML: `<gmp-map zoom="number"></gmp-map>`

شکاف ها
`control-block-end-inline-center`	عنصر شکافدار را در موقعیت `ControlPosition.BLOCK_END_INLINE_CENTER` قرار می دهد.
`control-block-end-inline-end`	عنصر شکافدار را در موقعیت `ControlPosition.BLOCK_END_INLINE_END` قرار می دهد.
`control-block-end-inline-start`	عنصر شکافدار را در موقعیت `ControlPosition.BLOCK_END_INLINE_START` قرار می‌دهد.
`control-block-start-inline-center`	عنصر شکافدار را در موقعیت `ControlPosition.BLOCK_START_INLINE_CENTER` قرار می دهد.
`control-block-start-inline-end`	عنصر شکافدار را در موقعیت `ControlPosition.BLOCK_START_INLINE_END` قرار می دهد.
`control-block-start-inline-start`	عنصر شکافدار را در موقعیت `ControlPosition.BLOCK_START_INLINE_START` قرار می دهد.
`control-inline-end-block-center`	عنصر شکافدار را در موقعیت `ControlPosition.INLINE_END_BLOCK_CENTER` قرار می دهد.
`control-inline-end-block-end`	عنصر شکافدار را در موقعیت `ControlPosition.INLINE_END_BLOCK_END` قرار می دهد.
`control-inline-end-block-start`	عنصر شکافدار را در موقعیت `ControlPosition.INLINE_END_BLOCK_START` قرار می دهد.
`control-inline-start-block-center`	عنصر شکافدار را در موقعیت `ControlPosition.INLINE_START_BLOCK_CENTER` قرار می دهد.
`control-inline-start-block-end`	عنصر شکافدار را در موقعیت `ControlPosition.INLINE_START_BLOCK_END` قرار می دهد.
`control-inline-start-block-start`	عنصر شکافدار را در موقعیت `ControlPosition.INLINE_START_BLOCK_START` قرار می دهد.
`default`	می‌توانید اجزای قابل استفاده مجدد را در اطراف Maps JavaScript Web Components، مانند `AdvancedMarkerElement` ، با استفاده از عناصر سفارشی ایجاد کنید. به‌طور پیش‌فرض، هر عنصر سفارشی که مستقیماً به `MapElement` اضافه می‌شود، در `MapPanes.overlayMouseTarget` شکاف داده می‌شود و رندر می‌شود. با این حال، Maps JavaScript API Web Components ممکن است دوباره در اسلات های داخلی `MapElement` قرار گیرد.

روش ها
`addEventListener`	توجه: فقط در کانال v=beta موجود است. `addEventListener(type, listener[, options])` پارامترها: `type` : `string` یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. `listener` : `EventListener \| EventListenerObject` شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد `options` : `boolean\| AddEventListenerOptions optional` گزینه ها را ببینید. رویدادهای سفارشی فقط `capture` و `passive` پشتیبانی می کنند. مقدار برگشتی: `void` تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید
`removeEventListener`	توجه: فقط در کانال v=beta موجود است. `removeEventListener(type, listener[, options])` پارامترها: `type` : `string` رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. `listener` : `EventListener \| EventListenerObject` شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. `options` : `boolean\| EventListenerOptions optional` گزینه ها را ببینید مقدار برگشتی: `void` شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید

روش ها

addEventListener

addEventListener(type, listener[, options])

پارامترها:

type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط capture و passive پشتیبانی می کنند.

مقدار برگشتی: void

تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید

removeEventListener

removeEventListener(type, listener[, options])

پارامترها:

type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
options : boolean| EventListenerOptions optional گزینه ها را ببینید

مقدار برگشتی: void

شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید

رویدادها
`gmp-zoomchange`	`function(event)` استدلال ها: `event` : `ZoomChangeEvent` این رویداد زمانی فعال می شود که ویژگی بزرگنمایی نقشه تغییر کند.

رابط MapElementOptions

google.maps . MapElementOptions رابط google.maps . MapElementOptions

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

خواص
`center optional`	نوع: `LatLng \| LatLngLiteral optional` `MapElement.center` ببینید.
`headingInteractionDisabled optional`	نوع: `boolean optional` `MapElement.headingInteractionDisabled` ببینید.
`internalUsageAttributionIds optional`	نوع: `Iterable <string> optional` `MapElement.internalUsageAttributionIds` ببینید.
`mapId optional`	نوع: `string optional` `MapElement.mapId` ببینید.
`renderingType optional`	نوع: `RenderingType optional` `MapElement.renderingType` ببینید.
`tiltInteractionDisabled optional`	نوع: `boolean optional` `MapElement.tiltInteractionDisabled` ببینید.
`zoom optional`	نوع: `number optional` `MapElement.zoom` ببینید.

کلاس ZoomChangeEvent

google.maps . ZoomChangeEvent کلاس google.maps . ZoomChangeEvent

این رویداد از نظارت بر تغییر بزرگنمایی ایجاد شده است.

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

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

رابط MapTypeStyle

google.maps . MapTypeStyle رابط google.maps . MapTypeStyle

MapTypeStyle مجموعه ای از انتخابگرها و استایلرها است که نحوه استایل دهی نقشه را مشخص می کند. انتخاب‌کننده‌ها ویژگی‌های نقشه و/یا عناصری را که باید تحت تأثیر قرار گیرند مشخص می‌کنند و استایلرها مشخص می‌کنند که چگونه آن ویژگی‌ها و عناصر باید اصلاح شوند. برای جزئیات، به مرجع سبک مراجعه کنید.

خواص
`stylers`	نوع: `Array < Object >` قوانین سبک برای اعمال به ویژگی ها و عناصر نقشه انتخاب شده. قوانین به ترتیبی که در این آرایه مشخص کرده اید اعمال می شوند. برای دستورالعمل‌های استفاده و مقادیر مجاز، به مرجع سبک مراجعه کنید.
`elementType optional`	نوع: `string optional` عنصری که یک استایلر باید روی آن اعمال شود. یک عنصر جنبه بصری یک ویژگی روی نقشه است. مثال: یک برچسب، یک نماد، سکته مغزی یا پر شده روی هندسه و موارد دیگر. اختیاری. اگر `elementType` مشخص نشده باشد، مقدار `'all'` در نظر گرفته می شود. برای جزئیات استفاده و مقادیر مجاز، به مرجع سبک مراجعه کنید.
`featureType optional`	نوع: `string optional` ویژگی یا گروهی از ویژگی‌ها که یک استایلر باید روی آن اعمال شود. اختیاری. اگر `featureType` مشخص نشده باشد، مقدار `'all'` در نظر گرفته می شود. برای جزئیات استفاده و مقادیر مجاز، به مرجع سبک مراجعه کنید.

رابط MapMouseEvent

google.maps . MapMouseEvent رابط google.maps . MapMouseEvent

این شی از رویدادهای مختلف ماوس بر روی نقشه و همپوشانی ها برگردانده می شود و شامل تمام فیلدهای نشان داده شده در زیر است.

خواص
`domEvent`	نوع: `MouseEvent \| TouchEvent \| PointerEvent \| KeyboardEvent \| Event` رویداد DOM بومی مربوطه. توسعه‌دهندگان نباید به تعریف و سازگار بودن ویژگی‌های `target` ، `currentTarget` ، `relatedTarget` و `path` متکی باشند. توسعه دهندگان همچنین نباید به ساختار DOM پیاده سازی داخلی Maps API تکیه کنند. به دلیل نگاشت رویداد داخلی، `domEvent` ممکن است معنای متفاوتی با `MapMouseEvent` داشته باشد (مثلاً یک «کلیک» `MapMouseEvent` ممکن است دارای یک `domEvent` از نوع `KeyboardEvent` باشد).
`latLng optional`	نوع: `LatLng optional` طول و عرض جغرافیایی که هنگام وقوع رویداد زیر مکان نما قرار داشت.

خواص

domEvent

نوع: MouseEvent | TouchEvent | PointerEvent | KeyboardEvent | Event

رویداد DOM بومی مربوطه. توسعه‌دهندگان نباید به تعریف و سازگار بودن ویژگی‌های target ، currentTarget ، relatedTarget و path متکی باشند. توسعه دهندگان همچنین نباید به ساختار DOM پیاده سازی داخلی Maps API تکیه کنند. به دلیل نگاشت رویداد داخلی، domEvent ممکن است معنای متفاوتی با MapMouseEvent داشته باشد (مثلاً یک «کلیک» MapMouseEvent ممکن است دارای یک domEvent از نوع KeyboardEvent باشد).

latLng optional

نوع: LatLng optional

طول و عرض جغرافیایی که هنگام وقوع رویداد زیر مکان نما قرار داشت.

روش ها
`stop`	`stop()` پارامترها: ندارد مقدار برگشتی: `void` از انتشار بیشتر این رویداد جلوگیری می کند.

رابط IconMouseEvent

google.maps . IconMouseEvent رابط google.maps . IconMouseEvent

این شی در یک رویداد زمانی ارسال می شود که کاربر روی نمادی روی نقشه کلیک می کند. شناسه مکان این مکان در عضو placeId ذخیره می شود. برای جلوگیری از نمایش پنجره اطلاعات پیش فرض، متد stop() را در این رویداد فراخوانی کنید تا از انتشار آن جلوگیری کنید. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید.

این رابط MapMouseEvent را گسترش می دهد.

خواص
`placeId optional`	نوع: `string optional` شناسه مکانی مکانی که روی آن کلیک شده است. از این شناسه مکان می توان برای پرس و جوی اطلاعات بیشتر در مورد ویژگی روی آن استفاده کرد. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید.
ارثی: `domEvent` ، `latLng`

روش ها
موروثی: `stop`

ثابت های ColorScheme

google.maps . ColorScheme ثابت های google.maps . ColorScheme

شناسه های طرح های رنگی نقشه اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. به عنوان مثال، 'FOLLOW_SYSTEM' یا google.maps.ColorScheme.FOLLOW_SYSTEM .

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

ثابت ها
`DARK`	طرح رنگ تیره برای نقشه
`FOLLOW_SYSTEM`	طرح رنگ بر اساس تنظیمات سیستم انتخاب می شود.
`LIGHT`	طرح رنگ روشن برای نقشه مقدار پیش‌فرض برای Maps JS قدیمی.

ثابت های MapTypeId

google.maps . MapTypeId ثابت های google.maps . MapTypeId

شناسه های MapType های رایج. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. به عنوان مثال، 'satellite' یا google.maps.MapTypeId.SATELLITE .

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

ثابت ها
`HYBRID`	این نوع نقشه یک لایه شفاف از خیابان های اصلی را در تصاویر ماهواره ای نشان می دهد.
`ROADMAP`	این نوع نقشه یک نقشه خیابان معمولی را نمایش می دهد.
`SATELLITE`	این نوع نقشه تصاویر ماهواره ای را نمایش می دهد.
`TERRAIN`	این نوع نقشه نقشه هایی را با ویژگی های فیزیکی مانند زمین و پوشش گیاهی نمایش می دهد.

کلاس MapTypeRegistry

google.maps . MapTypeRegistry کلاس google.maps . MapTypeRegistry

یک رجیستری برای نمونه های MapType، کلید شده توسط MapType id.

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

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

سازنده
`MapTypeRegistry`	`MapTypeRegistry()` پارامترها: ندارد `MapTypeRegistry` مجموعه ای از انواع نقشه های سفارشی را برای استفاده در نقشه در اختیار دارد. به عنوان مثال، API هنگام ارائه لیستی از انواع نقشه های موجود در کنترل ها، با این رجیستری مشورت می کند.

روش ها
`set`	`set(id, mapType)` پارامترها: `id` : `string` شناسه MapType برای افزودن به رجیستری. `mapType` : `MapType \|?` شی MapType برای افزودن به رجیستری. ارزش بازگشتی: ندارد رجیستری را طوری تنظیم می کند که شناسه رشته پاس شده را با MapType تصویب شده مرتبط کند.
به ارث رسیده: `addListener` ، `bindTo` ، `get` ، `notify` ، `setValues` ، `unbind` ، `unbindAll`

رابط MapRestriction

google.maps . MapRestriction رابط google.maps . MapRestriction

محدودیتی که می تواند روی نقشه اعمال شود. نمای نقشه از این محدودیت ها تجاوز نخواهد کرد.

خواص
`latLngBounds`	نوع: `LatLngBounds \| LatLngBoundsLiteral` هنگام تنظیم ، یک کاربر فقط می تواند داخل مرزهای داده شده و زوم کند. مرزها می توانند طول و عرض جغرافیایی را محدود کنند ، یا فقط می توانند عرض جغرافیایی را محدود کنند. برای مرزهای فقط عرض جغرافیایی از طول های غربی و شرقی از -180 و 180 استفاده کنید ، به ترتیب ، به عنوان مثال ، `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}` .
`strictBounds optional`	نوع: `boolean optional` با تنظیم پرچم `strictBounds` به `true` می توان مرزها را محدودتر کرد. این امر باعث می شود تا چقدر کاربر می تواند بزرگنمایی کند و اطمینان حاصل کند که همه چیز در خارج از مرزهای محدود پنهان باقی می ماند. پیش فرض `false` است ، به این معنی که یک کاربر می تواند تا زمانی که کل منطقه محدود مشاهده نشود ، بزرگنمایی کند ، احتمالاً شامل مناطقی در خارج از منطقه محدود است.

خواص

latLngBounds

نوع: LatLngBounds | LatLngBoundsLiteral

هنگام تنظیم ، یک کاربر فقط می تواند داخل مرزهای داده شده و زوم کند. مرزها می توانند طول و عرض جغرافیایی را محدود کنند ، یا فقط می توانند عرض جغرافیایی را محدود کنند. برای مرزهای فقط عرض جغرافیایی از طول های غربی و شرقی از -180 و 180 استفاده کنید ، به ترتیب ، به عنوان مثال ، latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} .

strictBounds optional

نوع: boolean optional

با تنظیم پرچم strictBounds به true می توان مرزها را محدودتر کرد. این امر باعث می شود تا چقدر کاربر می تواند بزرگنمایی کند و اطمینان حاصل کند که همه چیز در خارج از مرزهای محدود پنهان باقی می ماند. پیش فرض false است ، به این معنی که یک کاربر می تواند تا زمانی که کل منطقه محدود مشاهده نشود ، بزرگنمایی کند ، احتمالاً شامل مناطقی در خارج از منطقه محدود است.

کلاس ترافیک

google.maps . TrafficLayer کلاس google.maps . TrafficLayer

یک لایه ترافیک

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

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

سازنده
`TrafficLayer`	`TrafficLayer([opts])` پارامترها: `opts` : `TrafficLayerOptions optional` لایه ای که ترافیک فعلی جاده را نشان می دهد.

روش ها
`getMap`	`getMap()` پارامترها: ندارد مقدار بازگشت: `Map \|null` نقشه ای را که این لایه در آن نمایش داده می شود ، برمی گرداند.
`setMap`	`setMap(map)` پارامترها: `map` : `Map optional` ارزش بازگشتی: ندارد لایه را روی نقشه مشخص شده ارائه می دهد. اگر نقشه روی `null` تنظیم شود ، لایه برداشته می شود.
`setOptions`	`setOptions(options)` پارامترها: `options` : `TrafficLayerOptions optional` ارزش بازگشتی: ندارد
وراثت: `addListener` ، `bindTo` ، `get` ، `notify` ، `set` ، `setValues` ، `unbind` ، `unbindAll`

رابط ترافیک

google.maps . TrafficLayerOptions رابط google.maps . TrafficLayerOptions

شیء ترافیک مورد استفاده برای تعریف خواصی که می تواند بر روی یک ترافیک تنظیم شود ، استفاده می شود.

خواص
`autoRefresh optional`	نوع: `boolean optional` پیش فرض: `true` آیا لایه ترافیک با اطلاعات به روز شده به طور خودکار تازه می شود.
`map optional`	نوع: `Map optional` نقشه ای که برای نمایش لایه ترافیک بر روی آن.

کلاس ترانزیت

google.maps . TransitLayer کلاس google.maps . TransitLayer

یک لایه ترانزیت

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

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

سازنده
`TransitLayer`	`TransitLayer()` پارامترها: ندارد لایه ای که خطوط ترانزیت را نشان می دهد.

روش ها
`getMap`	`getMap()` پارامترها: ندارد مقدار بازگشت: `Map \|null` نقشه ای را که این لایه در آن نمایش داده می شود ، برمی گرداند.
`setMap`	`setMap(map)` پارامترها: `map` : `Map optional` مقدار برگشتی: `void` لایه را روی نقشه مشخص شده ارائه می دهد. اگر نقشه روی `null` تنظیم شود ، لایه برداشته می شود.
وراثت: `addListener` ، `bindTo` ، `get` ، `notify` ، `set` ، `setValues` ، `unbind` ، `unbindAll`

کلاس BicyclingLayer

google.maps . BicyclingLayer کلاس google.maps . BicyclingLayer

لایه ای که خطوط دوچرخه و مسیرها را نشان می دهد.

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

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

سازنده
`BicyclingLayer`	`BicyclingLayer()` پارامترها: ندارد لایه ای که خطوط دوچرخه و مسیرها را به نمایش می گذارد و جاده های بزرگ را از بین می برد.

روش ها
`getMap`	`getMap()` پارامترها: ندارد مقدار بازگشت: `Map \|null` نقشه ای را که این لایه در آن نمایش داده می شود ، برمی گرداند.
`setMap`	`setMap(map)` پارامترها: `map` : `Map optional` مقدار برگشتی: `void` لایه را روی نقشه مشخص شده ارائه می دهد. اگر نقشه روی `null` تنظیم شود ، لایه حذف می شود.
وراثت: `addListener` ، `bindTo` ، `get` ، `notify` ، `set` ، `setValues` ، `unbind` ، `unbindAll`

رابط CameraOptions

google.maps . CameraOptions رابط google.maps . CameraOptions

برای تنظیم گزینه های دوربین نقشه استفاده می شود.

خواص
`center optional`	نوع: `LatLngLiteral \| LatLng optional`
`heading optional`	نوع: `number optional`
`tilt optional`	نوع: `number optional`
`zoom optional`	نوع: `number optional`

رابط Visibleregion

google.maps . VisibleRegion رابط google.maps . VisibleRegion

حاوی چهار نقطه که چند ضلعی چهار طرفه را که منطقه قابل مشاهده نقشه است ، تعریف می کند. در نقشه بردار ، این چند ضلعی می تواند به جای مستطیل ، یک ذوزنقه باشد ، هنگامی که نقشه بردار دارای شیب است.

خواص
`farLeft`	نوع: `LatLng`
`farRight`	نوع: `LatLng`
`latLngBounds`	نوع: `LatLngBounds` کوچکترین جعبه محدود که شامل منطقه قابل مشاهده است.
`nearLeft`	نوع: `LatLng`
`nearRight`	نوع: `LatLng`

ثابت RenderingType

google.maps . RenderingType ثابت google.maps . RenderingType

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

ثابت ها
`RASTER`	نشان می دهد که نقشه یک نقشه شطرنجی است.
`UNINITIALIZED`	نشان می دهد که هنوز مشخص نیست که نقشه بردار یا شطرنج است ، زیرا نقشه هنوز به پایان نرسیده است.
`VECTOR`	نشان می دهد که نقشه نقشه بردار است.

رابط MapCapability

google.maps . MapCapabilities رابط google.maps . MapCapabilities

شیء حاوی عکس فوری از آنچه در حال حاضر برای نقشه در دسترس است. توجه داشته باشید که این لزوماً به این معنی نیست که ماژول های مربوطه بارگیری یا اولیه می شوند ، بلکه این است که نقشه فعلی اجازه استفاده از این API ها را دارد. ویژگی های لیستی از قابلیت های ممکن را مشاهده کنید.

خواص
`isAdvancedMarkersAvailable optional`	نوع: `boolean optional` اگر درست باشد ، این نقشه به درستی پیکربندی شده است تا امکان استفاده از نشانگرهای پیشرفته فراهم شود. توجه داشته باشید که برای استفاده از نشانگرهای پیشرفته هنوز باید کتابخانه `marker` را وارد کنید. برای کسب اطلاعات بیشتر به https://goo.gle/gmp-isadvancedmarkersavailable مراجعه کنید.
`isDataDrivenStylingAvailable optional`	نوع: `boolean optional` در صورت صحت ، این نقشه به درستی پیکربندی شده است تا حداقل برای حداقل یک بازیگر استفاده از یک ظاهر طراحی شده داده محور باشد. برای کسب اطلاعات بیشتر به https://goo.gle/gmp-data-driden-styling و https://goo.gle/gmp-featurelayerisavailable مراجعه کنید.
`isWebGLOverlayViewAvailable optional`	نوع: `boolean optional` اگر درست باشد ، این نقشه به درستی پیکربندی شده است تا امکان استفاده از `WebGLOverlayView` فراهم شود.

Maps

کلاس نقشه

سازنده

ثابت ها

خواص

روش ها

رویدادها

رابط MapOptions

خواص

کلاس MapElement

سازنده

خواص

شکاف ها

روش ها

رویدادها

رابط MapElementOptions

خواص

کلاس ZoomChangeEvent

رابط MapTypeStyle

خواص

رابط MapMouseEvent

خواص

روش ها

رابط IconMouseEvent

خواص

روش ها

ثابت های ColorScheme

ثابت ها

ثابت های MapTypeId

ثابت ها

کلاس MapTypeRegistry

سازنده

روش ها

رابط MapRestriction

خواص

کلاس ترافیک

سازنده

روش ها

رابط ترافیک

خواص

کلاس ترانزیت

سازنده

روش ها

کلاس BicyclingLayer

سازنده

روش ها

رابط CameraOptions

خواص

رابط Visibleregion

خواص

ثابت RenderingType

ثابت ها

رابط MapCapability

خواص