دریافت کلید نسخه نمایشی Maps: با «کلید نسخه نمایشی Maps» برخی‌از ویژگی‌های Maps JavaScript API و «کیت میانای کاربر جاها» را بدون هزینه امتحان کنید—اطلاعات صورت‌حساب لازم نیست.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

Maps

کلاس MapElement

class google.maps.MapElement extends HTMLElement implements MapElementOptions
library "maps"

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 استفاده می‌کند که با ویژگی MapElement.innerMap قابل‌دسترسی است.

<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>

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

سازنده
`MapElement`	`MapElement([options])` پارامترها: `options: MapElementOptions optional`

مشخصات
`center` attr: center	نوع: `LatLng\|LatLngLiteral optional` طول/ عرض جغرافیایی مرکز نقشه. مشخصه HTML: `center="lat,lng"`
`headingInteractionDisabled` attr: heading-interaction-disabled	نوع: `boolean optional` پیش‌فرض: `false` اینکه آیا نقشه باید به کاربر اجازه دهد جهت دوربین (چرخش) را کنترل کند یا نه. این گزینه فقط زمانی اعمال می‌شود که نقشه از نوع نقشه بُرداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابری برای شناسه نقشه استفاده خواهد شد (درصورت دردسترس بودن). مشخصه HTML: `heading-interaction-disabled`
`innerMap`	نوع: `Map` ارجاعی به `Map` که MapElement به‌طور داخلی استفاده می‌کند.
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` پیش‌فرض: `null` شناسه ارجاع استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه اسناد استفاده، می‌توانید این ویژگی را حذف کنید یا مقدار را با رشته‌ای خالی جایگزین کنید. فقط مقادیر یکتا ارسال خواهد شد. تغییرات در این مقدار پس‌از نمونه‌سازی ممکن است نادیده گرفته شود. مشخصه HTML: `internal-usage-attribution-ids="id1 id2"`
`mapId` attr: map-id	نوع: `string optional` شناسه نقشه نقشه. این پارامتر را نمی‌توان پس‌از نمونه‌سازی نقشه تنظیم یا تغییر داد. از `Map.DEMO_MAP_ID` می‌توان برای امتحان کردن ویژگی‌هایی استفاده کرد که به شناسه نقشه نیاز دارند اما به فعال‌سازی ابری نیاز ندارند. مشخصه HTML: `map-id="string"`
`renderingType` attr: rendering-type	نوع: `RenderingType optional` پیش‌فرض: `RenderingType.VECTOR` اینکه نقشه باید شطرنجی باشد یا بُرداری. این پارامتر را نمی‌توان پس‌از نمونه‌سازی نقشه تنظیم یا تغییر داد. اگر تنظیم نشده باشد، پیکربندی ابری برای شناسه نقشه نوع پردازش را تعیین خواهد کرد (درصورت دردسترس بودن). لطفاً توجه داشته باشید که نقشه‌های بُرداری ممکن است برای همه دستگاه‌ها و مرورگرها دردسترس نباشد و درصورت نیاز، نقشه به نقشه شطرنجی برمی‌گردد. مشخصه HTML: `rendering-type="value-name"`
`tiltInteractionDisabled` attr: tilt-interaction-disabled	نوع: `boolean optional` پیش‌فرض: `false` اینکه آیا نقشه باید به کاربر اجازه دهد شیب دوربین را کنترل کند یا نه. این گزینه فقط زمانی اعمال می‌شود که نقشه از نوع نقشه بُرداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابری برای شناسه نقشه استفاده خواهد شد (درصورت دردسترس بودن). مشخصه HTML: `tilt-interaction-disabled`
`zoom` attr: zoom	نوع: `number optional` سطح بزرگ‌نمایی نقشه. مقادیر معتبر بزرگ‌نمایی اعدادی از صفر تا حداکثر سطح بزرگ‌نمایی پشتیبانی‌شده هستند. مقادیر بزرگ‌تر بزرگ‌نمایی با وضوح بالاتر مطابقت دارد. مشخصه HTML: `zoom="number"`

ماشین سکه‌ای
`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»، مانند `AdvancedMarkerElement`، ایجاد کنید. به‌طور پیش‌فرض، هر عنصر سفارشی که مستقیماً به `MapElement` اضافه شود، در `MapPanes.overlayMouseTarget` جای‌گذاری و ارائه خواهد شد. بااین‌حال، «عناصر وب میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» ممکن است دوباره به جایگاه‌های داخلی `MapElement` اختصاص داده شوند.

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

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

