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

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

Event system

کلاس رویداد

google.maps . event کلاس google.maps . event

فضای نام برای همه توابع رویداد عمومی

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

روش های استاتیک
`addListener`	`addListener(instance, eventName, handler)` مولفه های: `instance` : `Object` `eventName` : `string` `handler` : `Function` مقدار بازگشتی: `MapsEventListener` تابع شنونده داده شده را به نام رویداد داده شده برای نمونه شی داده شده اضافه می کند. یک شناسه برای این شنونده برمی‌گرداند که می‌تواند با removeListener() استفاده شود.
`addListenerOnce`	`addListenerOnce(instance, eventName, handler)` مولفه های: `instance` : `Object` `eventName` : `string` `handler` : `Function` مقدار بازگشتی: `MapsEventListener` مانند addListener، اما کنترل کننده پس از مدیریت اولین رویداد، خود را حذف می کند.
`clearInstanceListeners`	`clearInstanceListeners(instance)` مولفه های: `instance` : `Object` مقدار برگشتی: `void` همه شنوندگان را برای همه رویدادها برای نمونه داده شده حذف می کند.
`clearListeners`	`clearListeners(instance, eventName)` مولفه های: `instance` : `Object` `eventName` : `string` مقدار برگشتی: `void` تمام شنوندگان رویداد داده شده را برای نمونه داده شده حذف می کند.
`hasListeners`	`hasListeners(instance, eventName)` مولفه های: `instance` : `Object` `eventName` : `string` مقدار بازگشتی: `boolean` در صورت وجود شنوندگان برای رویداد داده شده در نمونه داده شده، برمی گردد. می توان از آن برای صرفه جویی در محاسبه جزئیات رویداد گران قیمت استفاده کرد.
`removeListener`	`removeListener(listener)` مولفه های: `listener` : `MapsEventListener` مقدار برگشتی: `void` شنونده داده شده را حذف می کند، که باید توسط addListener در بالا بازگردانده می شد. معادل فراخوانی `listener.remove()` است.
`trigger`	`trigger(instance, eventName, eventArgs)` مولفه های: `instance` : `Object` `eventName` : `string` `eventArgs` : `...?` مقدار برگشتی: `void` رویداد داده شده را تحریک می کند. همه آرگومان های بعد از eventName به عنوان آرگومان به شنوندگان ارسال می شوند.
`addDomListener`	منسوخ شده: `google.maps.event.addDomListener()` منسوخ شده است، به جای آن از متد استاندارد addEventListener() استفاده کنید. این ویژگی به کار خود ادامه خواهد داد و هیچ برنامه ای برای از کار انداختن آن وجود ندارد. `addDomListener(instance, eventName, handler[, capture])` مولفه های: `instance` : `Object` `eventName` : `string` `handler` : `Function` `capture` : `boolean optional` مقدار بازگشتی: `MapsEventListener` ثبت نام کنترل کننده رویداد متقابل مرورگر. این شنونده با فراخوانی removeListener(handle) برای دسته ای که توسط این تابع برگردانده می شود حذف می شود.
`addDomListenerOnce`	منسوخ شده: `google.maps.event.addDomListenerOnce()` منسوخ شده است، به جای آن از متد استاندارد addEventListener() استفاده کنید. این ویژگی به کار خود ادامه خواهد داد و هیچ برنامه ای برای از کار انداختن آن وجود ندارد. `addDomListenerOnce(instance, eventName, handler[, capture])` مولفه های: `instance` : `Object` `eventName` : `string` `handler` : `Function` `capture` : `boolean optional` مقدار بازگشتی: `MapsEventListener` بسته بندی در اطراف addDomListener که شنونده را پس از اولین رویداد حذف می کند.

رابط MapsEventListener

google.maps . MapsEventListener رابط google.maps . MapsEventListener

شنونده رویداد، ایجاد شده توسط google.maps.event.addListener () و دوستان.

مواد و روش ها
`remove`	`remove()` پارامترها: ندارد مقدار برگشتی: `void` شنونده را حذف می کند. فراخوانی `listener.remove()` معادل `google.maps.event.removeListener(listener)` است.

کلاس MVCObject

google.maps . MVCObject کلاس google.maps . MVCObject

کلاس پایه پیاده سازی KVO.

سازنده MVCObject تضمین شده است که یک تابع خالی MVCObject ، بنابراین شما می توانید با نوشتن MySubclass.prototype = new google.maps.MVCObject(); . مگر اینکه غیر از این ذکر شود، این در مورد سایر کلاس‌های API صادق نیست و ارث بردن از کلاس‌های دیگر در API پشتیبانی نمی‌شود.

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

سازنده
`MVCObject`	`MVCObject()` پارامترها: ندارد یک `MVCObject` ایجاد می کند.