میانای MapElementOptions

میانا google.maps.MapElementOptions
پیاده‌سازی‌شده توسط MapElement

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

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

کلاس ZoomChangeEvent

class google.maps.ZoomChangeEvent extends Event
library "maps"

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

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

کلاس نقشه

class google.maps.Map extends MVCObject
library "maps"

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

سازنده
`Map`	`Map(mapDiv[, opts])` پارامترها: `mapDiv: HTMLElement` نقشه برای پر کردن این عنصر پرداز خواهد شد. `opts: MapOptions optional` گزینه‌ها نقشه جدیدی در محفظه HTML داده‌شده ایجاد می‌کند که معمولاً عنصر `DIV` است.

ثابت‌ها
`DEMO_MAP_ID`	شناسه نقشه که می‌تواند برای نمونه کدهایی که به شناسه نقشه نیاز دارند استفاده شود. این شناسه نقشه برای استفاده در برنامه‌های تولیدی درنظر گرفته نشده است و نمی‌توان از آن برای ویژگی‌هایی که به پیکربندی ابری نیاز دارند (مانند «سبک‌پردازی بااستفاده از فضای ابری») استفاده کرد.

ثابت‌ها

DEMO_MAP_ID شناسه نقشه که می‌تواند برای نمونه کدهایی که به شناسه نقشه نیاز دارند استفاده شود. این شناسه نقشه برای استفاده در برنامه‌های تولیدی درنظر گرفته نشده است و نمی‌توان از آن برای ویژگی‌هایی که به پیکربندی ابری نیاز دارند (مانند «سبک‌پردازی بااستفاده از فضای ابری») استفاده کرد.

مشخصات
`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` مرز برای نمایش. `padding: number\|Padding optional` حاشیه داخلی به پیکسل. مرزها در بخشی از نقشه که پس‌از برداشتن حاشیه باقی می‌ماند جا داده می‌شود. مقدار عددی باعث ایجاد حاشیه داخلی یکسان در هر ۴ طرف می‌شود. برای اینکه fitBounds در نتیجه getBounds یکسان‌توان باشد، مقدار 0 را در اینجا وارد کنید. مقدار برگشتی: هیچ ناحیه نمایش را طوری تنظیم می‌کند که شامل مرزهای داده‌شده باشد. توجه: وقتی نقشه روی `display: none` تنظیم شده باشد، تابع `fitBounds` اندازه نقشه را ۰×۰ می‌خواند و بنابراین کاری انجام نمی‌دهد. برای تغییر دادن نمای دید وقتی نقشه پنهان است، نقشه را روی `visibility: hidden` تنظیم کنید تا مطمئن شوید div نقشه اندازه واقعی دارد. برای نقشه‌های بُرداری، این روش شیب و جهت نقشه را روی مقادیر پیش‌فرض صفر تنظیم می‌کند. فراخوانی این روش ممکن است باعث ایجاد پویانمایی همواری شود، زیرا نقشه برای قرار گرفتن در مرزها جابه‌جا می‌شود و بزرگ‌نمایی می‌کند. اینکه این روش پویانمایی داشته باشد یا نه به یک اکتشاف داخلی بستگی دارد.
`getBounds`	`getBounds()` پارامترها: هیچ مقدار برگشتی: `LatLngBounds\|undefined` مرزهای طول/عرض جغرافیایی نمای فعلی. محدوده عرض/طول جغرافیایی نمای فعلی را برمی‌گرداند. اگر بیش از یک نسخه از جهان قابل مشاهده باشد، محدوده مرزها در طول جغرافیایی از ۱۸۰- تا ۱۸۰ درجه شامل می‌شود. اگر نقشه هنوز مقداردهی اولیه نشده باشد یا مرکز و بزرگ‌نمایی تنظیم نشده باشد، نتیجه `undefined` است. برای نقشه‌های بُرداری با شیب یا جهت غیرصفر، مرزهای طول/ عرض جغرافیایی برگردانده‌شده نشان‌دهنده کوچک‌ترین کادر مرزی است که منطقه قابل‌مشاهده نمای نقشه را دربرمی‌گیرد. برای دریافت منطقه دقیق رؤیت‌پذیر از نمای نقشه، `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» پیکربندی شود. اگر شناسه مجموعه داده با سبک نقشه مرتبط نباشد، یا اگر «سبک‌بندی داده‌محور» دردسترس نباشد (هیچ شناسه نقشه، کاشی برداری، لایه عارضه «سبک‌بندی داده‌محور»، یا «مجموعه داده» در «سبک نقشه» پیکربندی نشده باشد)، این امر خطایی را ثبت می‌کند و `FeatureLayer.isAvailable` حاصل نادرست خواهد بود.
`getDiv`	`getDiv()` پارامترها: هیچ مقدار برگشتی: `HTMLElement` mapDiv نقشه.
`getFeatureLayer`	`getFeatureLayer(featureType)` پارامترها: `featureType: FeatureType` مقدار برگشتی: `FeatureLayer` ‫`FeatureLayer` مربوط به `FeatureType` خاص را برمی‌گرداند. `FeatureLayer` باید در «کنسول Google Cloud» فعال شود. اگر `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` خواهد بود. این روش مقدار تنظیم‌شده توسط `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` حاشیه داخلی به پیکسل. مقدار عددی باعث ایجاد حاشیه داخلی یکسان در هر ۴ طرف می‌شود. مقدار پیش‌فرض ۰ است. مقدار برگشتی: هیچ نقشه را به‌اندازه حداقل مقدار لازم برای دربرگرفتن `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)` باعث می‌شود نقشه همیشه از نمای ازبالای ۰ درجه استفاده کند، صرف‌نظر از سطح بزرگ‌نمایی و ناحیه نمایش. `setTilt(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 optional` این رویداد زمانی فعال می‌شود که کاربر روی نقشه کلیک کند. یک MapMouseEvent با ویژگی‌های مربوط به مکان کلیک‌شده برگردانده می‌شود، مگراینکه روی نماد مکان کلیک شده باشد که دراین‌صورت یک IconMouseEvent با شناسه مکان برگردانده می‌شود. IconMouseEvent و MapMouseEvent یکسان هستند، با این تفاوت که IconMouseEvent فیلد شناسه مکان را دارد. وقتی شناسه مکان مهم نباشد، رویداد همیشه می‌تواند به‌عنوان MapMouseEvent درنظر گرفته شود. اگر روی نشانگر یا پنجره اطلاعات کلیک شود، رویداد کلیک اجرا نمی‌شود.
`contextmenu`	`function(event)` متغیرهای مستقل: `event: MapMouseEvent optional` این رویداد زمانی فعال می‌شود که رویداد DOM contextmenu در محفظه نقشه فعال شود.
`dblclick`	`function(event)` متغیرهای مستقل: `event: MapMouseEvent optional` این رویداد زمانی فعال می‌شود که کاربر روی نقشه دوکلیک کند. توجه داشته باشید که رویداد کلیک گاهی یک‌بار و گاهی دو بار، درست قبل‌از این رویداد، فعال می‌شود.
`drag`	`function()` متغیرهای مستقل: هیچ این رویداد به‌طور مکرر درحین کشیدن نقشه توسط کاربر فعال می‌شود.
`dragend`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که کاربر کشیدن نقشه را متوقف کند. توجه: وقتی کاربر بااستفاده از صفحه‌کلید حرکت عرضی نقشه را متوقف می‌کند، dragend فعال نمی‌شود. لطفاً به‌جای آن از رویداد `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 optional` این رویداد هر زمان که موشواره کاربر روی محفظه نقشه حرکت کند، فعال می‌شود.
`mouseout`	`function(event)` متغیرهای مستقل: `event: MapMouseEvent optional` این رویداد زمانی فعال می‌شود که موشواره کاربر از محفظه نقشه خارج شود.
`mouseover`	`function(event)` متغیرهای مستقل: `event: MapMouseEvent optional` این رویداد زمانی فعال می‌شود که موشواره کاربر وارد محفظه نقشه شود.
`projection_changed`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که تصویر تغییر کرده باشد.
`renderingtype_changed`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که renderingType تغییر کرده باشد.
`tilesloaded`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که بار کردن کاشی‌های نمایان به‌پایان رسیده باشد.
`tilt_changed`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که ویژگی شیب نقشه تغییر کند.
`zoom_changed`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که ویژگی بزرگ‌نمایی نقشه تغییر کند.
`rightclick`	منسوخ‌شده: برای پشتیبانی از الگوهای استفاده مانند کلیک با کلید کنترل در macOS، به‌جای آن از رویداد `Map.contextmenu` استفاده کنید. `function(event)` متغیرهای مستقل: `event: MapMouseEvent optional` این رویداد زمانی فعال می‌شود که کاربر روی نقشه کلیک راست کند.

میانای MapOptions

میانا google.maps.MapOptions

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

مشخصات
`backgroundColor` اختیاری	نوع: `string optional` رنگ مورداستفاده برای پس‌زمینه Map div. این رنگ زمانی‌که کاشی‌ها هنوز بار نشده‌اند و کاربر درحال حرکت دادن نقشه است قابل‌مشاهده خواهد بود. این گزینه را فقط زمانی می‌توان تنظیم کرد که نقشه مقداردهی اولیه شده باشد.
`cameraControl` اختیاری	نوع: `boolean optional` وضعیت فعال/غیرفعال بودن کنترل دوربین.
`cameraControlOptions` اختیاری	نوع: `CameraControlOptions optional` گزینه‌های نمایش برای کنترل «دوربین».
`center` اختیاری	نوع: `LatLng\|LatLngLiteral optional` مرکز اولیه نقشه.
`clickableIcons` اختیاری	نوع: `boolean optional` پیش‌فرض: `true` وقتی `false`، نمادهای نقشه قابل‌کلیک نیستند. نماد نقشه نشان‌دهنده نقطه موردعلاقه است که به آن POI نیز می‌گویند.
`colorScheme` اختیاری	نوع: `ColorScheme\|string optional` پیش‌فرض: `ColorScheme.LIGHT` آرایش رنگ‌های اولیه نقشه. این گزینه را فقط زمانی می‌توان تنظیم کرد که نقشه مقداردهی اولیه شده باشد.
`controlSize` اختیاری	نوع: `number optional` اندازه کنترل‌هایی که روی نقشه ظاهر می‌شوند، به پیکسل. این مقدار باید مستقیماً هنگام ایجاد نقشه ارائه شود، به‌روزرسانی این مقدار بعداً ممکن است کنترل‌ها را به حالت `undefined` برساند. فقط بر کنترل‌های ایجادشده توسط خود Maps API نظارت می‌کند. کنترل‌های سفارشی ایجادشده توسط توسعه‌دهنده را مقیاس‌بندی نمی‌کند.
`disableDefaultUI` اختیاری	نوع: `boolean optional` همه دکمه‌های واسط کاربر پیش‌فرض را فعال/غیرفعال می‌کند. ممکن است به‌طور جداگانه لغو شود. کنترل‌های صفحه‌کلید را غیرفعال نمی‌کند، این کنترل‌ها به‌طور جداگانه توسط گزینه `MapOptions.keyboardShortcuts` کنترل می‌شوند. کنترل‌های اشاره‌ای را غیرفعال نمی‌کند، این کنترل‌ها به‌طور جداگانه با گزینه `MapOptions.gestureHandling` کنترل می‌شوند.
`disableDoubleClickZoom` اختیاری	نوع: `boolean optional` بزرگ‌نمایی و مرکز را با دوکلیک فعال/غیرفعال می‌کند. به‌طور پیش‌فرض فعال است. توجه: این ویژگی توصیه نمی‌شود. برای غیرفعال کردن بزرگ‌نمایی با دوکلیک، می‌توانید از ویژگی `gestureHandling` استفاده کنید و آن را روی `"none"` تنظیم کنید.
`draggable` اختیاری	منسوخ‌شده: در سال ۲۰۱۷ منسوخ شده است. برای غیرفعال کردن کشیدن روی نقشه، می‌توانید از ویژگی `gestureHandling` استفاده کنید و آن را روی `"none"` تنظیم کنید. نوع: `boolean optional` اگر `false`، از کشیدن و بزرگ‌نمایی نقشه با موشواره و اشاره‌های لمسی جلوگیری می‌کند. کشیدن به‌طور پیش‌فرض فعال است.
`draggableCursor` اختیاری	نوع: `string optional` نام یا نشانی وب مکان‌نما برای نمایش هنگام حرکت دادن موشواره روی نقشه کشیدنی. این ویژگی از مشخصه css `cursor` برای تغییر نماد استفاده می‌کند. همانند ویژگی css، باید حداقل یک مکان‌نمای جایگزین که نشانی وب نباشد مشخص کنید. برای مثال: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`.
`draggingCursor` اختیاری	نوع: `string optional` نام یا نشانی وب مکان‌نما برای نمایش هنگام کشیدن نقشه. این ویژگی از مشخصه css `cursor` برای تغییر نماد استفاده می‌کند. همانند ویژگی css، باید حداقل یک مکان‌نمای جایگزین که نشانی وب نباشد مشخص کنید. برای مثال: `draggingCursor: 'url(http://www.example.com/icon.png), auto;'`.
`fullscreenControl` اختیاری	نوع: `boolean optional` وضعیت فعال/غیرفعال کنترل «تمام‌صفحه».
`fullscreenControlOptions` اختیاری	نوع: `FullscreenControlOptions optional` گزینه‌های نمایش برای کنترل «تمام‌صفحه».
`gestureHandling` اختیاری	نوع: `string optional` این تنظیم نحوه مدیریت اشاره‌ها در نقشه توسط میانای برنامه‌سازی کاربردی را کنترل می‌کند. مقادیر مجاز: `"cooperative"`: رویدادهای پیمایش و اشاره‌های لمسی تک‌انگشتی صفحه را پیمایش می‌کنند و نقشه را بزرگ‌نمایی یا جابه‌جا نمی‌کنند. اشاره‌های لمسی دو انگشتی نقشه را جابه‌جا و بزرگ‌نمایی می‌کند. رویدادهای پیمایش با کلید ctrl یا کلید ⌘ فشرده‌شده نقشه را بزرگ‌نمایی می‌کنند. در این حالت، نقشه با صفحه همکاری می‌کند. `"greedy"`: همه اشاره‌های لمسی و رویدادهای پیمایش نقشه را جابه‌جا یا بزرگ‌نمایی می‌کنند. ‫`"none"`: نقشه را نمی‌توان با اشاره‌های کاربر حرکت داد یا بزرگ‌نمایی کرد. `"auto"`: (پیش‌فرض) بسته به اینکه صفحه پیمایش‌پذیر باشد یا در iframe باشد، مدیریت اشاره‌ها مشارکتی یا حریصانه است.
`heading` اختیاری	نوع: `number optional` جهت تصویر هوایی برحسب درجه که در جهت ساعت‌گرد از جهت اصلی شمال اندازه‌گیری می‌شود. سرصفحه‌ها به نزدیک‌ترین زاویه دردسترس که تصویر برای آن موجود است می‌پرند.
`headingInteractionEnabled` اختیاری	نوع: `boolean optional` پیش‌فرض: `false` اینکه آیا نقشه باید به کاربر اجازه دهد جهت دوربین (چرخش) را کنترل کند یا نه. این گزینه فقط زمانی اعمال می‌شود که نقشه از نوع نقشه بُرداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابری برای شناسه نقشه استفاده خواهد شد (درصورت دردسترس بودن).
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` پیش‌فرض: `null` شناسه ارجاع استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه اسناد استفاده، می‌توانید این ویژگی را حذف کنید یا مقدار را با رشته‌ای خالی جایگزین کنید. فقط مقادیر یکتا ارسال خواهد شد. تغییرات در این مقدار پس‌از نمونه‌سازی ممکن است نادیده گرفته شود.
`isFractionalZoomEnabled` اختیاری	نوع: `boolean optional` پیش‌فرض: `true` برای نقشه‌های بُرداری و `false` برای نقشه‌های شطرنجی اینکه آیا نقشه باید سطوح بزرگ‌نمایی کسری را مجاز کند یا نه. به `isfractionalzoomenabled_changed` گوش دهید تا متوجه شوید چه زمانی پیش‌فرض تنظیم شده است.
`keyboardShortcuts` اختیاری	نوع: `boolean optional` اگر `false`، از کنترل نقشه توسط صفحه‌کلید جلوگیری می‌کند. میان‌برهای صفحه‌کلید به‌طور پیش‌فرض فعال است.
`mapId` اختیاری	نوع: `string optional` شناسه نقشه نقشه. این پارامتر را نمی‌توان پس‌از نمونه‌سازی نقشه تنظیم یا تغییر داد. از `Map.DEMO_MAP_ID` می‌توان برای امتحان کردن ویژگی‌هایی استفاده کرد که به شناسه نقشه نیاز دارند اما به فعال‌سازی ابری نیاز ندارند.
`mapTypeControl` اختیاری	نوع: `boolean optional` وضعیت فعال/غیرفعال اولیه کنترل نوع نقشه.
`mapTypeControlOptions` اختیاری	نوع: `MapTypeControlOptions optional` گزینه‌های نمایش اولیه برای کنترل نوع نقشه.
`mapTypeId` اختیاری	نوع: `MapTypeId\|string optional` mapTypeId اولیه نقشه. پیش‌فرض‌ها به `ROADMAP`.
`maxZoom` اختیاری	نوع: `number optional` حداکثر سطح بزرگ‌نمایی که در نقشه نمایش داده خواهد شد. اگر حذف شود یا روی `null` تنظیم شود، به‌جای آن از حداکثر بزرگ‌نمایی نوع نقشه فعلی استفاده می‌شود. مقادیر معتبر بزرگ‌نمایی اعدادی از صفر تا حداکثر سطح بزرگ‌نمایی پشتیبانی‌شده هستند.
`minZoom` اختیاری	نوع: `number optional` حداقل سطح بزرگ‌نمایی که در نقشه نمایش داده خواهد شد. اگر حذف شود یا روی `null` تنظیم شود، به‌جای آن از حداقل بزرگ‌نمایی نوع نقشه فعلی استفاده می‌شود. مقادیر معتبر بزرگ‌نمایی اعدادی از صفر تا حداکثر سطح بزرگ‌نمایی پشتیبانی‌شده هستند.
`noClear` اختیاری	نوع: `boolean optional` اگر `true`، محتوای Map div را پاک نکنید.
`panControl` اختیاری	منسوخ‌شده: کنترل «حرکت افقی» از سپتامبر ۲۰۱۵ منسوخ شده است. نوع: `boolean optional` وضعیت فعال/غیرفعال کنترل «حرکت افقی».
`panControlOptions` اختیاری	منسوخ‌شده: کنترل «حرکت افقی» از سپتامبر ۲۰۱۵ منسوخ شده است. نوع: `PanControlOptions optional` گزینه‌های نمایش برای کنترل «حرکت افقی».
`renderingType` اختیاری	نوع: `RenderingType optional` پیش‌فرض: `RenderingType.RASTER` اینکه نقشه باید شطرنجی باشد یا بُرداری. این پارامتر را نمی‌توان پس‌از نمونه‌سازی نقشه تنظیم یا تغییر داد. اگر تنظیم نشده باشد، پیکربندی ابری برای شناسه نقشه نوع پردازش را تعیین خواهد کرد (درصورت دردسترس بودن). لطفاً توجه داشته باشید که نقشه‌های بُرداری ممکن است برای همه دستگاه‌ها و مرورگرها دردسترس نباشد و درصورت نیاز، نقشه به نقشه شطرنجی برمی‌گردد.
`restriction` اختیاری	نوع: `MapRestriction optional` مرزی را تعریف می‌کند که منطقه نقشه قابل‌دسترس برای کاربران را محدود می‌کند. وقتی تنظیم شود، کاربر فقط می‌تواند حرکت و بزرگ‌نمایی کند درحالی‌که نمای دوربین در محدوده مرز باقی می‌ماند.
`rotateControl` اختیاری	نوع: `boolean optional` وضعیت فعال/غیرفعال کنترل «چرخش».
`rotateControlOptions` اختیاری	نوع: `RotateControlOptions optional` گزینه‌های نمایش برای کنترل «چرخش».
`scaleControl` اختیاری	نوع: `boolean optional` وضعیت اولیه فعال/غیرفعال کنترل «مقیاس».
`scaleControlOptions` اختیاری	نوع: `ScaleControlOptions optional` گزینه‌های نمایش اولیه برای کنترل «مقیاس».
`scrollwheel` اختیاری	نوع: `boolean optional` اگر `false`، بزرگ‌نمایی روی نقشه بااستفاده از چرخ پیمایش موشواره غیرفعال می‌شود. چرخ پیمایش به‌طور پیش‌فرض فعال است. توجه: این ویژگی توصیه نمی‌شود. برای غیرفعال کردن بزرگ‌نمایی بااستفاده از چرخ پیمایش، می‌توانید از ویژگی `gestureHandling` استفاده کنید و آن را روی `"cooperative"` یا `"none"` تنظیم کنید.
`streetView` اختیاری	نوع: `StreetViewPanorama optional` `StreetViewPanorama` برای نمایش وقتی آدمک «نمای خیابان» روی نقشه رها می‌شود. اگر تمام‌نمایی مشخص نشده باشد، وقتی آدمک رها می‌شود، `StreetViewPanorama` پیش‌فرضی در `div` نقشه نمایش داده می‌شود.
`streetViewControl` اختیاری	نوع: `boolean optional` وضعیت اولیه فعال/ غیرفعال کنترل آدمک «نمای خیابان». این کنترل بخشی از واسط کاربری پیش‌فرض است و باید روی `false` تنظیم شود، هنگام نمایش نوع نقشه‌ای که رونهاد جاده «نمای خیابان» نباید روی آن ظاهر شود (مثلاً نوع نقشه غیر Earth).
`streetViewControlOptions` اختیاری	نوع: `StreetViewControlOptions optional` گزینه‌های نمایش اولیه برای کنترل آدمک «نمای خیابان».
`styles` اختیاری	نوع: `Array<MapTypeStyle> optional` سبک‌هایی که باید بر هریک از انواع نقشه پیش‌فرض اعمال شود. توجه داشته باشید که برای حالت‌های `satellite`/`hybrid` و `terrain`، این سبک‌ها فقط برای برچسب‌ها و هندسه اعمال خواهند شد. این ویژگی هنگام استفاده از شناسه نقشه یا هنگام استفاده از نقشه‌های بُرداری دردسترس نیست (به‌جای آن از سبک‌پردازی نقشه بااستفاده از فضای ابری استفاده کنید).
`tilt` اختیاری	نوع: `number optional` برای نقشه‌های بُرداری، زاویه تابش نقشه را تنظیم می‌کند. مقادیر مجاز بسته به سطح بزرگ‌نمایی نقشه محدود است. برای نقشه‌های شطرنجی، رفتار تعویض خودکار را برای زاویه تابش نقشه کنترل می‌کند. تنها مقادیر مجاز `0` و `45` است. مقدار `0` باعث می‌شود نقشه همیشه از نمای سربالای ۰ درجه استفاده کند، صرف‌نظر از سطح بزرگ‌نمایی و نمای دید. مقدار `45` باعث می‌شود که زاویه کجی به‌طور خودکار به ۴۵ تغییر کند، هرگاه تصاویر ۴۵ درجه برای سطح بزرگ‌نمایی و نمای فعلی دردسترس باشد، و هرگاه تصاویر ۴۵ درجه دردسترس نباشد، به ۰ برگردد (این رفتار پیش‌فرض است). تصاویر ۴۵ درجه فقط برای انواع نقشه `satellite` و `hybrid`، در برخی مکان‌ها، و در برخی سطوح بزرگ‌نمایی دردسترس است. توجه: `getTilt` زاویه کجی فعلی را برمی‌گرداند، نه مقدار مشخص‌شده توسط این گزینه. چون `getTilt` و این گزینه به چیزهای متفاوتی اشاره دارند، خصوصیت `tilt` را `bind()` نکنید؛ انجام این کار ممکن است نتایج غیرقابل‌پیش‌بینی داشته باشد.
`tiltInteractionEnabled` اختیاری	نوع: `boolean optional` پیش‌فرض: `false` اینکه آیا نقشه باید به کاربر اجازه دهد شیب دوربین را کنترل کند یا نه. این گزینه فقط زمانی اعمال می‌شود که نقشه از نوع نقشه بُرداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابری برای شناسه نقشه استفاده خواهد شد (درصورت دردسترس بودن).
`zoom` اختیاری	نوع: `number optional` سطح بزرگ‌نمایی اولیه نقشه. مقادیر معتبر بزرگ‌نمایی اعدادی از صفر تا حداکثر سطح بزرگ‌نمایی پشتیبانی‌شده هستند. مقادیر بزرگ‌تر بزرگ‌نمایی با وضوح بالاتر مطابقت دارد.
`zoomControl` اختیاری	نوع: `boolean optional` وضعیت فعال/غیرفعال کنترل «بزرگ‌نمایی».
`zoomControlOptions` اختیاری	نوع: `ZoomControlOptions optional` گزینه‌های نمایش برای کنترل «بزرگ‌نمایی».

میانای MapTypeStyle

میانا google.maps.MapTypeStyle

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

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

میانای MapMouseEvent

میانای google.maps.MapMouseEvent
گسترش‌یافته توسط Data.MouseEvent, FeatureMouseEvent, IconMouseEvent, PolyMouseEvent

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

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

مشخصات

domEvent

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

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

latLng
اختیاری

نوع: LatLng optional

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

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

میانای IconMouseEvent

interface google.maps.IconMouseEvent extends MapMouseEvent

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

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

مشخصات

placeId
اختیاری

نوع: string optional

شناسه مکان مکانی که روی آن کلیک شده است. از این شناسه مکان می‌توان برای جستجوی اطلاعات بیشتر درباره ویژگی‌ای که روی آن کلیک شده است استفاده کرد.

درباره شناسه‌های جا در راهنمای توسعه‌دهنده Places API بیشتر بدانید.

به‌ارث‌رسیده: domEvent، latLng

روش‌ها
از سازمان بالاتر: `stop`

ثابت‌های ColorScheme

ثابت‌ها google.maps.ColorScheme کتابخانه
"core"

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

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع ColorSchemeString تعریف می‌شوند.

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

ثابت‌ها
`DARK`	آرایش رنگ تیره برای نقشه.
`FOLLOW_SYSTEM`	آرایش رنگ‌ها براساس اولویت‌های سیستم انتخاب می‌شود که یک‌بار در زمان اجرای روش بررسی می‌شود.
`LIGHT`	آرایش رنگ‌های روشن برای نقشه. مقدار پیش‌فرض برای Maps JS قدیمی.

ثابت‌های MapTypeId

ثابت‌ها google.maps.MapTypeId کتابخانه
"maps"

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

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع MapTypeIdString تعریف می‌شوند.

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

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

کلاس MapTypeRegistry

class google.maps.MapTypeRegistry extends MVCObject
library "maps"

ثبت برای نمونه‌های MapType، کلیدشده با شناسه MapType.

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

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

سازنده

MapTypeRegistry

MapTypeRegistry()

پارامترها: هیچ

MapTypeRegistry مجموعه انواع نقشه سفارشی را که برای استفاده در نقشه دردسترس است نگهداری می‌کند. برای مثال، میانای برنامه‌سازی کاربردی هنگام ارائه فهرست انواع نقشه دردسترس در کنترل‌ها، به این دفتر ثبت مراجعه می‌کند.

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

میانای MapRestriction

میانا google.maps.MapRestriction

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

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

مشخصات

latLngBounds

نوع: LatLngBounds|LatLngBoundsLiteral

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

strictBounds
اختیاری

نوع: boolean optional

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

کلاس TrafficLayer

class google.maps.TrafficLayer extends MVCObject
library "maps"

لایه ترافیک.

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

سازنده
`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`

میانای TrafficLayerOptions

میانا google.maps.TrafficLayerOptions

شیء TrafficLayerOptions برای تعریف ویژگی‌هایی که می‌توان در TrafficLayer تنظیم کرد استفاده می‌شود.

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

کلاس TransitLayer

class google.maps.TransitLayer extends MVCObject
library "maps"

لایه حمل‌ونقل عمومی.

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

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

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

کلاس BicyclingLayer

class google.maps.BicyclingLayer extends MVCObject
library "maps"

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

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

سازنده
`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
گسترش‌یافته توسط CameraParams

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

مشخصات
`center` اختیاری	نوع: `LatLngLiteral\|LatLng optional`
`heading` اختیاری	نوع: `number optional`
`tilt` اختیاری	نوع: `number optional`
`zoom` اختیاری	نوع: `number optional`

میانای VisibleRegion

میانا google.maps.VisibleRegion

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

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

ثابت‌های RenderingType

ثابت‌ها google.maps.RenderingType کتابخانه
"maps"

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع RenderingTypeString تعریف می‌شوند.

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

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

میانای MapCapabilities

میانا google.maps.MapCapabilities

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

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

Maps با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

کلاس MapElement

سازنده

مشخصات

ماشین سکه‌ای

روش‌ها

رویدادها

میانای MapElementOptions

مشخصات

کلاس ZoomChangeEvent

کلاس نقشه

سازنده

ثابت‌ها

مشخصات

روش‌ها

رویدادها

میانای MapOptions

مشخصات

میانای MapTypeStyle

مشخصات

میانای MapMouseEvent

مشخصات

روش‌ها

میانای IconMouseEvent

مشخصات

روش‌ها

ثابت‌های ColorScheme

ثابت‌ها

ثابت‌های MapTypeId

ثابت‌ها

کلاس MapTypeRegistry

سازنده

روش‌ها

میانای MapRestriction

مشخصات

کلاس TrafficLayer

سازنده

روش‌ها

میانای TrafficLayerOptions

مشخصات

کلاس TransitLayer

سازنده

روش‌ها

کلاس BicyclingLayer

سازنده

روش‌ها

میانای CameraOptions

مشخصات

میانای VisibleRegion

مشخصات

ثابت‌های RenderingType

ثابت‌ها

میانای MapCapabilities

مشخصات

Maps