مواد و روش ها
`addListener`	`addListener(eventName, handler)` مولفه های: `eventName` : `string` `handler` : `Function` مقدار بازگشتی: `MapsEventListener` تابع شنونده داده شده را به نام رویداد داده شده اضافه می کند. یک شناسه برای این شنونده برمی‌گرداند که می‌تواند با `google.maps.event.removeListener` استفاده شود.
`bindTo`	`bindTo(key, target[, targetKey, noNotify])` مولفه های: `key` : `string` `target` : `MVCObject` `targetKey` : `string optional` `noNotify` : `boolean optional` ارزش بازگشتی: ندارد یک نما را به یک مدل متصل می کند.
`get`	`get(key)` مولفه های: `key` : `string` ارزش بازگشتی: `?` ارزش می گیرد.
`notify`	`notify(key)` مولفه های: `key` : `string` ارزش بازگشتی: ندارد همه ناظران را از تغییر در این ویژگی مطلع کنید. این هم به اشیایی که به خاصیت شی محدود شده اند و هم به شیئی که به آن مقید است اطلاع می دهد.
`set`	`set(key, value)` مولفه های: `key` : `string` `value` : `` ارزش بازگشتی:* ندارد مقداری را تعیین می کند.
`setValues`	`setValues([values])` مولفه های: `values` : `Object optional` ارزش بازگشتی: ندارد مجموعه ای از جفت های کلید-مقدار را تنظیم می کند.
`unbind`	`unbind(key)` مولفه های: `key` : `string` ارزش بازگشتی: ندارد یک اتصال را حذف می کند. Unbinding ویژگی unbound را به مقدار فعلی تنظیم می کند. چون مقدار تغییر نکرده است به شی اطلاع داده نمی شود.
`unbindAll`	`unbindAll()` پارامترها: ندارد ارزش بازگشتی: ندارد تمام اتصالات را حذف می کند.

کلاس MVCAray

google.maps . MVCArray<T> کلاس google.maps . MVCArray<T>

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

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

سازنده
`MVCArray`	`MVCArray([array])` مولفه های: `array` : `Array <T> optional` یک آرایه MVC قابل تغییر.

مواد و روش ها
`clear`	`clear()` پارامترها: ندارد ارزش بازگشتی: ندارد تمام عناصر را از آرایه حذف می کند.
`forEach`	`forEach(callback)` مولفه های: `callback` : `function(T, number): void` ارزش بازگشتی: ندارد روی هر عنصر تکرار کنید، تماس ارائه شده را فراخوانی کنید. فراخوانی برای هر عنصری مانند: callback (عنصر، شاخص) فراخوانی می شود.
`getArray`	`getArray()` پارامترها: ندارد مقدار بازگشتی: `Array <T>` ارجاع به آرایه زیرین را برمی گرداند. هشدار: اگر آرایه جهش یافته باشد، هیچ رویدادی توسط این شی شلیک نمی شود.
`getAt`	`getAt(i)` مولفه های: `i` : `number` ارزش بازگشتی: `T` عنصر را در شاخص مشخص شده برمی گرداند.
`getLength`	`getLength()` پارامترها: ندارد مقدار برگشتی: `number` تعداد عناصر این آرایه را برمی گرداند.
`insertAt`	`insertAt(i, elem)` مولفه های: `i` : `number` `elem` : `T` ارزش بازگشتی: ندارد یک عنصر را در شاخص مشخص شده درج می کند.
`pop`	`pop()` پارامترها: ندارد ارزش بازگشتی: `T` آخرین عنصر آرایه را حذف می کند و آن عنصر را برمی گرداند.
`push`	`push(elem)` مولفه های: `elem` : `T` مقدار برگشتی: `number` یک عنصر را به انتهای آرایه اضافه می کند و طول جدید آرایه را برمی گرداند.
`removeAt`	`removeAt(i)` مولفه های: `i` : `number` ارزش بازگشتی: `T` یک عنصر را از شاخص مشخص شده حذف می کند.
`setAt`	`setAt(i, elem)` مولفه های: `i` : `number` `elem` : `T` ارزش بازگشتی: ندارد یک عنصر را در شاخص مشخص شده تنظیم می کند.
به ارث رسیده: `addListener` ، `bindTo` ، `get` ، `notify` ، `set` ، `setValues` ، `unbind` ، `unbindAll`

مناسبت ها
`insert_at`	`function(index)` استدلال ها: `number` `index` این رویداد زمانی که `insertAt()` فراخوانی می شود فعال می شود. رویداد ایندکسی را که به `insertAt()` ارسال شده است، ارسال می کند.
`remove_at`	`function(index, removed)` استدلال ها: `number` `index` `removed` : `T` عنصر حذف شده از آرایه در `index` . این رویداد زمانی فعال می شود که `removeAt()` فراخوانی شود. رویداد، شاخصی را که به `removeAt()` و عنصری که از آرایه حذف شده است، ارسال می کند.
`set_at`	`function(index, previous)` استدلال ها: `number` `index` `previous` : `T` عنصری که قبلاً در آرایه در `index` قرار داشت. این رویداد زمانی فعال می شود که `setAt()` فراخوانی شود. رویداد، شاخصی را که به `setAt()` و عنصری که قبلاً در آرایه آن ایندکس بود، ارسال می‌کند.

رابط ErrorEvent

google.maps . ErrorEvent رابط google.maps . ErrorEvent

رویدادی با خطای مرتبط.

خواص
`error`	نوع: `Error` خطای مربوط به رویداد

Event system

کلاس رویداد

روش های استاتیک

رابط MapsEventListener

مواد و روش ها

کلاس MVCObject

سازنده

مواد و روش ها

کلاس MVCAray

سازنده

مواد و روش ها

مناسبت ها

رابط ErrorEvent

خواص